Claude Code

适合谁

适合在终端里工作、要让编码代理直接读写当前项目的人。Claude Code 走 Messages 协议，配置方式是环境变量，没有图形化的模型服务页。

三步配置

1. 填 Base URL

在终端里设置：

export ANTHROPIC_BASE_URL="https://sheverai.com/8811c8/api/llm"

这里填到 /api/llm 为止，不要带末尾的 /v1。Claude Code 会自己拼接 /v1/messages；带上 /v1 会变成 /v1/v1/messages。

2. 填 Key

export ANTHROPIC_AUTH_TOKEN="<你的 LokoSpace API Key>"

Key 在客户端「个人中心 → API 接入」创建。填 Key 本体，不要加 Bearer。如果环境里还留着旧的 ANTHROPIC_API_KEY，先执行 unset ANTHROPIC_API_KEY，避免客户端优先使用旧凭据。

3. 选模型

先从 /models 取模型名：

curl https://sheverai.com/8811c8/api/llm/v1/models \
  -H "Authorization: Bearer $LOKO_KEY"

再把返回的 id 填进环境变量：

export ANTHROPIC_MODEL="<从 /models 取到的 id>"

不要填在别处看到的模型名或展示名称。Claude Code 只接受 Messages 协议；如果这个模型只支持另一种协议，调用会返回 MODEL_PROTOCOL_MISMATCH，换一个模型即可。

缓存断点由网关自动注入，不需要手动加 cache_control；上游鉴权也由网关处理。

要长期生效，把这三行写进 ~/.zshrc（bash 用 ~/.bashrc），然后重新打开终端或执行 source。

此处放截图：终端里设置三个环境变量后，claude -p 返回「连接成功」。

验证是否接通

在一个测试目录里运行：

claude -p "只回复：连接成功"

终端输出「连接成功」即接通。进入交互界面后，也可以用 /model 确认当前模型是 /models 里的 id。

常见故障

现象	原因	处理
401，错误码 API_KEY_INVALID	ANTHROPIC_AUTH_TOKEN 没填、复制不完整、已撤销或过期；或旧的 ANTHROPIC_API_KEY 仍在生效	重新创建 Key；确认变量值没有多余空格，也没有 Bearer ；执行 unset ANTHROPIC_API_KEY 后重开终端
403，错误码 MODEL_ACCESS_DENIED；或 400，错误码 MODEL_PROTOCOL_MISMATCH	模型不存在、模型 ID 不是 /models 里的 id；账号没有该模型权限；或该模型不接受 Messages 协议	按 /models 原样重填；协议不匹配时换一个支持 Messages 的模型，不要改 Base URL 硬试
504，错误码 OFFICIAL_LLM_APPLICATION_TIMEOUT，或终端提示请求超时	首个响应慢、代理拦截流式连接、仓库上下文过长	先用 claude -p 的短提示验证；检查代理或 VPN；换一个响应更快的模型；仍不行就缩小当前项目范围再试

Claude Code 的长会话第一次请求可能较慢。不要因为一次超时就连续并发重试，先确认短提示能通。