> ## Documentation Index
> Fetch the complete documentation index at: https://apione.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Codex CLI 与桌面端接入 APIONE

> 通过自定义 Responses Provider 配置 APIONE。

Codex 使用 Responses 协议。APIONE 提供 `/v1/responses`，但仍需选择支持该协议和编码工具调用的模型。

## 配置密钥

安装 Codex CLI 后，在启动它的终端设置：

```bash theme={null}
export APIONE_API_KEY="YOUR_APIONE_KEY"
```

PowerShell 使用 `$env:APIONE_API_KEY="YOUR_APIONE_KEY"`。不要把真实密钥写入项目仓库。

## 手动配置自定义供应商

编辑用户级 `~/.codex/config.toml`。将前两项放在第一个 TOML 表头之前，并把供应商字段合并到现有的 `[model_providers.apione]` 表。每个键和表只定义一次。模型 ID 请从当前密钥可用的模型中选择。

```toml theme={null}
model_provider = "apione"
model = "YOUR_APIONE_MODEL_ID"

[model_providers.apione]
name = "APIONE"
base_url = "https://api.apione.ai/v1"
env_key = "APIONE_API_KEY"
wire_api = "responses"
```

`env_key` 指向存放 APIONE 密钥的环境变量。手动配置使用这一种认证方式。若原来的供应商块来自一键接入，切换前先备份，再从该供应商块移除旧的 `experimental_bearer_token` 和 `requires_openai_auth`。Base URL 填到 `/v1`。配置字段依据 [OpenAI 官方配置参考](https://developers.openai.com/codex/config-reference/)。

## APIONE 桌面端一键接入

在 APIONE 桌面端选择接入工具、价格分组和模型，再核对「确认改动」中的配置文件与 Responses 地址。一键接入和上面的手动配置是两条独立路径。客户端生成的本机模型目录请随对应配置一起保留。

![APIONE 桌面端预览 Codex Responses 配置改动](https://mintcdn.com/apione/eGTb2vS-514SNt6Q/images/integrations/screenshots/codex-desktop-preview.png?fit=max\&auto=format\&n=eGTb2vS-514SNt6Q\&q=85\&s=b8ba2cab77ce6479e6221a6a91534548)

APIONE 桌面端的一键接入改动预览。模型和配置文件路径随设备及选择变化。

## 启动与验证

在同一终端进入测试项目，运行 `codex`，先要求解释目录结构。确认 APIONE 控制台出现请求，再测试工具调用。普通文本成功并不保证远程压缩、联网搜索等扩展能力可用。

桌面端应使用同一用户的配置，并在修改后完全退出再启动。**桌面图标启动的进程不一定继承 Shell 变量**；若报告找不到 `APIONE_API_KEY`，按当前桌面端支持的凭据或启动环境方式配置，不能仅凭终端已有变量判断成功。

## 排查重点

* 401：检查实际运行进程是否读取到有效密钥。
* 404 或模型错误：核对模型 ID 与 Responses 权限。
* 400：检查工具、推理和其他参数是否受当前模型支持。
* 仍连接旧服务：检查项目级配置或启动参数是否覆盖用户配置。

APIONE API 费用与 ChatGPT/Codex 订阅分开计算；使用 APIONE 密钥不代表获得官方订阅权益。

***

[返回集成目录](https://apione.ai/docs/guides/clients.md) · [模型选择](https://apione.ai/docs/models/catalog.md) · [错误排查](https://apione.ai/docs/support/errors.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.