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"

claude

ANTHROPIC_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 UnauthorizedKey 错或已失效;确认 Bearer 后面有一个空格
404 或返回 HTMLBase URL 少了 /v1(OpenAI 兼容场景),或多了 /v1(Claude Code 场景)
模型不存在模型名以控制台「模型广场」为准,部分名称带日期后缀
流式输出中途断开本地网络或代理劫持了 SSE,换直连线路重试
想限制单个客户端的消耗给每个客户端单独建令牌并设额度,出问题只影响那一个