手动连接 Codex 到 MonkeyAI

选择密钥与模型

从密钥管理取得密钥。当前模型列表确认 gpt-6.1-sol 可用于 Codex Pro 两类组、Codex Lite 与 GPT 官方直连组。Codex Pro（仅限Codex） 只允许 ChatGPT 桌面版和 Codex CLI，不能复用于脚本、Hermes、OpenClaw 或生图。需要外接时选择 Codex Pro（外接版）；Lite 支持外接但没有免费 Fast。价格见实时价格。

Windows、macOS、Linux 安装

先完成 Node.js。在 Windows PowerShell、macOS 或 Linux 终端手动执行：

Windows 若当前版本原生支持不完整，可在 WSL 内安装和配置；WSL 的主目录与 Windows 用户目录不同。Linux 遇权限错误时使用用户拥有的 npm 环境。

Windows

powershell
npm install -g @openai/codex@latest
codex --version

macOS

bash
npm install -g @openai/codex@latest
codex --version

Linux

bash
npm install -g @openai/codex@latest
codex --version

配置 Responses 提供商

先备份已有配置，再用文本编辑器合并以下最小配置，不要覆盖原有项目设置。macOS / Linux 文件为 ~/.codex/config.toml；Windows 为 %USERPROFILE%\.codex\config.toml。目录不存在时手动创建。

toml
model_provider = "monkeyai"
model = "gpt-6.1-sol"

[model_providers.monkeyai]
name = "MonkeyAI"
base_url = "https://monkeytheme.com/v1"
wire_api = "responses"
requires_openai_auth = false
env_key = "MONKEYAI_API_KEY"

认证使用环境变量，密钥不写入 TOML。此处为用户级配置。参见 官方配置参考。在启动 Codex 的同一终端私下输入密钥；以下输入不会回显，也不会将密钥字面值写入命令历史。关闭终端后需重新设置。

Windows

powershell
$env:MONKEYAI_API_KEY = [System.Net.NetworkCredential]::new("", (Read-Host "MonkeyAI API key" -AsSecureString)).Password

macOS

bash
read -r -s "MONKEYAI_API_KEY?MonkeyAI API key: "
export MONKEYAI_API_KEY

Linux

bash
read -r -s -p "MonkeyAI API key: " MONKEYAI_API_KEY
export MONKEYAI_API_KEY

启动与桌面端

进入要处理的项目目录运行 codex。先检查所选提供商和模型，阅读工具执行审批再继续。改配置后退出并重开已有会话。桌面客户端是否读取同一份配置取决于版本与运行环境；不要仅因 CLI 生效就认为桌面端已接通，需分别检查模型与错误信息。

验证与恢复

用户可在确认费用后询问一个简短问题验证。401 先查占位符和密钥；403 查组与客户端限制；model_not_found 查模型 ID；404 查是否误用 Chat Completions 或重复 /v1。失败时恢复备份，收集脱敏错误，不公开配置密钥。