Codex Linux

Codex Linux 使用教程。

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

(一) 安装 Node.js 环境

方法一：NodeSource

1curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
2sudo apt-get install -y nodejs

方法二：系统包管理器

1sudo apt update
2sudo apt install nodejs npm

验证安装：

1node --version
2npm --version

(二) 安装 Codex

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

如果你遇到权限问题：

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

验证安装：

1codex --version

(三) 配置 Codex

编辑 ~/.codex/config.toml：

 1disable_response_storage = true
 2model = "gpt-5.4"
 3model_reasoning_effort = "high"
 4model_provider = "4router"
 5
 6[model_providers.4router]
 7name = "4Router"
 8base_url = "https://4router.net/v1"
 9env_key = "4ROUTER_API_KEY"
10wire_api = "responses"

然后把 Key 写进 shell：

1echo 'export 4ROUTER_API_KEY="sk-REPLACE_ME"' >> ~/.bashrc
2source ~/.bashrc

如果你用的是 zsh，写到 ~/.zshrc 即可。

(四) 开始使用 Codex

1codex

最小测试示例：

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

(五) 常见问题

codex 命令不存在：检查 npm 全局安装目录是否在 PATH 中。
API 连接失败：先执行 echo $4ROUTER_API_KEY，确认环境变量真的生效。
请求失败：先去控制台确认当前令牌能否使用 AppCodex 分组。
模型不可用：把配置里的模型换成你当前账户可用的 Codex 模型。