文档索引

在此获取完整文档索引：https://code.claude.com/docs/llms.txt 使用此文件发现所有可用页面，然后再进一步探索。

LLM 网关配置

了解如何配置 Claude Code 以与 LLM 网关解决方案配合使用。涵盖网关要求、认证配置、模型选择和特定提供商的端点设置。

LLM 网关在 Claude Code 和模型提供商之间提供集中的代理层，通常提供：

• 集中认证 - API 密钥管理的单点
• 使用跟踪 - 跨团队和项目监控使用情况
• 成本控制 - 实施预算和速率限制
• 审计日志 - 跟踪所有模型交互以满足合规要求
• 模型路由 - 无需代码更改即可在提供商之间切换

网关要求

要使 LLM 网关与 Claude Code 配合使用，它必须满足以下要求：

API 格式

网关必须向客户端公开以下 API 格式之一：

1. Anthropic Messages：/v1/messages、/v1/messages/count_tokens

   • 必须转发请求头：anthropic-beta、anthropic-version

2. Bedrock InvokeModel：/invoke、/invoke-with-response-stream

   • 必须保留请求体字段：anthropic_beta、anthropic_version

3. Vertex rawPredict：:rawPredict、:streamRawPredict、/count-tokens:rawPredict

   • 必须转发请求头：anthropic-beta、anthropic-version

未能转发请求头或保留请求体字段可能导致功能减少或无法使用 Claude Code 功能。

请求头

Claude Code 在 API 请求中包含以下请求头：

两个智能体 ID 头都是每次生成的临时标识符，不是持久的用户或设备 ID。

Claude Code 还在系统提示前添加一个简短的归因块，包含客户端版本和从对话派生的指纹。Anthropic API 在处理前会剥离此块，因此它不会影响第一方提示缓存。如果您的网关实现了基于完整请求体的自己的提示缓存，请设置 CLAUDE_CODE_ATTRIBUTION_HEADER=0 以省略它。

配置

模型选择

默认情况下，Claude Code 使用所选 API 格式的标准模型名称。

当 ANTHROPIC_BASE_URL 指向公开 Anthropic Messages 格式的网关时，Claude Code 可以在启动时查询网关的 /v1/models 端点，并将返回的模型添加到 /model 选择器中。设置 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1 以启用此功能。发现默认关闭，以便由共享 API 密钥支持的网关不会向每个用户显示该密钥可以访问的所有模型。每个发现的条目标记为"From gateway"，并在提供时使用响应中的 display_name 字段。这需要 Claude Code v2.1.129 或更高版本。

发现仅适用于 Anthropic Messages 格式。它不会为 Bedrock 或 Vertex 直通端点运行，也不会在 ANTHROPIC_BASE_URL 未设置或指向 api.anthropic.com 时运行。

发现请求使用与推理请求相同的认证方式：它发送 ANTHROPIC_AUTH_TOKEN 作为 Bearer 令牌，或在未设置 auth token 时发送 ANTHROPIC_API_KEY 作为 x-api-key 头，以及来自 ANTHROPIC_CUSTOM_HEADERS 的任何头。仅 ID 以 claude 或 anthropic 开头的模型会被添加到选择器中。结果缓存到 ~/.claude/cache/gateway-models.json 并在每次启动时刷新。如果请求失败或网关未实现 /v1/models，选择器会回退到上次启动的缓存列表或内置模型列表。

如果您的网关使用与发现过滤器不匹配的模型名称，请使用模型配置中记录的环境变量手动添加它们。

LiteLLM 配置

前提条件

• Claude Code 更新到最新版本
• LiteLLM Proxy Server 已部署且可访问
• 通过您选择的提供商访问 Claude 模型

基本 LiteLLM 设置

配置 Claude Code：

认证方法

静态 API 密钥

使用固定 API 密钥的最简单方法：

# 在环境中设置
export ANTHROPIC_AUTH_TOKEN=sk-litellm-static-key

# 或在 Claude Code 设置中
{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-litellm-static-key"
  }
}

此值将作为 Authorization 头发送。

使用助手的动态 API 密钥

用于轮换密钥或每用户认证：

1. 创建 API 密钥助手脚本：

#!/bin/bash
# ~/bin/get-litellm-key.sh

# Example: Fetch key from vault
vault kv get -field=api_key secret/litellm/claude-code

# Example: Generate JWT token
jwt encode \
  --secret="${JWT_SECRET}" \
  --exp="+1h" \
  '{"user":"'${USER}'","team":"engineering"}'

2. 配置 Claude Code 设置以使用助手：

{
  "apiKeyHelper": "~/bin/get-litellm-key.sh"
}

3. 设置令牌刷新间隔：

# 每小时刷新（3600000 毫秒）
export CLAUDE_CODE_API_KEY_HELPER_TTL_MS=3600000

此值将作为 Authorization 和 X-Api-Key 头发送。apiKeyHelper 的优先级低于 ANTHROPIC_AUTH_TOKEN 或 ANTHROPIC_API_KEY。

统一端点（推荐）

使用 LiteLLM 的 Anthropic 格式端点：

export ANTHROPIC_BASE_URL=https://litellm-server:4000

统一端点相比直通端点的优势：

• 负载均衡
• 故障转移
• 对成本跟踪和最终用户跟踪的一致支持

特定提供商的直通端点（替代方案）

通过 LiteLLM 的 Claude API

使用直通端点：

export ANTHROPIC_BASE_URL=https://litellm-server:4000/anthropic

通过 LiteLLM 的 Amazon Bedrock

使用直通端点：

export ANTHROPIC_BEDROCK_BASE_URL=https://litellm-server:4000/bedrock
export CLAUDE_CODE_SKIP_BEDROCK_AUTH=1
export CLAUDE_CODE_USE_BEDROCK=1

通过 LiteLLM 的 Google Vertex AI

使用直通端点：

export ANTHROPIC_VERTEX_BASE_URL=https://litellm-server:4000/vertex_ai/v1
export ANTHROPIC_VERTEX_PROJECT_ID=your-gcp-project-id
export CLAUDE_CODE_SKIP_VERTEX_AUTH=1
export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=us-east5

通过网关的 AWS 上的 Claude Platform

路由到转发到 AWS 上的 Claude Platform 端点的网关：

export ANTHROPIC_AWS_BASE_URL=https://litellm-server:4000/anthropic-aws
export ANTHROPIC_AWS_WORKSPACE_ID=wrkspc_01ABCDEFGHIJKLMN
export CLAUDE_CODE_SKIP_ANTHROPIC_AWS_AUTH=1
export CLAUDE_CODE_USE_ANTHROPIC_AWS=1

有关更详细的信息，请参阅 LiteLLM 文档。

其他资源

• LiteLLM 文档
• Claude Code 设置
• 企业网络配置
• 第三方集成概述