Source: https://aiprimetech.io/zh/learn/use-claude-api-with-codex/ [首页](/zh/) / [学习](/zh/learn/) / Codex CLI 自定义提供商：config.toml、GPT 和 Claude 模型、IDE 扩展及问题修复 # 通过自定义提供商使用 Codex CLI：config.toml、GPT 与 Claude 模型、IDE 扩展与问题修复 Codex 读取一个文件， ~/.codex/config.toml，该文件由 CLI、 codex exec 和 IDE 扩展共用。在该文件中配置自定义提供商，即可将 Codex 指向此网关，同一套配置可运行 GPT 模型和 Claude 模型。当前版本的 Codex 仅使用 Responses API（wire_api = "responses"），因此，使用 wire_api = "chat" 的旧版指南已不再适用。 ## 安装 Codex 终端复制 ``` # macOS / Linux curl -fsSL https://chatgpt.com/codex/install.sh | sh # or with a package manager npm install -g @openai/codex brew install --cask codex codex --version ``` Windows PowerShell复制 ``` powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex" ``` 适用于 VS Code、Cursor 和 Windsurf 的 Codex 扩展可从编辑器的扩展市场安装，并使用与 CLI 相同的 ~/.codex/config.toml ，因此以下所有内容均适用于两者。 ## 使用正确分组中的密钥 网关密钥属于一个分组，该分组决定密钥可以调用哪些模型。对于 GPT 模型，请在控制台的 **Codex** 分组中创建密钥。对于 Claude 模型，任何 Claude 按量付费密钥都可以使用。无限量分组中的密钥需要有效套餐；如果没有，每个请求都会失败并返回 No active subscription found for this group. ~/.bashrc 或 ~/.zshrc复制 ``` export AIPRIME_CODEX_KEY=key_from_the_codex_group # GPT models export AIPRIME_CLAUDE_KEY=key_from_a_claude_group # Claude models ``` Windows复制 ``` setx AIPRIME_CODEX_KEY "key_from_the_codex_group" setx AIPRIME_CLAUDE_KEY "key_from_a_claude_group" # open a new terminal afterwards ``` ## 用于 GPT 模型的 config.toml ~/.codex/config.toml复制 ``` model_provider = "aiprime" model = "gpt-6-astra" model_reasoning_effort = "high" [model_providers.aiprime] name = "AI Prime Tech" base_url = "https://aiprimetech.io/v1" env_key = "AIPRIME_CODEX_KEY" wire_api = "responses" supports_websockets = false ``` | 设置 | 原因 | [model_providers.aiprime] | 除保留标识符以外的任意标识符 openai, ollama 和 lmstudio | base_url = "https://aiprimetech.io/v1" | Codex 会追加 /responses 到其末尾 | env_key | 存储密钥的环境变量的**名称**，而非密钥本身 | wire_api = "responses" | 当前 Codex 接受的唯一值 | supports_websockets = false | 让 Codex 保持使用普通的 HTTP 流式传输，可通过任何代理或 VPN 使用 不要添加 requires_openai_auth = true 或 experimental_bearer_token 到此提供商。使用 requires_openai_auth = true 时，Codex 会忽略 env_key ，转而发送你的 ChatGPT 或 OpenAI 登录凭据，而网关会拒绝这些凭据。 ## 在 Codex 中运行 Claude 模型 网关接受针对 Claude 模型的 Responses API 请求并进行转换，因此 Codex 也可以驱动 Claude。添加另一个使用 Claude 密钥的提供商，再添加一个配置档案以切换到该提供商。 ~/.codex/config.toml（添加在第一个提供商下方）复制 ``` [model_providers.aiprime_claude] name = "AI Prime Tech (Claude)" base_url = "https://aiprimetech.io/v1" env_key = "AIPRIME_CLAUDE_KEY" wire_api = "responses" supports_websockets = false ``` ~/.codex/claude.config.toml复制 ``` model_provider = "aiprime_claude" model = "claude-sonnet-5" model_reasoning_effort = "high" ``` 终端复制 ``` codex --profile claude codex exec --profile claude "review the last commit for bugs" ``` 从 Codex 0.134.0 起，每个配置档案都有独立文件， ~/.codex/.config.toml，其中的键位于顶层； [profiles.] 位于其中的表 config.toml 不再被读取。配置档案和提供商只能在用户配置中设置：项目的 .codex/config.toml 会忽略 model_provider 和 model_providers. ## 模型与推理强度 | 模型 ID | 提供商 | 适用场景 | gpt-6-astra | Codex 分组密钥 | 网关上能力最强的 GPT 模型；适用于长时间智能体任务 | gpt-6-sol | Codex 分组密钥 | 更快、更便宜的 GPT，适用于日常编程 | gpt-5.6-terra | Codex 分组密钥 | 轻量任务和快速编辑 | claude-sonnet-5 | Claude 密钥 | 用于编程工作的默认 Claude 模型 | claude-opus-5-5 | Claude 密钥 | 更复杂的推理和大规模重构 | claude-fable-5-1 | Claude 密钥 | 能力最强，价格也最高 model_reasoning_effort 接受 low, medium, high, xhigh 或 max，具体取决于模型。不要设置 none：这些模型会拒绝该值并返回 'none' is not supported. review_model 可为以下功能设置不同的模型： /review ，如果你需要的话。控制台会显示密钥所属分组可以调用的所有模型。 ## IDE 扩展与 codex exec IDE 扩展读取相同的 config.toml，但 env_key 会从编辑器自身的环境中解析。从程序坞或开始菜单启动的编辑器无法读取在以下文件中导出的变量： .bashrc，这时 Codex 会失败并返回 Invalid API key ，而 CLI 仍能正常使用。请在系统范围内设置该变量（在 Windows 上， setx 可完成此操作），或从终端启动编辑器，例如 code .. codex exec 可在不使用交互式界面的情况下运行单个任务，适合脚本和 CI。它使用相同的配置和配置档案： 终端复制 ``` codex exec "write unit tests for utils.py" codex exec --profile claude "summarise the changes on this branch" codex login status # which authentication method is active ``` ## 重试与超时 每个提供商都有独立的重试和流设置。默认值为 4 次请求重试、5 次流重连，以及每个流 5 分钟的空闲超时。较长的推理轮次可能会有一段时间没有输出，因此在较高推理强度下，延长空闲超时会有所帮助。 ~/.codex/config.toml复制 ``` [model_providers.aiprime] # ...settings from above... request_max_retries = 6 stream_max_retries = 8 stream_idle_timeout_ms = 600000 ``` ## 故障排查：Codex 用户遇到的错误 以下是 Codex 客户端在此网关上实际产生的错误，按常见程度从高到低排列。 | 你会看到什么 | 原因 | 解决方法 | 403 No active subscription found for this group | 密钥属于无限量分组，但没有有效套餐 | 使用按量付费分组中的密钥（GPT 使用 Codex 分组），或购买套餐 | 401 Invalid API key | 运行 Codex 的进程（通常是 IDE）中的变量为空，或者 requires_openai_auth = true 导致 Codex 发送了其他登录凭据 | echo $AIPRIME_CODEX_KEY；移除 requires_openai_auth；重启编辑器 | 404 Model "..." is not supported by any configured account in this group | 模型不属于密钥所在分组，例如使用 GPT 密钥调用 Claude 模型 | 切换提供商或配置档案，使密钥与模型匹配 | 426 WebSocket upgrade required | WebSocket 传输已开启，但连接未升级 | supports_websockets = false，并移除 responses_websockets_v2 ，移除位置为 [features] | 403 Your API key has expired | 创建密钥时设置了到期日期 | 在控制台中创建新密钥 | 'none' is not supported | 推理强度设为 none | 使用 low 或更高 | 404 page not found | base_url 包含 /v1 两次 | 请严格使用 https://aiprimetech.io/v1 | 关于以下内容的配置错误： wire_api ，出现在升级后 | A wire_api = "chat" 来自旧版指南的配置行 | 设置 wire_api = "responses" | Your balance is used up | 余额已用尽 | [充值](/zh/topup/) | Concurrency limit exceeded for user | 多个 Codex 智能体或窗口同时运行 | 减少并行运行的数量，或联系支持团队提高并发上限 在决定使用哪一个之前，想比较 Codex 和 Claude Code？请参阅 [Claude Code 与 Codex 对比](/zh/claude-code/vs-codex/). ## 常见问题 Codex 配置文件在哪里？ ~/.codex/config.toml（或 $CODEX_HOME/config.toml）。CLI、codex exec 和 IDE 扩展都会读取此文件。项目中的 .codex/config.toml 不能设置提供商。 Codex CLI 可以使用 Claude 模型吗？ 可以，通过支持 Claude 模型 Responses API 请求的网关即可使用。添加一个使用 Claude 密钥的提供商，并将 model 设置为 claude-sonnet-5. 这样的 ID wire_api = "chat" 在 Codex 中仍然可用吗？ 不可以。Codex 配置参考文档将 responses 列为唯一支持的值，省略此项时也默认使用该值。 为什么 CLI 可以正常使用，而 Codex VS Code 扩展却提示 API 密钥无效？ env_key 从编辑器的环境中读取。请在系统范围内设置该变量，或从已导出该变量的终端启动编辑器。 Codex 中的“No active subscription found for this group”是什么意思？ 该密钥属于一个没有有效套餐的订阅（Unlimited）分组。请使用按量付费分组的密钥，或购买套餐。 几分钟内开始使用 Claude 获取 API 密钥，无需 Anthropic 账户，也无需加入候补名单。[获取你的 API 密钥](/register) AI Prime Tech 是独立的 API 网关，与 Anthropic 无关联，未获得其背书，也不是其经销商。Claude 及相关模型名称是其各自所有者的商标。 Codex 和 GPT API 指南: [Codex API 密钥与访问](/zh/codex-api/) · [兼容 OpenAI 的 API](/zh/openai-api/) · [Codex CLI 设置](/zh/docs/guides/codex-cli/) · [GPT-6 模型对比](/zh/blog/gpt-6-models-for-codex/) ## 更多 Claude API 指南 [如何获取 Claude API 密钥](/zh/learn/how-to-get-a-claude-api-key/)[Claude API 定价详解](/zh/learn/claude-api-pricing-explained/)[使用 Claude API 最便宜的方式](/zh/learn/cheapest-way-to-use-claude-api/)[通过 Claude API 不限量使用 Cursor](/learn/use-claude-api-with-cursor/)[不限量访问 Claude Code](/zh/learn/use-claude-api-with-claude-code/)[Claude API 网关与 Anthropic 直连对比](/zh/learn/claude-api-vs-anthropic-direct/)[通过兼容 OpenAI 的 API 使用 Claude](/zh/learn/openai-compatible-claude-api/)[Claude 模型详解：Claude Opus、Sonnet、Haiku 与 Fable 的模型对比——全部 Claude API 模型、Anthropic 模型名称与价格（2026）](/zh/learn/claude-api-models-compared/)[使用加密货币支付 Claude API 费用](/zh/learn/claude-api-with-crypto-payment/)[无需候补名单即可访问 Claude API](/zh/learn/claude-api-without-waitlist/)[如何减少 Claude 词元用量](/zh/learn/how-to-reduce-claude-token-usage/)[通过 Claude API 不限量使用 Cline](/zh/learn/use-claude-api-with-cline/)[通过 Claude API 不限量使用 Roo Code](/zh/learn/use-claude-api-with-roo-code/)[在 JetBrains IDE 中不限量使用 Claude](/zh/learn/use-claude-api-with-jetbrains/)[通过 Claude API 无限制使用 Aider](/zh/learn/use-claude-api-with-aider/)[在 VS Code 中不限量使用 Claude](/zh/learn/use-claude-api-with-vscode/)[OpenCode 的 Claude 配置：opencode.json 设置、模型与常见错误](/zh/learn/use-claude-api-with-opencode/)[在 Claude 上运行不受限制的 Hermes 智能体](/zh/learn/run-hermes-agent-with-claude-api/)[使用 Claude 不限量运行 OpenClaw](/zh/learn/run-openclaw-with-claude-api/)[兼容 Anthropic 的 API 意味着什么](/zh/learn/anthropic-compatible-api/)[Claude Code API 密钥 — ANTHROPIC_API_KEY：如何获取、配置，以及何时应改用 claude setup-token](/zh/learn/claude-code-api-key-setup/)[Claude Code API 成本 — 定价与降低成本的方法](/zh/learn/claude-code-api-costs/)[Claude API 错误详解：服务器错误 500、过载 529、速率限制 429、错误请求 400 — 以及各自的修复方法](/zh/learn/claude-api-errors-troubleshooting/)[如何购买 Claude API 额度，以及为什么购买 Claude 额度比任何“购买 Claude 账户”的方案都更好](/zh/learn/buy-claude-api-credits/)[Claude 免费 API：有免费的 Claude API 密钥吗？2026 年究竟有哪些内容免费？](/zh/learn/claude-api-free-trial/)[Claude API 与 Claude Pro/Max 订阅——如何选择](/zh/learn/claude-api-vs-subscription/)[将 Claude 连接到 n8n](/zh/learn/use-claude-api-with-n8n/)[通过 LiteLLM 路由到 Claude](/zh/learn/use-claude-api-with-litellm/)[在 Kilo Code 中使用 Claude](/zh/learn/use-claude-api-with-kilo-code/)[将 Claude 接入 GitHub Copilot](/zh/learn/use-claude-api-with-github-copilot/)[通过网关将 Zed 连接到 Claude](/zh/learn/use-claude-api-with-zed/)[将 Cherry Studio 连接到 Claude](/zh/learn/use-claude-api-with-cherry-studio/)[LangChain 中的 ChatAnthropic：导入、base_url、流式传输、工具和错误](/zh/learn/use-claude-api-with-langchain/)[Anthropic Python SDK：安装、设置 base_url、流式传输和错误处理](/zh/learn/anthropic-python-sdk/)[通过 Vercel AI SDK 使用 Claude：createAnthropic baseURL、流式传输和问题修复](/zh/learn/use-claude-api-with-vercel-ai-sdk/)[使用 Claude 运行 Factory Droid](/zh/learn/use-claude-api-with-factory-droid/)[Claude Code API 详解](/zh/learn/claude-code-api/)[将 Claude API 集成到您的应用中](/zh/learn/claude-api-integration/)[如何不受限制地使用 Claude，以及为什么不存在“Claude Code 破解版本”](/zh/learn/get-unlimited-claude-usage/)