Codex 客户端下载和第三方 API 配置教程

一、下载并安装 Codex 客户端

进入本站首页下载对应系统版本，完成安装后至少打开一次 Codex，确保程序已经初始化 .codex 配置目录。

https://codexinstall.asia/

二、获取 API Key

注册并登录 API 平台，在 API Key 管理页面点击“创建 API 密钥”。根据平台实时显示选择合适的分组，保存后点击 Key 旁边的“复制”，将 Key 放在安全的密码管理工具中。

https://codex.chatgpt-plus.top/login?mode=register
https://codex.chatgpt-plus.top/keys

三、找到 Codex 配置目录

Windows 使用 Win + R 打开 %userprofile%\.codex；macOS 可以在终端使用 ~/.codex。

Windows: %userprofile%\.codex
macOS: ~/.codex

四、修改 auth.json

auth.json 只保留一个认证字段。不要把模型名、provider 或其它配置混在这个文件里，也不要把含有真实 Key 的文件上传到项目或截图。

{
  "OPENAI_API_KEY": "替换成你自己的 API Key"
}

API Key 是私密凭据，请使用环境变量或本机凭据存储，并避免提交到 Git。

五、修改 config.toml

打开 config.toml，配置模型提供商、模型名称、推理强度和兼容接口地址。下面示例只展示字段结构；第三方服务的 base_url、模型 ID 和协议必须以供应商当前页面为准，不要盲抄。

model_provider = "mycodex"
model = "gpt-5.6"
model_reasoning_effort = "medium"

[model_providers.mycodex]
name = "mycodex"
base_url = "https://供应商当前提供的地址/v1"
wire_api = "responses"

六、配置参数说明

• model_provider 与 [model_providers.mycodex] 的名称必须一致。
• model 决定当前使用的模型，例如供应商明确支持的 gpt-5.6。
• model_reasoning_effort 可选择供应商和客户端支持的 low、medium、high 或 max。
• API Key 应通过本机 auth.json、环境变量或凭据存储提供，不要把真实 Key 写入共享配置。
• base_url 是兼容接口地址，wire_api = "responses" 使用 Responses API 协议。

七、最终配置示例

auth.json
{ "OPENAI_API_KEY": "替换成你自己的 Key" }

config.toml
model_provider = "mycodex"
model = "gpt-5.6"
model_reasoning_effort = "medium"

八、重启 Codex

保存 auth.json 和 config.toml，关闭 Codex 后重新打开，确认可以正常调用供应商列出的模型。

九、常见问题

• API Key 无效：检查字段名、引号、逗号和 Key 是否完整。
• 连接失败：检查 base_url 是否为平台当前提供的地址。
• 修改后不生效：完全退出 Codex 后重新启动，部分版本不会实时读取配置。