Codex VSCode 使用教程

一、安装 VSCode

• 打开 https://code.visualstudio.com/
• 安装 VSCode 1.75.2 或更新版本。

二、安装 Codex 扩展

打开 VSCode 扩展市场，搜索 Codex，安装后重启 VSCode。

三、准备本地配置

Codex 的 VSCode 集成通常会复用本机的 ~/.codex/config.toml。确认配置文件至少包含：

disable_response_storage = true
model = "gpt-5.5"
model_reasoning_effort = "high"
model_provider = "routix"
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.routix]
name = "RouTix"
base_url = "https://bgp.routix.cn/v1"
requires_openai_auth = true
wire_api = "responses"

然后确认 ~/.codex/auth.json 中已写入 Key：

{
  "OPENAI_API_KEY": "sk-xxxxx"
}

四、开始使用

• 打开项目目录。
• 启动 Codex 扩展。
• 发送一个最短测试任务。

Print a short hello from the codex official channel on RouTix.

五、常见问题

• 扩展里打不开会话：先确认终端里的 codex 是否正常。
• 模型找不到：回头检查 config.toml 中的模型名。
• 请求走错接口：确认 wire_api = "responses" 没有被改掉。
• 请求失败：先去控制台确认当前令牌能否使用 【GPT】Plus分组。
• 模型不可用：把 model 改成你账户实际可用的 Codex 模型名。