Vector Wiki - 中文

使用 CC Switch 导入 Codex 配置

Sun, 31 May 2026 00:00:00 GMT

使用 CC Switch 导入配置（Codex CLI）

如果你需要为 Claude CLI 配置 GPT 模型，请参考 Claude CLI + CC Switch。

下载 CC Switch

访问 CC Switch 项目发布页：

https://github.com/farion1231/cc-switch/releases/latest

下载适合自己系统的版本，安装或打开后继续下一步。

在控制台创建 API Key

创建后，在 API Key 列表中打开右侧菜单，选择 CC 切换。

填写 Codex 导入信息

在导入弹窗中选择 Codex。

名称可以随便填写，例如：

My Codex

模型可以选择：

gpt-5.3
gpt-5.4
gpt-5.5

确认导入

检查信息无误后点击导入。

导入完成后，可以打开命令行运行 codex 测试。

VS Code 插件配置

Sun, 31 May 2026 00:00:00 GMT

在 VS Code 中配置 Codex 插件

Codex CLI 配置完成后，你还可以在 VS Code 中安装 Codex 插件，直接在编辑器里使用 AI 辅助编程。

前提条件

已安装 VS Code
已完成 Codex CLI 安装与配置，并且 CLI 可以正常使用

搜索并安装插件

打开 VS Code，点击左侧的扩展图标（或按 Ctrl + Shift + X），在搜索框中输入 Codex。

找到 Codex 插件后，点击安装。

测试插件

安装完成后，按 Ctrl + Shift + I 打开 Codex 的聊天面板，发送一条消息测试，例如：

你好，帮我写一个 Hello World 程序

如果 Codex 正常回复，说明插件配置成功，可以在 VS Code 中正常使用了。

VS Code 与 CLI 的关系

VS Code 的 Codex 插件会复用你在 CLI 中已经配置好的 API 端点和 Key，不需要额外配置。只要 CLI 能正常工作，插件就能直接使用。

常见问题

插件安装后无法使用

先确认 Codex CLI 本身能正常工作：

打开命令提示符，输入 codex，确认 CLI 可以正常启动和回复
如果 CLI 正常但插件不行，尝试重启 VS Code

找不到 Codex 插件

检查 VS Code 版本是否过旧，建议更新到最新版本。另外确认网络连接正常，能访问 VS Code 扩展商店。

Node.js 与 Git 环境准备

Sun, 31 May 2026 00:00:00 GMT

Node.js 与 Git 环境准备

配置 Codex CLI 前，先准备 Node.js、npm 和 Git。

安装 Node.js

访问 Node.js 官网：

https://nodejs.org/zh-cn/download

在下载页面选择 Windows 的 .msi 安装包。

安装完成后，按 Win + R，输入 cmd 打开命令提示符。

依次输入：

node -v
npm -v

如果都能返回版本号，就代表 Node.js 和 npm 安装成功。

安装 Git

下载 Git for Windows。

主链接：

https://github.com/git-for-windows/git/releases/download/v2.53.0.windows.1/Git-2.53.0-64-bit.exe

如果下载很慢，可以用备用链接：

https://registry.npmmirror.com/-/binary/git-for-windows/v2.51.0.windows.1/Git-2.51.0-64-bit.exe

安装时建议一路使用默认选项，不建议修改安装路径。Word 文档里特别提醒建议安装到 C 盘，避免后续报错。

下一步

Node.js、npm 和 Git 都准备好后，继续安装 Codex CLI。

Claude CLI + CC Switch 配置

Sun, 31 May 2026 00:00:00 GMT

在 CC Switch 中为 Claude CLI 配置 GPT 模型

除了 Codex CLI，CC Switch 同样支持为 Claude CLI 一键导入配置，让 Claude CLI 使用 HUA God 提供的 GPT 模型。

前提条件

已在 HUA God 控制台创建 API Key
已下载并打开 CC Switch
已安装 Claude CLI

如果还没完成以上步骤，请先参考：

Node.js 与 Git 环境准备
使用 CC Switch 导入配置（Codex）（CC Switch 下载方式相同）

选择 API Key 并打开 CC 切换

在 HUA God 控制台的 API 密钥 页面，找到你要用的 Key，点击右侧菜单中的 CC 切换。

选择应用为 Claude

在导入弹窗中，应用类型选择 Claude（而不是 Codex）。

名称可以自定义，例如：

My Claude

选择 GPT 模型

依次选择你需要使用的 GPT 模型。可选的模型包括：

gpt-5.3
gpt-5.4
gpt-5.5

可以根据需要勾选多个模型。

确认导入

检查应用类型、名称和模型选择无误后，点击导入。

验证配置

打开命令提示符（CMD），输入以下命令启动 Claude CLI：

claude

进入 Claude CLI 后，输入：

/model

此时你应该能看到从 HUA God 导入的 GPT 模型列表，表示配置已成功生效。

常见问题

Claude CLI 未安装

如果提示 claude 命令未找到，需要先安装 Claude CLI。访问 Anthropic 官方文档获取安装方式。

模型列表未刷新

确认 CC Switch 导入时选择了正确的应用类型（Claude），并且导入操作已成功完成。如果仍有问题，可以尝试重新导入一次。

安装 Codex CLI

Sun, 31 May 2026 00:00:00 GMT

安装 Codex CLI

完成 Node.js 环境准备后，就可以通过 npm 安装 Codex CLI。

正常安装

打开命令提示符或 PowerShell，输入：

npm install -g @openai/codex

网络慢或无法下载

如果无法下载，先关闭代理或魔法工具，再尝试使用 npm 镜像源：

npm install -g @openai/codex --registry https://registry.npmmirror.com

验证安装

输入：

codex --version

能返回版本号，就代表 Codex CLI 安装成功。

下一步

安装完成后，推荐使用 CC Switch 导入配置。

测试与切换模型

Sun, 31 May 2026 00:00:00 GMT

测试与切换模型

配置完成后，需要实际启动 Codex CLI 测试一次。

启动测试

打开命令提示符，输入：

codex

进入后发送一条消息，例如：

你好

如果 Codex 正常回复，代表配置已生效。

切换模型

在 Codex CLI 中输入：

/model

然后按提示选择需要使用的模型。

常见检查项

如果无法启动或无法回复，优先检查：

node -v 和 npm -v 是否正常返回版本号。
codex --version 是否正常返回版本号。
API Key 是否复制完整。
手动配置时，base_url 是否为 https://huablog.xyz/v1。
手动配置时，auth.toml 中的 Key 是否写在 OPENAI_API_KEY 里。

在 VS Code 中使用

如果希望在编辑器内直接使用 Codex，可以安装 VS Code 插件，它会复用你已配置好的 CLI 环境，无需额外设置。

全流程速览

Sun, 31 May 2026 00:00:00 GMT

全流程速览

这份指南将带你完成 Codex CLI 在 Windows 上的完整配置流程。

配置路线

安装 Node.js，确认 node -v 和 npm -v 能返回版本号。
安装 Git，建议使用默认路径，避免后续命令找不到 Git。
使用 npm 安装 Codex CLI。
在 HUA God 控制台创建 API Key。
推荐使用 CC Switch 导入 Codex 配置。
打开命令行运行 codex，发送一条消息确认配置成功。
需要切换模型时，在 Codex CLI 中输入 /model。
可选：在 VS Code 中安装 Codex 插件，在编辑器内直接使用 AI 辅助编程。

快速命令

安装 Codex CLI：

npm install -g @openai/codex

如果网络无法下载，可以关闭代理后尝试 npm 镜像：

npm install -g @openai/codex --registry https://registry.npmmirror.com

验证安装：

codex --version

启动 Codex：

codex

手动配置 Codex CLI

Sun, 31 May 2026 00:00:00 GMT

手动配置 Codex CLI

如果不用 CC Switch，也可以手动配置 Codex CLI。

找到配置目录

安装 Codex CLI 后，进入当前用户的 Codex 配置目录：

C:\Users\用户名\.codex\

检查目录里是否有这两个文件：

config.toml
auth.toml

如果没有，就新建这两个文件。

配置 config.toml

用记事本打开 config.toml，写入：

model_provider = "my_codex"
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
disable_response_storage = true

[model_providers.my_codex]
name = "my_codex"
base_url = "https://huablog.xyz/v1"
wire_api = "responses"
requires_openai_auth = true

[projects.'C:\Users\你的用户名']
trust_level = "trusted"

把 [projects.'C:\Users\你的用户名'] 改成你自己的用户目录。Word 文档示例里写的是类似 C:\Users\86159 的路径。

配置 auth.toml

用记事本打开 auth.toml，写入：

{
  "OPENAI_API_KEY": "你控制台创建的key"
}

把 你控制台创建的key 替换成 HUA God 控制台创建的 API Key。

检查配置

配置完成后，打开命令行输入：

codex

如果能正常进入 Codex CLI，并且发送消息有回复，就说明配置成功。

Vector Wiki - 中文

使用 CC Switch 导入 Codex 配置

使用 CC Switch 导入配置（Codex CLI）

下载 CC Switch

在控制台创建 API Key

填写 Codex 导入信息

确认导入

VS Code 插件配置

在 VS Code 中配置 Codex 插件

前提条件

搜索并安装插件

测试插件

VS Code 与 CLI 的关系

常见问题

插件安装后无法使用

找不到 Codex 插件

Node.js 与 Git 环境准备

Node.js 与 Git 环境准备

安装 Node.js

安装 Git

下一步

Claude CLI + CC Switch 配置

在 CC Switch 中为 Claude CLI 配置 GPT 模型

前提条件

选择 API Key 并打开 CC 切换

选择应用为 Claude

选择 GPT 模型

确认导入

验证配置

常见问题

Claude CLI 未安装

模型列表未刷新

安装 Codex CLI

安装 Codex CLI

正常安装

网络慢或无法下载

验证安装

下一步

测试与切换模型

测试与切换模型

启动测试

切换模型

常见检查项

在 VS Code 中使用

全流程速览

全流程速览

配置路线

快速命令

推荐方式

手动配置 Codex CLI

手动配置 Codex CLI

找到配置目录

配置 config.toml

配置 auth.toml

检查配置