返回使用文档

Codex / Mac

Codex Mac 使用教程

在 macOS 上安装 Codex,并写入 RouTix provider 配置。

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

一、安装 Node.js 环境

方法一:Homebrew。

brew install node

方法二:打开 https://nodejs.org/,下载 LTS 安装包并按默认选项安装。

验证安装:

node --version
npm --version

二、安装 Codex

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

验证安装:

codex --version

三、配置 Codex

编辑 ~/.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"
}

如果目录或文件不存在,先创建:

mkdir -p ~/.codex
touch ~/.codex/auth.json

四、开始使用

codex

第一次建议先跑一个最短任务:

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

五、常见问题

  • 配置改了没生效:确认 ~/.codex/auth.json 中的 Key 已经保存,并重新打开 Terminal。
  • 一直提示 provider 配置错误:确认 config.toml 没写成别的节名。
  • 提示找不到 API Key:检查 auth.json 是否为合法 JSON,键名必须是 OPENAI_API_KEY。
  • 请求失败:先去控制台确认当前令牌能否使用 【GPT】Plus分组。
  • 模型不可用:把 model 改成你账户实际可用的 Codex 模型名。