接入 Claude Code

Claude Code 走的是 Anthropic 原生协议,接入只用设两个环境变量。

安装(如果还没装)

npm install -g @anthropic-ai/claude-code

或者按官方安装方式来,版本不重要 —— 1.x 起的全部能用。

配置环境变量

把下面两行写进你的 shell 配置文件(.zshrc / .bashrc / .config/fish/config.fish):

export ANTHROPIC_BASE_URL="https://aiuv.ai"
export ANTHROPIC_AUTH_TOKEN="sk-YOUR_KEY"

注意:用的是 ANTHROPIC_AUTH_TOKEN 而不是 ANTHROPIC_API_KEY。 后者会让 SDK 走 x-api-key header,前者走 Authorization: Bearer, 两个 AIUV 都接,但 Bearer 形式更通用。

source 一下让变量生效:

source ~/.zshrc

跑起来

cd /your/project
claude

第一次会让你确认权限模式,后面就一直可以用。

选模型

Claude Code 默认用 claude-sonnet-4-5 这类官方模型 ID。AIUV 上的对应 ID 通常和上游一致;在 IDE 里:

> /model claude-opus-4-7

或开个新会话时加 -m:

claude -m claude-opus-4-7

控制台 → 模型 页能查到所有支持的 Anthropic 模型 ID。

Skills / Sub-agents 怎么办

完全不用动。Skills、Sub-agents、Hooks 这些 Claude Code 自己管理的功能, 通信走的还是 /v1/messages,AIUV 透传不动结构,所有功能保持原样。

验证

下面这条 cURL 等价于 Claude Code 启动后第一次拉模型列表:

curl https://aiuv.ai/v1/models \
  -H "Authorization: Bearer sk-YOUR_KEY"

返回 JSON 数组里有你要用的模型,就说明链路通了。

故障排查

• 401:echo $ANTHROPIC_AUTH_TOKEN 看看到底有没有,有时候是 shell 没 reload
• 404 模型不存在:AIUV 上没上线这个 model_name。控制台搜一下确认 ID
• 响应卡很久:Claude Code 流式默认是 SSE,如果你用了某些公司代理,代理可能 buffer 流。试试 unset HTTPS_PROXY
• ANTHROPIC_API_KEY 也设了:两个变量同时存在时 Claude Code 会优先用 ANTHROPIC_API_KEY,unset ANTHROPIC_API_KEY 一下