配置 Codex

Kitcoding 通过 OpenAI 兼容端点接入 Codex。

前置条件

1. 已创建令牌，推荐分组：Codex专用（正价账号，稳定）。
2. 安装 Codex 需要 Node.js（npm 方式），详见 环境检查。

💡 新手推荐：用 cc-switch 一键搞定

不想碰命令行和配置文件？推荐用图形化工具 cc-switch ——它能帮你一键安装 CLI 并自动填好配置，是最省心的方式。

下方的手动配置适合想搞清楚原理、或不想装额外工具的用户。两条路二选一即可。

一、安装

npm

npm install -g @openai/codex@latest

Homebrew

brew install codex

二、生成配置目录

安装后先运行一次 codex 生成 .codex 配置目录。

三、配置 config.toml

打开 Codex 配置目录：

• Windows：Win + R 输入 %userprofile%\.codex
• macOS：访达 Command + Shift + G 输入 ~/.codex

若没有这些文件需手动创建。在 config.toml 写入：

disable_response_storage = true
model = "gpt-5.2"
model_provider = "kitcoding"
model_reasoning_effort = "high"
model_verbosity = "high"

[features]
web_search_request = true

[model_providers.kitcoding]
name = "kitcoding"
base_url = "https://kitcoding.com/v1"
wire_api = "responses"
requires_openai_auth = true

注意

• OpenAI 兼容端点 必须带 /v1。
• model 按 模型广场 实际可用模型填写。

四、配置 auth.json

在 auth.json 写入你的令牌：

{
  "OPENAI_API_KEY": "你的-kitcoding-令牌"
}

五、验证

终端运行 codex，能正常对话即成功。

用 cc-switch 配置（可选捷径）

不想手动改 config.toml / auth.json？cc-switch（v3.16.0+）可在图形界面里一键安装 Codex 并填好配置，自动写入上面两个文件，因此选这条路就无需手动执行第一～四步。详见 cc-switch 文档。