Codex VSCode

Codex VSCode 使用教程。

当前建议分组：AppCodex 当前建议模型：gpt-5.5

在阅读本页之前，请先完成你所在系统的 Codex CLI 配置，并确认在终端里直接运行 codex 没有问题。

(一) 安装 VSCode

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

(二) 安装 Codex 扩展

打开 VSCode 扩展市场，搜索：

1Codex

安装后重启 VSCode。

(三) 准备本地配置

Codex 的 VSCode 集成通常会复用本机的 ~/.codex/config.toml。

确认你的配置文件至少包含：

 1model_provider = "4router"
 2model = "gpt-5.5"
 3model_context_window = 1000000
 4model_auto_compact_token_limit = 900000
 5
 6[model_providers.4router]
 7name = "4Router"
 8base_url = "https://4router.net/v1"
 9requires_openai_auth = true
10wire_api = "responses"

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

1{
2  "OPENAI_API_KEY": "sk-xxxxx"
3}

(四) 开始使用

  1. 打开项目目录
  2. 启动 Codex 扩展
  3. 发送一个最短测试任务

例如：

1Print a short hello from the AppCodex group on 4Router.

(五) 常见问题

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