Codex CLI 接入

Codex 是 OpenAI 官方的命令行 AI 编程助手。接入 MoaCode 后走 /v1/responses 协议的 Codex 渠道（0.6× 倍率）。

一、安装 Node.js

• Windows：从 nodejs.org 下载 .msi 安装包，一路下一步（不要改路径）
• macOS / Linux：brew install node 或用 NVM（见 Claude Code 的说明）

验证：

node -v
npm -v

二、安装 Codex

npm install -g @openai/codex

# 验证
codex --version

输出 added N packages 表示新安装成功，changed N packages 表示已有版本被更新。

三、接入 MoaCode

方式一：一键配置（推荐）

登录 Dashboard，Quick setup 选择 Codex CLI，复制对应系统的命令运行：

Linux / macOS

curl -s https://moacode.org/setup-codex.sh | bash -s -- --url https://moacode.org --key 你的APIKey

Windows (PowerShell)

# Quick setup → Codex CLI → Copy Windows，粘贴到 PowerShell 运行

脚本会自动备份并写入下述两个配置文件。

方式二：手动配置

~/.codex/config.toml：

model_provider = "apirouter"
model = "gpt-5-codex"
model_reasoning_effort = "high"

[model_providers.apirouter]
name = "apirouter"
base_url = "https://moacode.org/v1"
wire_api = "responses"
requires_openai_auth = true
env_key = "APIROUTER_API_KEY"

~/.codex/auth.json：

{
  "OPENAI_API_KEY": "你的APIKey",
  "APIROUTER_API_KEY": "你的APIKey"
}

四、启动使用

cd 你的项目目录
codex

会话内可用 /model 切换模型。

渠道说明

渠道	倍率	说明
Codex Pro	0.6×	主力渠道，WSS 支持，Pro 账号池

渠道支持 OpenClaw、OpenCode 等第三方客户端（官方仅对 Codex CLI 提供支持）。

相关页面

• Codex 接入 VS Code — 扩展与 CLI 共用配置
• ChatGPT 桌面端接入 — 桌面应用复用 Codex CLI 配置
• cc-switch 配置 Codex — 图形化管理多供应商配置
• OpenClaw 接入 — 把 Codex 渠道的模型接进 OpenClaw
• 常见报错与排查