codexAPP的key注入使用的方法步骤

本文档用于说明如何把 ApexAPI 网页端提供的 Codex CLI 配置同步到本机 Codex App / Codex CLI，让 App 注入和网页端配置保持一致。

重点：需要修改 Codex 配置目录下的两个文件：config.toml 和 auth.json。

配置截图

上图对应 ApexAPI 网页端的 Codex CLI 配置页。Markdown 中已引用图片文件 apexapi-codex-cli-config.png，建议和本文档放在同一目录。

文件路径

macOS / Linux：

~/.codex/config.toml
~/.codex/auth.json

Windows：

%USERPROFILE%\.codex\config.toml
%USERPROFILE%\.codex\auth.json

其中 %USERPROFILE% 会自动指向当前登录用户的用户目录。

例如本文档所在电脑的 Windows 用户名是 hh，所以当前这台机器对应路径是：

C:\Users\hh\.codex\config.toml
C:\Users\hh\.codex\auth.json

如果你的 Windows 用户名不是 hh，不要照抄 C:\Users\hh，需要改成自己本机的用户名。例如用户名是 zhangsan，路径就是：

C:\Users\zhangsan\.codex\config.toml
C:\Users\zhangsan\.codex\auth.json

第一步：修改 config.toml

打开：

C:\Users\hh\.codex\config.toml

把下面这段配置放到 config.toml 文件开头，保持和 ApexAPI 网页端一致：

model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000
[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://apexapi.roixw.com"
wire_api = "responses"
requires_openai_auth = true

关键要求

model_provider 必须和下面的 provider 表名一致：

model_provider = "OpenAI"
[model_providers.OpenAI]
name = "OpenAI"

不要写成下面这种前后不一致的形式：

model_provider = "OpenAI"
[model_providers.apexapi]
name = "apexapi"

也不要写成：

model_provider = "apexapi"
[model_providers.OpenAI]
name = "OpenAI"

如果 provider 名称不一致，Codex App 可能找不到正确的 provider，表现出来就像模型、接口或 key 对不上。

第二步：修改 auth.json

打开：

C:\Users\hh\.codex\auth.json

写入下面格式：

{
  "OPENAI_API_KEY": "sk-替换成你的ApexAPI-Key"
}

注意事项：

• OPENAI_API_KEY 这个字段名不要改。
• key 只填写 ApexAPI 后台提供的 sk-...，不要加 Bearer 前缀。
• JSON 里只能使用英文双引号。
• JSON 最后一项后面不要加逗号。
• 不要把真实 key 发给别人，也不要提交到 Git 仓库。

为什么 ApexAPI 也使用 OPENAI_API_KEY

虽然实际请求地址是 ApexAPI：

base_url = "https://apexapi.域名.com"

但配置中有：

requires_openai_auth = true

这表示 Codex 会按 OpenAI 兼容方式读取认证信息，也就是从 auth.json 里的 OPENAI_API_KEY 取 key，然后请求 ApexAPI 的兼容接口。

所以这里不是填写 APEXAPI_KEY，也不是填写 API_KEY，而是固定使用：

"OPENAI_API_KEY": "sk-..."

App 注入时的检查顺序

配置完成后，建议按下面顺序检查：

1. 确认 config.toml 开头存在 ApexAPI 网页端给出的配置。
2. 确认 model_provider 和 [model_providers.OpenAI] 名称完全一致。
3. 确认 base_url 是 https://apexapi.roixw.com。
4. 确认 wire_api 是 responses。
5. 确认 auth.json 中只有正确的 OPENAI_API_KEY。
6. 重启 Codex App，让 App 重新读取配置文件。

常见问题

1. 为什么提示 key 对不上

常见原因如下：

• auth.json 里的 key 不是 ApexAPI 后台生成的 key。
• key 前面多写了 Bearer 。
• auth.json 不是合法 JSON，例如用了中文引号或多了尾逗号。
• config.toml 里的 model_provider 和 [model_providers.xxx] 名称不一致。
• 本机有多个 Codex 配置目录，App 读取的不是你刚修改的那个目录。
• ApexAPI 网页端配置已经更新，但本机文件还是旧配置。
• ApexAPI 后台 key 已失效、余额不足、权限不足或模型未开通。

2. 为什么用 OpenAI 这个名字

ApexAPI 提供的是 OpenAI 兼容接口。网页端示例使用：

model_provider = "OpenAI"
[model_providers.OpenAI]
name = "OpenAI"

为了和网页端保持一致，建议本机也直接使用 OpenAI 这个 provider 名。这样 App 注入、CLI 配置和网页端示例最不容易出现差异。

3. 能不能把 provider 名改成 apexapi

可以，但必须全局一致。例如：

model_provider = "apexapi"
[model_providers.apexapi]
name = "apexapi"
base_url = "https://apexapi.roixw.com"
wire_api = "responses"
requires_openai_auth = true

不过如果目标是“跟网页端保持一致”，建议不要改名，直接使用网页端给出的 OpenAI。

4. 503 Service Unavailable 是不是 key 错

不一定。

503 Service Unavailable 通常表示 ApexAPI 服务端、上游模型接口或中转服务临时不可用。key 错误更常见的是 401 Unauthorized、403 Forbidden 或带有认证失败信息的错误。

如果配置确认无误但仍然出现 503，可以等待几分钟后重试，或者把报错里的 request id、cf-ray 发给 ApexAPI 服务方排查。

最终推荐配置

config.toml 推荐保持：

model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000
[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://apexapi.roixw.com"
wire_api = "responses"
requires_openai_auth = true

auth.json 推荐保持：

{
  "OPENAI_API_KEY": "sk-替换成你的ApexAPI-Key"
}

修改完成后重启 Codex App，再重新发起一次请求验证。

到此这篇关于codexAPP的key注入使用的方法步骤的文章就介绍到这了,更多相关codexAPP的key注入使用内容请搜索脚本之家以前的文章或继续浏览下面的相关文章，希望大家以后多多支持脚本之家！

最新评论