手动配置Codex

提示

优先使用 CC-Switch 导入配置。只有在你需要手动配置 Codex，或者 CC-Switch 暂时不可用时，再参考本页。

1. 安装 Codex

Codex CLI

如果你使用命令行版本，先运行下面命令安装：

npm i -g @openai/codex@latest

Codex CLI 包地址：

https://www.npmjs.com/package/@openai/codex

VSCode 插件

如果你使用 VSCode，可以安装官方插件：

https://marketplace.visualstudio.com/items?itemName=openai.chatgpt

也可以直接在 VSCode 扩展中心搜索 codex 进行安装。

Codex App

如果你还没安装 Codex App，可以从这里下载：

https://developers.openai.com/codex/quickstart?setup=app

2. 打开 Codex 配置文件夹

先打开终端程序，然后根据系统运行下面的命令：

Windows

start "" "%USERPROFILE%\.codex"

macOS

open "$HOME/.codex"

3. 创建 config.toml 和 auth.json

如果文件夹里还没有这两个文件，就手动新建；如果已经存在，按下面内容检查并修改。

config.toml

model_provider = "cccode"
model = "gpt-5.5"
review_model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true

[model_providers.cccode]
name = "cccode"
base_url = "https://api.cccode.top"
wire_api = "responses"
requires_openai_auth = true

[features]
goals = true

auth.json

{
  "OPENAI_API_KEY": "你的 ApiKey"
}

4. 填入你的 ApiKey

在后台创建或复制 ApiKey，然后填到 auth.json 的 OPENAI_API_KEY 中并保存。

配置生效提醒

• 每次修改 config.toml 或 auth.json 后，都需要重启 Codex 才会生效。
• 如果后台「使用密钥」弹窗生成的配置和本文不一致，以后台当前生成内容为准。
• VSCode 插件版 Codex 和 Codex App 也适用这套配置。