文档目录
接入 Codex CLI
Codex CLI 接入 Tokenway：配置 config.toml 和密钥环境变量、验证接通、常见报错。
Codex CLI 通过自定义“模型提供方”接入。使用 Responses 接口（wire_api = "responses"），接入地址带 /v1。Responses 只支持 GPT 系列，所以 Codex 里只能用 GPT 模型，模型名见 模型定价。
开始之前
- 已经安装好 Codex CLI（安装方式见 OpenAI 官方文档）。
- 已经有一把 Tokenway 的 API 密钥，见 创建 API 密钥。
1. 设置密钥环境变量
macOS / Linux（当前终端有效）
export TOKENWAY_API_KEY="sk-xxxxxxxx"想每次打开终端都生效：把这一行写进 ~/.zshrc（或 ~/.bashrc），再执行 source ~/.zshrc。
Windows（长期生效，新开一个终端后才生效）
setx TOKENWAY_API_KEY "sk-xxxxxxxx"只想让当前 PowerShell 窗口有效：$env:TOKENWAY_API_KEY = "sk-xxxxxxxx"。
2. 编辑 config.toml
文件位置：~/.codex/config.toml（Windows 在用户目录下的 .codex\config.toml）。
~/.codex/config.toml
model = "gpt-6.1-sol"
model_provider = "tokenway"
[model_providers.tokenway]
name = "Tokenway"
base_url = "https://tokenwayapi.com/v1"
env_key = "TOKENWAY_API_KEY"
wire_api = "responses"env_key 写的是环境变量的名字，不是密钥本身，密钥不要直接写进配置文件。
3. 运行
在项目目录里运行 codex。想临时换模型，用 codex -m 模型名。
GPT 系列同时支持 Chat Completions 和 Responses，Codex 推荐用 Responses。两种格式的区别见 接口格式。
怎么确认接通了
- 运行
codex，问一句简单的话（比如“你好”），能正常回复就说明接通了。 - 打开控制台的 使用记录，应该能看到刚才这一笔：模型名、输入输出 token、缓存命中和扣费。
- 想先用命令行验证，可以用 用 curl 测试 里的 Responses 示例。
费用怎么算
Codex 每次请求会带上项目上下文，长对话 token 较多；命中缓存的部分按“缓存读取”价计费，比普通输入便宜。价格见 模型定价，计费方式见 计费与定价，每一笔都能在 使用记录 里核对。
常见问题
| 现象 | 原因和处理 |
|---|---|
401 | 密钥没设置到环境变量，或填错、已停用。先检查环境变量是否生效（macOS / Linux 用 echo $TOKENWAY_API_KEY；Windows 新开终端后，命令提示符用 echo %TOKENWAY_API_KEY%，PowerShell 用 $env:TOKENWAY_API_KEY），再到 API 密钥 页确认。 |
402 | 余额不足，见 充值购买。 |
404 / 找不到模型 | 模型名要和 模型定价 页完全一致；base_url 要带 /v1。 |
400：不支持 xxx 接口 | Codex 用的是 Responses，只能配 GPT 系列的模型名；填 Claude 或其他系列会返回 400。 |
| 连不上或很慢 | API 密钥 页里还有备用接入地址，把 base_url 换成备用地址（同样要带 /v1）试试；到 服务状态 看线路是否正常。 |
其他错误见 错误码。
选好模型，核对费用再接入
查看当前模型的价格与参数，用自己的输入、输出和缓存用量估算成本；遇到报错时按错误码排查。