Codex CLI Guide

OpenAI Codex CLI 通过 cc-switch 接入 GPT-5.5 中转站

本文介绍如何使用 OpenAI Codex CLI,通过 cc-switch 接入 https://claude.yunjunet.cn/v1,模型固定使用 gpt-5.5。适用于 Windows、macOS 和 Linux。

Base URLhttps://claude.yunjunet.cn/v1
模型gpt-5.5
安装包drive.weixin.qq.com

一、准备内容

开始前请准备以下内容:

推荐先购买或创建一个测试用 API Key,跑通一次 Codex CLI 调用后,再用于日常开发任务。

二、获取 API Key

打开 https://claude.yunjunet.cn/,点击 APIKey购买,选择额度并填写接收邮箱。支付成功后,系统会把完整 API Key、到账额度和接入方式发送到邮箱。

API Key 示例:sk-xxxxxxxxxxxxxxxxxxxxxxxx

三、安装 OpenAI Codex CLI

下载 Codex CLI 安装包后按系统提示安装。安装完成后,在终端执行:

codex --version

如果能看到版本号,说明安装成功。如果提示找不到 codex 命令,请把 Codex CLI 的安装目录加入系统环境变量 PATH

四、通过 cc-switch 新增 GPT-5.5 中转站

打开 cc-switch,新增一个自定义 OpenAI 兼容服务,推荐按下面内容填写:

名称:GPT-5.5中转站
Provider ID:gpt55
Base URL:https://claude.yunjunet.cn/v1
API Key:你的 sk-... API Key
模型:gpt-5.5
协议:OpenAI Compatible / Responses

五、手动配置 Codex CLI(可选)

如果需要手动确认 Codex CLI 配置,可以编辑配置文件。Windows 常见路径为 C:\Users\你的用户名\.codex\config.toml,macOS / Linux 常见路径为 ~/.codex/config.toml

model = "gpt-5.5"
model_provider = "gpt55"

[model_providers.gpt55]
name = "gpt55"
base_url = "https://claude.yunjunet.cn/v1"
wire_api = "responses"
env_key = "OPENAI_API_KEY"

六、设置环境变量

OPENAI_API_KEY 设置为你的完整 API Key。

# Windows PowerShell
$env:OPENAI_API_KEY="你的 sk-... API Key"

# macOS / Linux
export OPENAI_API_KEY="你的 sk-... API Key"

七、测试 Codex CLI 是否可用

在终端执行 codex,然后输入一个简单任务,例如让它生成 Python hello world。只要能正常返回代码,就说明已经通过 cc-switch 接入成功。

codex

# 示例任务
帮我写一个 Python hello world

八、额度查询与请求日志

打开首页 https://claude.yunjunet.cn/,在 额度查询 输入 API Key 可以查看剩余额度;在 请求日志 输入 API Key 可以查看最近 24 小时调用记录。

九、常见问题

配置检查:

  • API Key 必须完整复制,并以 sk- 开头。
  • Base URL 必须填写 https://claude.yunjunet.cn/v1,不要填写 https://claude.yunjunet.cn/api
  • 模型名必须填写 gpt-5.5;当前中转站只启用 GPT-5.5。
  • Codex CLI 使用 Responses API,wire_api 建议保持 responses
  • 如果提示余额不足,请到首页额度查询确认剩余额度,或重新购买充值。