Skip to content

Claude Code 接入

Claude Code 可以通过 Anthropic 兼容接口接入优芯中转站。核心配置是把 Anthropic Base URL 指向优芯,并使用优芯 API Key。

配置环境变量

在终端中设置:

bash
export ANTHROPIC_BASE_URL="https://api.yucpu.com"
export ANTHROPIC_API_KEY="sk-your-api-key"

然后启动 Claude Code。

如果你的 Claude Code 版本或封装工具要求完整接口地址,请使用:

text
https://api.yucpu.com/v1/messages

但多数 Anthropic 兼容客户端会自动拼接 /v1/messages,这种情况下 Base URL 只需要 https://api.yucpu.com

推荐流程

  1. 在 API Hub 创建独立的 Claude Code 专用 Key。
  2. 选择支持 Claude / Anthropic 兼容入口的分组。
  3. 设置 ANTHROPIC_BASE_URLANTHROPIC_API_KEY
  4. 发起一次简单请求。
  5. 到 API Hub 的 用量明细 确认请求记录。

用 curl 先验证

在配置 Claude Code 前,可以先用 curl 验证 Key 和模型是否可用:

bash
curl https://api.yucpu.com/v1/messages \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-5",
    "max_tokens": 128,
    "messages": [
      { "role": "user", "content": "回复 pong" }
    ]
  }'

如果 curl 成功,但 Claude Code 失败,说明问题更可能在 Claude Code 本地配置、代理或版本兼容上。

只允许 Claude Code 的分组

部分分组可能限制为 Claude Code / /v1/messages 使用。如果你用 OpenAI Responses 或 Chat Completions 请求这类分组,可能会看到类似:

text
This group is restricted to Claude Code clients (/v1/messages only)

这种情况下,请改用 /v1/messages 入口,或者切换到支持 OpenAI 兼容入口的分组。

优芯用户平台使用文档