Codex 接入

首选做法

优先直接用 cc-switch 完成配置，不建议先手改配置文件。

安装前准备

Codex CLI 官方安装命令是通过 npm 全局安装，因此需要先准备好：

Node.js
npm（安装 Node.js 后通常会一起提供）

安装方式建议直接走 Node.js 官方下载页：https://nodejs.org/en/download

macOS / Windows：进入上面的官方页面，下载并安装 LTS 版本
Linux：在同一页面按你的发行版选择官方提供的安装方式或二进制包

如果你在 macOS 上已经安装了 Homebrew，也可以直接执行：

bash

brew install node

这会同时安装 Node.js 和 npm。

安装完成后，npm 通常会随 Node.js 一起可用。然后确认命令可用：

bash

node -v
npm -v

确认 npm 已可用后，再执行下面的安装命令。

安装

bash

npm i -g @openai/codex

VS Code 扩展

截至 2026-03-31，OpenAI 官方已经提供 Codex 的 VS Code IDE extension，并说明它兼容大多数 VS Code 分支。

如果你想在 VS Code 里使用 Codex：

在 VS Code 扩展市场搜索 Codex 并安装官方扩展。
打开 VS Code 的设置，搜索 Codex 可看到扩展自己的 UI 设置项。
真正影响模型、审批模式、sandbox 等行为的，仍然是共享的 ~/.codex/config.toml。

也就是说，对当前网关来说，VS Code 扩展不需要单独再写一套专用配置；沿用下面这份 ~/.codex/config.toml 和 API Key 配置即可。

API Key

如果你使用 API Key 模式，Codex 本地通常会在 ~/.codex/auth.json 保存鉴权信息。

如果你只是检查本地配置，可参考：

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "codex_your_api_key"
}

这里的 OPENAI_API_KEY 就是你的 codex_... Key。auth.json 一般不需要手动编辑，确认它已经以 apikey 模式保存即可。

如果你只是临时在当前 shell 会话里测试，也可以直接导出：

bash

export OPENAI_API_KEY="codex_your_api_key"

手动配置参考

如果你不用 cc-switch，或者只是想核对本地配置文件，可参考 ~/.codex/config.toml：

model_provider = "custom"
model = "gpt-5.4"
disable_response_storage = true
model_reasoning_effort = "high"

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

[notice.model_migrations]
"gpt-5.2-codex" = "gpt-5.4"

这里的 base_url 应填写像 https://api.gemiaude.com/v1 这样的服务根路径，而不是 /v1/responses 的完整接口地址。

这套配置使用的是 Codex 的 API Key 鉴权模式：模型提供方为 custom，请求走 responses 协议，API Key 由 ~/.codex/auth.json 或当前 shell 里的 OPENAI_API_KEY 提供。

验证

bash

codex

如果你已经能在会话里正常发起提问，并且模型解析到 gpt-5.4，说明接入成功。

如果你使用的是 VS Code 扩展，打开扩展侧边栏后能正常开始会话，也说明这套共享配置已经生效。

Codex 接入 ​

推荐方式 ​

首选做法 ​

安装前准备 ​

安装 ​

VS Code 扩展 ​

API Key ​

手动配置参考 ​

验证 ​

Codex 接入

推荐方式

首选做法

安装前准备

安装

VS Code 扩展

API Key

手动配置参考

验证