Codex CLI

Codex CLI 是 OpenAI 官方的命令行编码助手，配合 gpt-5.5 模型使用体验最佳。

一键管理多家供应商

如果你同时用 OpenAI 官方和多家中转，推荐用 CC Switch 管理——比手动改 config.toml 省心很多。

安装

# 任选其一
npm install -g @openai/codex
brew install codex

验证安装：

codex --version

配置

编辑 ~/.codex/config.toml（Windows 在 %USERPROFILE%\.codex\config.toml），如果文件不存在请新建：

model = "gpt-5.5"
model_provider = "tokone"

[model_providers.tokone]
name = "TokOne"
base_url = "https://api.tokone.ai/v1"
wire_api = "responses"

wire_api 必须是 responses

Codex CLI 走 OpenAI 的 Responses API（不是 Chat Completions），wire_api 写错会报 unsupported endpoint。

提供 API Key

两种方式任选其一：

方式 A：codex login（推荐）

codex login
# 按提示粘贴 sk-xxx

凭证会被写到 ~/.codex/auth.json，跨终端会话生效。

方式 B：环境变量

macOS / Linux

export OPENAI_API_KEY="sk-xxx"

Windows Terminal

$env:OPENAI_API_KEY = "sk-xxx"

环境变量方式只对当前终端会话生效。要永久生效，写到 ~/.zshrc（macOS）/ ~/.bashrc（Linux）/ Windows 系统环境变量里。

验证

codex "用一句话介绍当前目录的项目"

能拿到回复 = 配置生效。也可以在 TokOne 控制台「使用记录」页确认请求落地。

常见问题

报 unsupported endpoint

wire_api 没写对。必须是 responses，不是 chat_completions。

配置文件改了不生效

确认 model_provider 字段值与 [model_providers.xxx] 的 xxx 完全一致（区分大小写）。Codex 启动时按这个字段去找 provider 块。

模型名报 404

Codex CLI 的 model 名要写完整：gpt-5.5，不要写 codex 或 gpt-codex。

多个项目用不同 Key

~/.codex/config.toml 是全局配置。如果想按项目用不同 Key，在项目目录下放一个 .codex/config.toml 覆盖即可（Codex 会就近读取）。

下一步

• 模型清单 —— 看 gpt-5.5 的价格与上下文
• API 端点 —— 协议说明