Codex Windows

Codex Windows 使用教程。

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

(一) 安装 Node.js 环境

Windows 安装方法

方法一：官网下载

  1. 打开 https://nodejs.org/
  2. 下载 LTS 版本
  3. 双击安装包完成安装

方法二：包管理器

1choco install nodejs
2scoop install nodejs

验证安装：

1node --version
2npm --version

(二) 安装 Codex

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

验证安装：

1codex --version

(三) 配置 Codex

打开 C:\Users\你的用户名\.codex\config.toml，如果文件不存在就手动创建。

写入：

 1disable_response_storage = true
 2model = "gpt-5.6-luna"
 3model_reasoning_effort = "high"
 4model_provider = "4router"
 5model_context_window = 1000000
 6model_auto_compact_token_limit = 900000
 7
 8[model_providers.4router]
 9name = "OpenAI"
10base_url = "https://4router.net/v1"
11requires_openai_auth = true
12wire_api = "responses"

name = "OpenAI" 必须一字不差（大写 O、大写 A）。Codex 源码里是精确的字符串比较，写成 openai、Openai 都不会生效。配置节名（model_providers.4router 与 model_provider = "4router"）可以随便取，但不能叫 openai（Codex 保留）。

name = "OpenAI" 会让 Codex 按官方端点对待 4Router，从而启用远程压缩 V2——长对话自动压缩上下文，是用满 1M 上下文的关键。同时它也会启用内置 web_search、图像生成工具，并向网关透传部分内部元数据，4Router 已适配这条链路。如果不需要这些增强，把 name 改成其他值（如 "4Router"）即可，代价是失去远程压缩。

然后编辑 C:\Users\你的用户名\.codex\auth.json，把 Key 写在这里（不再需要设置环境变量）：

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

如果文件不存在就手动创建。

(四) 开始使用 Codex

1codex

第一次建议给一个最短任务：

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

(五) 常见问题

  • 启动时报 provider 错误：确认 model_provider = "4router" 和配置节名一致。
  • 长对话没有触发远程压缩：检查 provider 的 name 是否精确为 OpenAI（大小写敏感）。
  • 请求失败但普通 OpenAI 客户端正常：确认 wire_api = "responses" 没写错。
  • 提示缺少 API Key：检查 auth.json 是否为合法 JSON，键名必须是 OPENAI_API_KEY。
  • 请求失败：先去控制台确认当前令牌能否使用 AppCodex 分组。
  • 模型找不到：把 model 改成你账户实际可用的 Codex 模型名。