网关与协议

Claude Code 可以通过 ANTHROPIC_BASE_URL 接入 LLM gateway。Passion8 就属于这类 Claude Code 入口:本地 CLI 仍按 Anthropic Messages 格式发请求,网关负责转发、鉴权、模型路由、计费和观测。

如果你只是配置客户端,看本页和 Provider 认证与云平台接入。如果你要实现或验收网关,看 Gateway 协议上线清单。

#最小接入

export ANTHROPIC_BASE_URL="https://passion8.cc"
export ANTHROPIC_AUTH_TOKEN="sk-你的 Passion8 API Key"
claude -p "只回答 ok"

Windows PowerShell:

$env:ANTHROPIC_BASE_URL = "https://passion8.cc"
$env:ANTHROPIC_AUTH_TOKEN = "sk-你的 Passion8 API Key"
claude -p "只回答 ok"

推荐把 Key 放在用户级 settings 或本机环境变量,不要提交到项目仓库:

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://passion8.cc",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的 Passion8 API Key"
  }
}

#请求格式

Claude Code 对 ANTHROPIC_BASE_URL 使用 Anthropic Messages 格式:

如果网关把 Anthropic Messages 请求转到 Bedrock、Vertex 或其他 schema,转换是网关责任。客户端不要把 Claude Code 的 Base URL 写成 OpenAI /v1。

#必须透传的内容

官方协议强调 gateway 不应该用固定白名单剥字段。Claude Code 的能力会随版本增加,字段和 beta header 会变。

#Attribution block 与缓存

Claude Code 会在 system prompt 前放一个 attribution block。直接发到 Anthropic API 时,官方 endpoint 会在位置正确时剥掉它,避免影响 first-party prompt cache。

自定义网关要注意:

官方说明从 Claude Code v2.1.181 起,自定义 Base URL 下 attribution block 在一个 conversation 生命周期内更稳定,对 gateway-side full body cache 更友好。旧版本如果网关自己按请求体做缓存,可能需要禁用 attribution header。

#Prompt Cache 与 Passion8

Passion8 下排查缓存,看三层:

usage 字段:

读写比越高,缓存越健康。如果每轮 creation 都高,优先检查模型、effort、fast mode、MCP 工具定义、插件 MCP、整工具 deny 和 /compact。

#模型发现

如果网关实现 /v1/models,Claude Code 可以把网关返回模型加入 /model picker。

启用:

export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1

注意:

#常见错误

#企业配置

企业/团队可以用:

apiKeyHelper 输出通常会缓存一段时间。官方示例可以用 CLAUDE_CODE_API_KEY_HELPER_TTL_MS 调整缓存时长。

如果要自托管 Claude apps gateway 或运维通用 Anthropic-compatible gateway,继续看 Gateway 运维 和 Claude apps gateway 部署。那里单独展开 OIDC、Postgres、spend limits、模型发现、协议透传和 1 小时缓存 TTL 的网关边界。

#Passion8 建议清单

1. Base URL 写 https://passion8.cc,不要 /v1。
2. 用 ANTHROPIC_AUTH_TOKEN,不要混用多个认证变量。
3. 长任务开局先定 /model、/effort、是否 /fast。
4. 如果 MCP 多,优先确认 tool search 和 deferred tools。
5. 如果 cache read 一直为 0,先用无 MCP、固定模型、固定 effort 的长会话复测。
6. 如果模型不在 picker,先确认后台实际模型 ID,再考虑 gateway model discovery。
7. 如果 Remote Control 或 voice dictation 不可用,先暂时移除 gateway 变量确认边界。

#官方参考

• Run Claude Code through a gateway
• Gateway protocol reference
• Connect Claude Code to an LLM gateway
• Other LLM gateways
• Prompt caching
• Environment variables
• Feature availability

#相关页面