# 在 Codex 中使用 AoxToken

注册、创建 API Key 与客户端配置。选择你的操作系统，跟着步骤完成接入。

**注册账户 → 创建 API Key → 找到配置文件 → 复制粘贴 → 填入 Key → 开始使用。**

本文面向 Codex CLI 和 Codex 桌面端，尚待 Windows、macOS 实测。ChatGPT Desktop 的兼容性由 #38 单独核实，不能据此套用配置。

> 待验证：示例模型 `gpt-5.4` 尚未通过 AoxToken 测试账户确认。发布前必须验证模型、分组与配置，不能仅根据其他服务商教程判断。

## 一、注册 AoxToken 账户

1. 打开 [AoxToken 注册页面](/register)，按页面提示完成账户注册。
2. 已有账户的用户直接[登录](/login)。
3. 登录后进入[控制台](/dashboard)，确认账户有可用额度；如需购买，按页面提示操作。

AoxToken 使用自己的 API Key 和账户额度，不扣除你的 ChatGPT 订阅额度。

## 二、创建 API Key

1. 登录后，打开 [API Key 管理页面](/keys)。
2. 点击创建 API Key，填写便于识别的名称，例如 `我的 Codex`。
3. 如果页面要求选择分组，请选择支持 **GPT-5.4 和 Responses API** 的分组。
4. 创建后复制 API Key，下一步需要将它粘贴到配置文件中。

> API Key 是访问账户额度的凭证，请勿分享给他人。

## 三、Windows 配置

请先安装并启动一次 Codex。下方已填写服务地址和模型，**只需替换 API Key**。

### 1. 找到配置文件

按下 **Win + R**，复制粘贴下面的路径，按回车：

```text
%USERPROFILE%\.codex
```

找到 `config.toml`，右键选择 **打开方式 → 记事本**。

如果没有这个文件，新建文本文件并命名为 `config.toml`。在文件资源管理器中开启“文件扩展名”，确保文件名不是 `config.toml.txt`。

### 2. 复制粘贴配置

如果文件已有内容，先复制一份，命名为 `config.toml.backup` 留作备份。

以下为首次接入的完整配置。没有需要保留的自定义设置时，可全选原内容并替换；已有 MCP 等设置的用户请合并配置，不要重复添加同名字段。

```toml
model = "gpt-5.4"
model_provider = "aoxtoken"
forced_login_method = "api"

[model_providers.aoxtoken]
name = "AoxToken"
base_url = "https://api.aoxtoken.com/v1"
wire_api = "responses"
experimental_bearer_token = "在这里粘贴你的API Key"
supports_websockets = false
```

### 3. 填入 Key，保存并重启

将 `在这里粘贴你的API Key` 替换为刚刚创建的 AoxToken API Key，**保留两边的英文双引号**，不要额外添加 `Bearer `。

按 **Ctrl + S** 保存，完全退出客户端后重新打开，新建任务即可开始测试。

## 四、macOS 配置

请先安装并启动一次 Codex。下方已填写服务地址和模型，**只需替换 API Key**。

### 1. 找到配置文件

打开 **访达 Finder**，按下 **Command + Shift + G**，复制粘贴：

```text
~/.codex
```

按回车，找到 `config.toml`，右键选择 **打开方式 → 文本编辑**。

如果文件夹不存在，请先启动一次 Codex，再重试。如果文件夹中没有 `config.toml`，打开“终端”，复制粘贴下面一行并按回车：

```bash
touch ~/.codex/config.toml && open -a TextEdit ~/.codex/config.toml
```

### 2. 复制粘贴配置

如果文件已有内容，先复制一份，命名为 `config.toml.backup` 留作备份。

在“文本编辑”的 **编辑 → 替换** 菜单中，关闭“智能引号”。

以下为首次接入的完整配置。没有需要保留的自定义设置时，可全选原内容并替换；已有 MCP 等设置的用户请合并配置，不要重复添加同名字段。

```toml
model = "gpt-5.4"
model_provider = "aoxtoken"
forced_login_method = "api"

[model_providers.aoxtoken]
name = "AoxToken"
base_url = "https://api.aoxtoken.com/v1"
wire_api = "responses"
experimental_bearer_token = "在这里粘贴你的API Key"
supports_websockets = false
```

### 3. 填入 Key，保存并重启

将 `在这里粘贴你的API Key` 替换为刚刚创建的 AoxToken API Key，**保留两边的英文双引号**，不要额外添加 `Bearer `。

按 **Command + S** 保存。回到客户端，按 **Command + Q** 完全退出，再重新打开并新建任务。

## 五、确认配置成功

在新任务中发送：

> 你好，请简单介绍一下自己。

收到回复后，打开 [AoxToken 控制台](/dashboard)，确认出现对应时间的请求或用量记录。

客户端可能显示 **GPT-5.4** 或 **Custom**，具体取决于版本。**以实际请求成功和 AoxToken 使用记录为准**，不要仅凭模型名称判断。

如果使用 Codex CLI，保存配置后重新运行：

```bash
codex
```

ChatGPT Desktop 不在本篇验证范围内，请等待独立兼容性文档。

## 六、常见问题

| 遇到的问题 | 检查方法 |
| --- | --- |
| 提示 API Key 无效或 `401` | 确认密钥复制完整，没有多余空格，也没有添加 `Bearer ` |
| 提示无权限或 `403` | 检查 API Key 所属分组是否允许使用 GPT-5.4 |
| 提示模型不存在 | 确认当前密钥可以使用 `gpt-5.4`，否则联系 AoxToken 获取可用模型 ID |
| 提示 `404` | 地址应为 `https://api.aoxtoken.com/v1`，不要再添加 `/responses` |
| 提示 `429` | 检查账户额度、请求频率及并发限制 |
| 提示配置格式错误 | 检查英文双引号、重复字段和文件内容 |
| 保存后没有生效 | 确认文件名不是 `config.toml.txt`，并完全退出、重启客户端 |

合并已有配置时，`model`、`model_provider` 和 `forced_login_method` 应放在文件顶部、第一个 `[分组]` 之前。

本教程已设置 HTTPS 流式传输，无需另外配置 WebSocket。如果你之前设置过 `CODEX_HOME`，请编辑该目录中的 `config.toml`，而非默认路径。

## 七、恢复原配置

完全退出客户端，将备份的 `config.toml.backup` 恢复为 `config.toml`，然后重新启动。

请勿将包含 API Key 的配置文件上传到代码仓库或发送给他人。如果密钥泄露，请在 AoxToken 控制台撤销旧密钥并创建新密钥。