Codexplus 接入配置
Codexplus 是便宜稳定的高缓存中转。这里给出四套可直接复制的配置:Codex CLI、Claude Code、Hermes、生图接口,每段下面都有一条验证命令,跑通再往下走。
- Base URL(OpenAI 兼容)
https://codexplus.shop/v1- Base URL(Claude 协议)
https://codexplus.shop- API Key
- 控制台 → 令牌 → 新建,形如
sk-xxxxxxxx - 先验证连通
curl -s -o /dev/null -w "%{http_code}" -H "Authorization: Bearer $KEY" https://codexplus.shop/v1/models→200
01Codex CLI
写进 ~/.codex/config.toml,然后用环境变量放 Key。
model = "gpt-6.1-sol"
model_provider = "codexplus"
[model_providers.codexplus]
name = "Codexplus"
base_url = "https://codexplus.shop/v1"
env_key = "CODEXPLUS_API_KEY"
wire_api = "responses"export CODEXPLUS_API_KEY="sk-xxxxxxxx"
codex "ping"
base_url 必须带
/v1。写成 https://codexplus.shop 会让 Codex CLI 请求根路径下的 /responses,那里返回的是网页而不是 API 响应,症状是「解析失败」或「返回 HTML」。
如果某个分组对 responses 协议报错,把 wire_api 改成 "chat" 走 /v1/chat/completions。用独立的环境变量名(CODEXPLUS_API_KEY)而不是 OPENAI_API_KEY,可以避免和本机官方 Key 冲突。
02Claude Code
走 Anthropic 协议,只需三个环境变量。写成 shell 配置里的一行更省事。
export ANTHROPIC_BASE_URL="https://codexplus.shop"
export ANTHROPIC_AUTH_TOKEN="sk-xxxxxxxx"
export ANTHROPIC_MODEL="claude-opus-5"
export ANTHROPIC_SMALL_FAST_MODEL="claude-haiku-4-5-20251001"
claudeANTHROPIC_BASE_URL 这里不带 /v1——Claude Code 自己会拼 /v1/messages。写多了会变成 /v1/v1/messages 直接 404。
已知限制:
/v1/messages/count_tokens 未开放,客户端算不出精确的上下文占比,百分比显示可能偏差,不影响实际对话与工具调用。
03Hermes
用 custom provider 指向 Codexplus,Key 放 .env,配置里只存变量引用。
hermes config set model.provider custom
hermes config set model.base_url "https://codexplus.shop/v1"
hermes config set model.model "gpt-6.1-sol"
hermes config set model.api_key '${CODEXPLUS_API_KEY}'
echo 'CODEXPLUS_API_KEY=sk-xxxxxxxx' >> ~/.hermes/.env
hermes doctor挂成别名之后可以用 /model <名字> 直接切模型,不用改配置:
hermes config set model.aliases.opus custom/claude-opus-5
hermes config set model.aliases.astra custom/gpt-6-astra
hermes config set model.aliases.sol custom/gpt-6.1-sol
不要手改
config.yaml——一个缩进错位会让正在跑的会话直接断。一律用 hermes config set。
04生图接口
标准 /v1/images/generations,OpenAI 兼容。
curl https://codexplus.shop/v1/images/generations \
-H "Authorization: Bearer $CODEXPLUS_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"gpt-image-2","prompt":"赛博朋克猫,霓虹夜景","n":1,"size":"1024x1024"}'from openai import OpenAI
c = OpenAI(base_url="https://codexplus.shop/v1", api_key="sk-xxxxxxxx")
r = c.images.generate(model="gpt-image-2", prompt="赛博朋克猫,霓虹夜景", size="1024x1024")
print(r.data[0].b64_json[:32] if getattr(r.data[0], "b64_json", None) else r.data[0].url)| 模型 | 可用型号 |
|---|---|
| 生图 | gpt-image-2 · gpt-image-2.5 · gpt-image-2.6 · grok-imagine-image-lite 等 |
所有生图模型统一一个价,按效果需要选型号即可,不用比价。
05一键导入
主流客户端不用手填:在控制台令牌页点「使用密钥」,会带上你自己的 Key 生成导入链接。
| 客户端 | 导入方式 |
|---|---|
| Cherry Studio | 令牌页一键跳转,自动写入 provider 与 Key |
| AionUI | 同上,自动添加 provider |
| CC Switch | 内置配置模板,选 Codexplus 即可 |
| 流畅阅读 | 内置配置 |
06常见报错
| 现象 | 原因与处理 |
|---|---|
| 401 Unauthorized | Key 错或已失效;确认 Bearer 后面有一个空格 |
| 404 或返回 HTML | Base URL 少了 /v1(OpenAI 兼容场景),或多了 /v1(Claude Code 场景) |
| 模型不存在 | 模型名以控制台「模型广场」为准,部分名称带日期后缀 |
| 流式输出中途断开 | 本地网络或代理劫持了 SSE,换直连线路重试 |
| 想限制单个客户端的消耗 | 给每个客户端单独建令牌并设额度,出问题只影响那一个 |