Codex Mac

Codex Mac 使用教程。

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

(一) 安装 Node.js 环境

方法一：Homebrew

1brew install node

方法二：官网下载

  1. 打开 https://nodejs.org/
  2. 下载 LTS 安装包
  3. 按默认选项安装

验证安装：

1node --version
2npm --version

(二) 安装 Codex

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

验证安装：

1codex --version

(三) 配置 Codex

编辑 ~/.codex/config.toml：

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

再编辑 ~/.codex/auth.json，把 Key 写在这里（不需要环境变量）：

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

如果目录或文件不存在，先创建：

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

(四) 开始使用 Codex

1codex

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

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

(五) 常见问题

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