返回使用文档

Codex / Windows

Codex Windows 使用教程

在 Windows 上安装 Codex,并通过 config.toml 接入 RouTix OpenAI 兼容网关。

推荐分组
【GPT】Plus分组
推荐模型
gpt-5.5
还没有登录?
去登录

一、安装 Node.js 环境

方法一:打开 https://nodejs.org/,下载 LTS 版本,双击安装包完成安装。

方法二:使用包管理器。

choco install nodejs
scoop install nodejs

验证安装:

node --version
npm --version

二、安装 Codex

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

验证安装:

codex --version

三、配置 Codex

打开 C:\Users\你的用户名\.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"

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

{
  "OPENAI_API_KEY": "sk-xxxxx"
}

四、开始使用

codex

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

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

五、常见问题

  • 启动时报 provider 错误:确认 model_provider = "routix" 和配置节名一致。
  • 请求失败但普通 OpenAI 客户端正常:确认 wire_api = "responses" 没写错。
  • 提示缺少 API Key:检查 auth.json 是否为合法 JSON,键名必须是 OPENAI_API_KEY。
  • 请求失败:先去控制台确认当前令牌能否使用 【GPT】Plus分组。
  • 模型不可用:把 model 改成你账户实际可用的 Codex 模型名。