Codex

Codex 是 OpenAI 推出的终端 AI 编程助手，可通过 SilvaMux Coding Plan 接入。

前置准备

1. 购买订阅：在订阅页选择 Lite / Pro / Max 档位与月付/季付/年付周期，购买 Coding Plan 个人版；支付成功后订阅立即生效。
2. 创建订阅 API Key：进入控制台 → Coding Plan → API Keys，点击创建，并立即复制以 cp_live_ 开头的完整 Key。
3. 确认端点与协议：Base URL 为 https://www.silvamux.com/api/coding-plan/v1，兼容 OpenAI 与 Anthropic 两种协议；各端点字段详情见端点与协议。

购买套餐、创建 Key 与验证调用的完整流程见快速接入。

安装 Codex

1. 安装或更新 Node.js（v18.0 或更高版本）。
2. 在终端中执行以下命令安装 Codex。

npm install -g @openai/codex

运行以下命令验证安装。

codex --version

若当前版本不再支持 wire_api = "chat"，可安装支持该配置的版本（如 0.80.0）：

npm install -g @openai/codex@0.80.0

配置接入凭证

编辑配置文件 ~/.codex/config.toml，将 model 替换为 Coding Plan 支持的模型：

model_provider = "silvamux_coding_plan"
model = "deepseek-v4-pro"

[model_providers.silvamux_coding_plan]
name = "SilvaMux Coding Plan"
base_url = "https://www.silvamux.com/api/coding-plan/v1"
env_key = "OPENAI_API_KEY"
wire_api = "chat"

可用模型以 GET /api/coding-plan/v1/models 与模型广场为准。

配置环境变量

将环境变量 OPENAI_API_KEY 设置为你的 cp_live_ Key。

macOS

zsh：

echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.zshrc
source ~/.zshrc

bash：

echo 'export OPENAI_API_KEY="YOUR_API_KEY"' >> ~/.bash_profile
source ~/.bash_profile

Windows

CMD：

setx OPENAI_API_KEY "YOUR_API_KEY"

PowerShell：

[Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "YOUR_API_KEY", [EnvironmentVariableTarget]::User)

设置后打开新的终端窗口，用 echo $OPENAI_API_KEY（Windows CMD 用 echo %OPENAI_API_KEY%）确认已生效。

使用 Codex

新建一个终端，执行以下命令进入 Codex 并开始对话：

codex

常见问题

报错 wire_api 配置问题

• wire_api = "chat" is no longer supported：当前 Codex 版本不再支持 chat 协议，请安装支持它的版本（如 0.80.0）。
• unknown configuration field wire_api：从 config.toml 的对应 provider 节中删除 wire_api 字段。

报错 401 Unauthorized

• 确认使用的是 Coding Plan 的 cp_live_ Key，而非常规 sk_live_ Key。
• 确认订阅未过期，并重新完整复制 Key（避免多余空格）。

报错 404 Not Found

检查 config.toml 中的 base_url 是否为 https://www.silvamux.com/api/coding-plan/v1，且 wire_api 与所用 Codex 版本匹配。

报错 429

订阅额度任一窗口耗尽会返回 429 QUOTA_EXCEEDED（错误信息会标明 5h / weekly / monthly）。等待窗口恢复，或在控制台查看剩余额度。