首页 → 指南 → Codex 接入第三方 API：命令行版和桌面版的 config.toml 配置

Codex 接入第三方 API：命令行版和桌面版的 config.toml 配置

Codex 从一个配置文件里读取服务商。五行配置加一个环境变量，就能把命令行版和桌面版同时切到另一个接口——而大多数失败出在环境变量上，不在配置文件上。

配置内容

在 config.toml 里加一个服务商，并设为默认：

model = "gpt-6.1-sol"
model_provider = "apiclan"
model_reasoning_effort = "medium"

[model_providers.apiclan]
name = "APICLAN"
base_url = "https://apiclan.us/v1"
env_key = "APICLAN_API_KEY"
wire_api = "responses"

有三处要注意。base_url 要以 /v1 结尾，因为 Codex 会自己在后面加 /responses。wire_api = "responses" 让 Codex 使用 Responses API，本网关支持这个接口。env_key 填的是环境变量的名字，不是密钥本身。

配置文件在哪

• macOS / Linux: ~/.codex/config.toml
• Windows: %USERPROFILE%\.codex\config.toml

文件夹和文件不存在就自己新建。Codex 桌面版和命令行版读的是同一个文件，改一次两边都生效。不想手动改 TOML 的话，可以用 CC Switch 帮你写——见桌面客户端指南。

设置密钥，让 Codex 读得到

macOS / Linux ——写进终端的配置文件：

echo 'export APICLAN_API_KEY=sk-your-key' >> ~/.zshrc
source ~/.zshrc

Windows ——保存到当前用户：

setx APICLAN_API_KEY "sk-your-key"

大多数配置都坏在这一步。用 export 或 $env: 设置的变量只在那个终端窗口里有效；从程序坞或开始菜单打开的桌面版根本看不到它。Windows 的 setx 会永久保存，但只有之后启动的程序才能读到——要把 Codex 完全退出再重新打开。

选择模型和推理强度

在配置里改 model，或者在会话里用 /model 切换：

模型	适合
gpt-6.1-sol, gpt-5.6-terra	日常写代码、改代码、写测试——单次最便宜
gpt-5.6-sol	提示词已经针对 GPT-5.6 调好时
gpt-6-astra	值得多花五倍价钱换更好答案的难题

model_reasoning_effort 可以设成 low、medium、high、xhigh。强度越高写得越多：本站 gpt-5.6-sol 的中位数调用，high 输出 373 个 token，medium 只有 139 个——多了 2.7 倍，全部按输出计费。建议从 medium 开始。价格见 OpenAI API 价格指南。

本站的 Codex 流量长什么样

过去 30 天，本网关 87% 的 GPT 调用来自 Codex，全部通过 /v1/responses 流式请求。中位数调用：

• 带着约 6.7 万 token 的上下文，其中 86% 来自缓存
• 全程 14 秒，首个 token 在第 10 秒出来
• 输出 214 个 token

最常见的四种报错

• 401 Unauthorized → Codex 读不到 APICLAN_API_KEY。按上面的方法设置，然后把 Codex 完全重启。在同一个环境里执行 echo $APICLAN_API_KEY 应该能打印出密钥。
• 404 或返回网页 → base_url 漏了 /v1，或者写了两遍。
• model not found → 模型名拼错了，或者你的密钥所在的分组没有这个模型。以 GET https://apiclan.us/v1/models 返回的列表为准。
• stream disconnected 或长任务超时 → 推理时间太长，超过了代理的等待上限。把 base_url 改成 https://api.apiclan.us/v1，这个地址绕开了 100 秒的代理限制。

Claude Code 的规则正好相反——不带 /v1——见 Claude Code base URL 指南。

开始使用

无订阅、无最低消费、不用跟销售通话。用 USDT 充值，用多少花多少 —— 1 USDT = 2 额度。

看 30 秒快速开始

语言: English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Deutsch · Français · Español · Türkçe · Português · Italiano · Bahasa Indonesia · Tiếng Việt · Bahasa Melayu · Polski · Čeština · فارسی · Русский

本页价格由实时计费数据自动填入；第三方条款引自对方公开文档。