快速部署 Codex + 中转 API（Windows）【 up8ai.com】

一、CLI 路径部署（通过终端）

此路径通过 Node.js 和 Codex CLI 工具实现。

1. 前置环境准备

• 安装 Node.js：访问 Node.js 官网 下载并安装 LTS 版本。安装后，在 PowerShell 或 CMD 中运行 node -v 和 npm -v 验证安装成功。
• 安装 Codex CLI：在终端中执行以下命令进行全局安装。

  npm install -g @openai/codex
  

2. 配置 up8ai.com 中转 API

Codex CLI 的核心配置是设置 base_url 和 api_key，以指向你的 up8ai.com 中转服务。

• 获取 API 密钥：
  1. 访问 up8ai.com 并注册/登录。
  2. 进入控制台或“API 密钥”管理页面，创建一个新的 API Key。
• 配置 Codex CLI：
  1. 运行 codex config 命令进入交互式配置。
  2. 或直接通过环境变量配置（推荐，更安全）：

     $env:CODEX_API_KEY="你在 up8ai.com 获取的 API密钥"
     $env:CODEX_BASE_URL="https://api.up8ai.com/v1" # up8ai.com 的标准 API 端点 # 然后运行 codex codex ```
     

  3. 若要永久配置，可将上述环境变量添加到系统环境变量，或创建 %USERPROFILE%\.codexrc 文件（内容为 JSON 格式）进行配置。

3. 使用测试

在终端中直接运行 codex 命令，即可启动交互式对话。若能正常收到回复，则 CLI 配置成功。

# 启动 Codex CLI 对话
codex
# 你也可以直接向它提问
codex "如何用Python读取一个JSON文件？"

二、GUI 路径部署（通过 CC-Switch 客户端）

此路径通过图形化客户端 CC-Switch 实现，无需命令行操作。

1. 下载并安装 CC-Switch

1. 访问 CC-Switch 的 GitHub Releases 页面。
2. 下载适用于 Windows 的安装包（如 .exe 文件）。
3. 运行安装程序完成安装。

2. 配置 up8ai.com 中转 API

1. 获取令牌：同样，在 up8ai.com 后台创建 API Key。
2. 在 CC-Switch 中配置：
   • 打开 CC-Switch 软件。
   • 找到设置或配置页面，填入以下信息：
     • API Key: 你在 up8ai.com 获取的 API 密钥。
     • API Base URL: https://api.up8ai.com/v1。
     • 模型：选择 up8ai.com 支持的模型（通常包括 gpt-4o、gpt-3.5-turbo、claude-3-5-sonnet 等，请以平台实际提供为准）。

3. 使用测试

在 CC-Switch 的聊天界面中直接发送消息，测试是否能正常接收回复。

三、双路径对比与选择

四、高级配置与故障排查（针对 up8ai.com）

• 使用官方 Codex Desktop App：作为更强大的 GUI 替代方案，可从 OpenAI 开发者页面 下载官方 Codex App。安装后，在设置中填入 up8ai.com 的 API Base URL和 API Key 即可使用。
• 配置多模型 Profile：对于 CLI，可以创建多个配置文件，快速切换不同的 API 端点或模型。

  codex --profile up8ai-gpt4 "你好"
  

  需要在配置文件（如 .codexrc）中预先定义 up8ai-gpt4 对应的 base_url (https://api.up8ai.com/v1) 和 api_key。
• 常见问题：
  • codex 命令未找到：确保 Node.js 和 npm install -g 安装正确，且 npm 全局路径已添加到系统 PATH 环境变量中。
  • API 请求失败：
    • 检查 base_url 是否为 https://api.up8ai.com/v1，api_key 是否正确。
    • 确认 up8ai.com 账户有充足的余额或套餐。
    • 检查调用的模型名称是否在 up8ai.com 支持列表中。
    • 检查网络连接，确保可以访问 api.up8ai.com。
  • 响应慢或超时：可尝试在 up8ai.com 控制台查看节点状态或切换可用区域（如果服务提供此功能）。