快速开始

通用配置步骤

执行环境

下面的步骤默认都在 Windows 或 macOS 的终端里完成。

1. 检查 Node.js

先运行下面命令，确认本机已经安装 Node.js。只要能输出版本号，就说明环境正常。

node -v
如果没有 Node.js

如果上面这条命令没有输出版本号，可以直接在终端里安装，然后重新打开终端再执行 node -v 和 npm -v 检查。

在管理员终端里运行：

winget install OpenJS.NodeJS.LTS

安装完成后，重新打开终端，检查是否生效：

node -v
npm -v

如果不习惯命令行,可以直接去 Node.js 官方下载页获取最新版安装包。

打开下载页

2. 安装 Codex CLI

先把 Codex CLI 装好，后面的配置步骤都会基于它继续进行。

npm i -g @openai/codex@latest

3. 测试运行

打开终端，运行下面的命令。只要 Codex CLI 能正常拉起界面或进入对话，就说明安装阶段没有大问题。

codex

4. 常见问题：Claude Code 提示缺少 Git

如果 Claude Code 启动时提示缺少 Git 环境，先安装 Git，再回到上面的测试步骤重新运行。

Windows 用户可以直接使用 Git 官方安装页。

下载 Git

CLI 配置

使用 CC-Switch 配置

CC-Switch 能做什么

  • 一键切换 API 配置，在多个提供商之间快速切换。
  • 可视化管理 Claude Code、Codex、Gemini 的配置。
  • 支持 MCP 服务器管理、托盘切换、本地代理与故障转移。

下载最新的 CC-Switch 工具并在本机安装。

下载 CC-Switch

配置渠道商

  1. 打开软件，先选择你要配置的 CLI，然后点击“添加供应商”。
  2. "预设供应商" 保持默认的 "自定义配置"，填入 API Key 和 API 请求地址。
    API 请求地址 https://chunfeng.mentalout.top/v1
  3. 回到主界面确认当前启用的渠道就是你刚添加的那个.
  4. 进入设置页，找到 跳过Claude Code初次安装确认，把它打开。
  5. 最后在终端里运行 codex 或 claude 做一次简单对话，确认配置已生效。

CLI 配置

手动配置 Codex

这个部分保留了安装方式、配置目录、配置文件内容和模型提醒。

更省事的方案

原文档同样优先推荐 CC-Switch。下面这套方式适合 CLI、VSCode 插件和 Codex App 共用。

1. 选择安装方式

命令行版本先执行安装命令：

npm i -g @openai/codex@latest

Codex CLI 包地址

2. 打开 Codex 配置目录

start "" "%USERPROFILE%\.codex"

3. 创建 config.toml 和 auth.json

model_provider = "chunfeng"
model = "gpt-5.4"
model_reasoning_effort = "xhigh"
network_access = "enabled"
disable_response_storage = true
windows_wsl_setup_acknowledged = true
model_verbosity = "high"

[model_providers.chunfeng]
name = "chunfeng"
base_url = "https://chunfeng.mentalout.top/v1"
wire_api = "responses"
requires_openai_auth = true

4. 填入 API Key

把你后台生成的密钥写进 auth.json 的 OPENAI_API_KEY 字段，然后保存。

5. 测试

codex
CLI 模型提醒
  • CLI 启动后尽量不要在会话里切换模型。
  • 如果你切换过模型，需要重新用下面命令启动，才会继续使用 gpt-5.3-codex：
codex -m gpt-5.3-codex -c model_reasoning_effort="xhigh"
配置生效提醒
  • 每次改完 config.toml 或 auth.json，都需要重启 codex。
  • 重启方式：先按 Ctrl + C 退出当前会话，再重新运行 codex。
  • VSCode 插件版 Codex 和 Codex App 同样适用这套配置。

CLI 配置

在 OpenCode 中配置使用

OpenCode 已经并入 “CLI 配置” 分类。这里保留原文档的实际操作步骤，但不再依赖站内图片和组件。

1. 下载预配置压缩包

OpenCode 资源

QuickConfiguration.zip

压缩包里包含 opencode.json 和 plugins 目录。

下载压缩包

2. 修改 opencode.json

分别在 Gemini、Claude、GPT 这三部分填入对应 API Key，然后保存。

填写密钥时的注意点

生成 API Key 时要选对你准备使用的渠道，文档里注明“可用模型”保持默认即可。

3. 找到 OpenCode 配置目录

首次配置先做这两步 
npm i -g opencode-ai
opencode
start "" "%USERPROFILE%\.config\opencode"

4. 复制文件

把你刚修改好的 opencode.json 和 plugins 目录整体复制到 OpenCode 的配置目录里。

5. 测试

opencode
/models

常见问题

Codex 相关疑问

这里保留原 FAQ 页面中“如何在 Codex 中使用最新模型”的实际步骤，并把下载组件改成普通链接卡片。

如何在 Codex 中启用最新模型

通用启用方式
  • 打开 config.toml，找到 model = "gpt-5.2" 这一行。
  • 把它改成你要启用的模型，例如 model = "gpt-5.3-codex".
  • 保存后重启你正在使用的客户端：Codex CLI、Codex App、VSCode 插件都一样。
  • 启用后不要在会话里切换模型。如果切过，请重新用命令行参数启动。

CLI 使用方法

  1. 打开终端，用下面命令启动 Codex。
codex -m gpt-5.3-codex -c model_reasoning_effort="xhigh"
  1. 进入对话后，直接提问即可使用最新模型。
重启提醒

如果你当前已经打开了 codex，先按 Ctrl + C 退出，再用上面的命令重新启动。

VSCode 版本使用方法

版本提示

这套替换文件的教程只适用于对应支持范围内的 Codex 插件版本。开始之前，先确认你的插件版本和下载包说明一致，并切到预发布版本。

  1. 先在 VSCode 扩展页查看当前插件版本，并切换到预发布版本。
  2. 打开 VSCode 插件目录：
start "" "%USERPROFILE%\.vscode\extensions"
  1. 在目录里找到以 openai.chatgpt 开头的文件夹，后缀版本号要和你看到的插件版本匹配。
  2. 继续进入 webview\assets 目录。
  3. 下载下面这个替换压缩包，解压后把里面的 JS 文件覆盖到 webview\assets 目录。

Codex 替换资源

vscode-codex-replace.zip

用于替换 VSCode 插件里的前端资源文件，解压后覆盖原目录中的对应 JS 文件。

下载压缩包
  1. 重启 VSCode，查看模型列表里是否已经出现最新模型。