Codex 接入：Windows 与 macOS

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

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

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

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

一、注册 AoxToken 账户

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

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

二、创建 API Key

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

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

三、Windows 配置

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

1. 找到配置文件

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

%USERPROFILE%\.codex

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

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

2. 复制粘贴配置

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

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

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，复制粘贴：

~/.codex

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

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

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

2. 复制粘贴配置

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

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

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

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 控制台，确认出现对应时间的请求或用量记录。

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

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

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 控制台撤销旧密钥并创建新密钥。