CodeX (OpenAI) 配置指南

前置条件

• 已安装 Node.js（LTS 版本）
• 已在 api.3cm.me/console 获取 API Key
• 推荐使用 cc-switch 工具快速切换配置

---

CLI 方式使用

步骤 1：安装 CodeX CLI

npm install -g @openai/codex

步骤 2：使用 cc-switch 配置

推荐使用 cc-switch 工具来管理和切换 API 配置：

npm install -g cc-switch

运行 cc-switch 后按照提示配置：

• Base URL：https://api.3cm.me/v1
• API Key：填入你从 控制台 获取的 Key

cc-switch 会自动设置 OPENAI_API_KEY 和 OPENAI_BASE_URL 等环境变量。

步骤 3：手动配置（可选）

如不使用 cc-switch，也可以手动设置环境变量：

macOS / Linux：

export OPENAI_API_KEY="sk-你的Key"
export OPENAI_BASE_URL="https://api.3cm.me/v1"

Windows (PowerShell)：

$env:OPENAI_API_KEY = "sk-你的Key"
$env:OPENAI_BASE_URL = "https://api.3cm.me/v1"

步骤 4：启动 CodeX

codex

---

VS Code 插件方式

CodeX 也提供了 VS Code 插件，可在扩展商店搜索 OpenAI Codex 安装。

安装后在插件设置中配置：

• API Key：填入你的 Key
• Base URL：https://api.3cm.me/v1

---

常见问题

错误信息	原因	解决方案
401 Unauthorized	API Key 无效或已过期	前往 api.3cm.me/console 检查或重新生成 Key
404 Not Found	Base URL 配置错误或模型名称不正确	确认 Base URL 为 https://api.3cm.me/v1
429 Too Many Requests	请求频率超限或余额不足	稍后重试，或在 控制台 检查余额和用量
Network Error	网络连接失败	检查网络连接，确认可以访问 https://api.3cm.me
SSE streaming 异常	流式传输中断或代理干扰	检查是否有 VPN/代理拦截，尝试关闭后重试