Claude API Key 配置教程 2026：手把手教你获取和设置 API 密钥 | TeamoRouter

快速回答

2026 年获取 Claude API Key 有两条路径：直接从 Anthropic 官方控制台获取（需要国际信用卡和手机验证），或通过统一网关 TeamoRouter 获取（支持支付宝/微信，无需海外支付）。拿到 Key 后，通过 ANTHROPIC_API_KEY 环境变量设置，在 Claude Code 中配置，并启用 Prompt Caching 来控制成本。本教程手把手带你走完每一步。

为什么 API Key 的配置至关重要

API Key 是授权每一次 Claude 请求的唯一凭证。你如何获取它、如何配置它，直接影响：

• 可得性： 你能用现有的支付方式获取 Key 吗？
• 成本： 你的供应商是否保持 Prompt Caching 正常运作？还是缓存悄悄失效，让账单暴涨 10 倍？
• 安全性： Key 存储安全吗？还是被硬编码在公开仓库里？
• 灵活性： 一个 Key 能同时用于 Claude Code、你自己写的脚本和各种第三方工具吗？

配置得当的 API Key 帮你省钱、避免安全事故、确保持续稳定的访问。配置不当则恰恰相反。以下是正确做法。

路径一：直接从 Anthropic 获取 Key

这是官方路径。在 Anthropic 运营的地区均可使用，但需要国际支付方式，且部分地区可能需要 VPN 才能访问。

操作步骤

1. 创建 Anthropic 账户。 访问 console.anthropic.com，使用邮箱注册。需要验证手机号码。

2. 进入 API Keys 页面。 登录后，点击左侧边栏的 "API Keys"，然后点击 "Create Key"。

3. 为 Key 命名。 建议使用描述性名称，如 my-dev-machine 或 production-server-1，方便后续识别和管理。

4. 立即复制 Key。 Anthropic 只在创建时显示完整 Key 一次。立即复制并妥善保存。Key 以 sk-ant- 开头。

5. 添加支付方式。 进入 Billing > Payment Methods，添加国际信用卡。截至 2026 年，Anthropic 接受 Visa、Mastercard 和 American Express。多数国内银行发行的卡不被接受。

6. 充值。 Anthropic 采用预付费模式，需先充值才能发起 API 调用。

直接路径的局限

• 需要国际信用卡。
• 控制台从国内访问可能较慢或被屏蔽，需 VPN。
• API 端点（api.anthropic.com）在国内可能不稳定。
• 只能访问 Claude 模型，无法访问 GPT、Gemini 等。

路径二：通过 TeamoRouter 获取 Key（推荐大多数用户使用）

TeamoRouter 是 LLM 统一网关，一个 API Key 即可访问 Claude、GPT、Gemini、DeepSeek 等全系列模型。支持支付宝、微信和银行转账，端点在国内可直接访问。网关功能详情见 TeamoRouter AI API 网关。

操作步骤

1. 创建 TeamoRouter 账户。 访问 teamorouter.com，使用邮箱或手机号注册。

2. 进入 API Key 页面。 登录后，在控制台侧边栏找到 "API Keys"。

3. 生成新 Key。 点击 "创建 Key"，命名后复制。TeamoRouter Key 以 tr- 开头。

4. 充值。 进入计费页面，通过支付宝、微信支付或银行转账充值。无需国际信用卡。

5. 记录 Base URL。 控制台会显示你的个人 API 端点，Anthropic 兼容接口通常为 https://api.teamorouter.com/anthropic。

6. 开始使用。 TeamoRouter Key 可作为 Anthropic API Key 的无缝替代。只需在客户端中更换 base_url 和 api_key 即可。

设置环境变量

拿到 API Key 后，标准做法是通过环境变量让各类工具读取。

Linux / macOS

将以下内容添加到你的 Shell 配置文件（~/.zshrc、~/.bashrc 或 ~/.bash_profile）：

# 直接对接 Anthropic
export ANTHROPIC_API_KEY="sk-ant-your-key-here"

# TeamoRouter 配置（推荐）
export ANTHROPIC_BASE_URL="https://api.teamorouter.com/anthropic"
export ANTHROPIC_API_KEY="tr-your-key-here"

编辑后重新加载 Shell：

source ~/.zshrc   # 或 ~/.bashrc

Windows（PowerShell）

# 为当前会话设置
$env:ANTHROPIC_API_KEY = "tr-your-key-here"

# 永久设置（以管理员身份运行）
[System.Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'tr-your-key-here', 'User')

Windows（命令提示符）

setx ANTHROPIC_API_KEY "tr-your-key-here"

使用 .env 文件

对于项目专属的 Key，可在项目根目录创建 .env 文件：

# .env
ANTHROPIC_BASE_URL="https://api.teamorouter.com/anthropic"
ANTHROPIC_API_KEY="tr-your-key-here"

然后在应用中加载。Python 示例：

from dotenv import load_dotenv
import os

load_dotenv()
api_key = os.getenv("ANTHROPIC_API_KEY")

务必把 .env 加入 .gitignore：

echo ".env" >> .gitignore

在 Claude Code 中配置 API Key

Claude Code 会自动读取 ANTHROPIC_API_KEY 和 ANTHROPIC_BASE_URL 环境变量。以下是不同场景的配置方式：

直接对接 Anthropic

export ANTHROPIC_API_KEY="sk-ant-your-key-here"
claude

TeamoRouter 配置（一个 Key 同时用于 Claude Code + Codex 等）

export ANTHROPIC_BASE_URL="https://api.teamorouter.com/anthropic"
export ANTHROPIC_API_KEY="tr-your-key-here"
claude

使用 Claude Code 设置文件

也可以通过 ~/.claude/settings.json 配置文件设置：

{
  "apiKey": "tr-your-key-here",
  "baseURL": "https://api.teamorouter.com/anthropic",
  "model": "claude-sonnet-4-20250514"
}

使用设置文件的优势在于：配置仅对 Claude Code 生效，不会泄漏到其他同样读取 ANTHROPIC_API_KEY 的工具。

验证配置

发送一次快速测试来确认配置正确：

claude -p "回复'连接成功'确认你正在运行。"

如果 Claude Code 正常回复，说明 API Key 配置正确。如果出现认证错误，请检查 Key 是否正确设置以及 Base URL 是否可达。

安全最佳实践

API Key 是一种 Bearer Token：任何人拿到它就能使用你的账户、花你的余额。以下实践能确保 Key 安全。

1. 绝不硬编码 Key

不要把 API Key 直接写在源代码中。一次 git push 到公开仓库就能暴露你的 Key。

# 错误：硬编码 Key
client = anthropic.Anthropic(api_key="sk-ant-abc123")

# 正确：从环境变量读取
client = anthropic.Anthropic(api_key=os.getenv("ANTHROPIC_API_KEY"))

2. 分项目使用独立 Key

如果使用 TeamoRouter，建议为不同项目创建不同的 API Key。这样一旦某个 Key 泄漏，影响范围有限。TeamoRouter 后台支持创建无限数量的 Key，并为每个 Key 单独设置消费限额。

3. 定期轮换 Key

每 30-90 天重新生成 API Key。轮换时，先创建新 Key，更新配置，验证正常工作，然后再吊销旧 Key。

4. 设置消费限额

Anthropic 和 TeamoRouter 都支持消费上限设置。根据预算配置月度限额，防止意外账单。TeamoRouter 还支持按 Key 粒度设置限额，比如可以将开发环境 Key 限制在 $50/月，生产环境 Key 限制在 $500/月。

5. 使用环境变量或密钥管理器

生产环境建议使用专业的密钥管理器（AWS Secrets Manager、HashiCorp Vault、GitHub Secrets 或你的云平台等价服务），而不是环境变量。环境变量可能通过进程列表或错误日志泄露。

6. 监控使用量

定期检查 API 使用量面板。异常激增可能意味着 Key 泄漏或 Agent 配置错误导致死循环。TeamoRouter 后台提供实时用量图表，支持按模型和 Key 细分查看。

Key 配置方案对比

一个 Key 配置多个工具

使用 TeamoRouter 最大的好处之一是一个 API Key 通用于多个工具。以下是各工具的配置方式：

# 共享 Key
export TR_KEY="tr-your-key-here"

# Claude Code（Anthropic 协议）
export ANTHROPIC_BASE_URL="https://api.teamorouter.com/anthropic"
export ANTHROPIC_API_KEY="$TR_KEY"

# Codex（OpenAI 协议）
export OPENAI_BASE_URL="https://api.teamorouter.com/openai"
export OPENAI_API_KEY="$TR_KEY"

# Gemini CLI（Google 协议）
export GOOGLE_API_KEY="$TR_KEY"
# （在 Gemini CLI 设置中配置 base URL）

# 通用 OpenAI 兼容工具
export OPENAI_API_KEY="$TR_KEY"
export OPENAI_BASE_URL="https://api.teamorouter.com/openai"

这意味着你只需维护一个 Key、一个余额和一个账单后台，即可管理所有 AI 工具。

常见问题（FAQ）

国内用户如何获取 Claude API Key？

最便捷的方式是通过 TeamoRouter。在 teamorouter.com 注册，用支付宝或微信充值，生成 Key 后即刻可用。无需国际信用卡，也无需 VPN。如果坚持走 Anthropic 官方路径，你需要 VPN 访问 console.anthropic.com 以及国际信用卡支付。

同一个 API Key 可以用于 Claude Code 和我的 Python 脚本吗？

可以。一个 API Key 适用于所有客户端和工具。使用 TeamoRouter 的话，同一个 Key 还能同时访问 GPT、Gemini 等模型。只需在环境变量中设置一次，所有工具自动读取。

API Key 泄漏了怎么办？

立即登录后台（Anthropic 控制台或 TeamoRouter），吊销泄漏的 Key。生成新 Key 并更新配置。如果 Key 曾出现在公开的 GitHub 仓库中，即使你删除了提交记录也应按已泄漏处理——机器人会在数秒内扫描公开仓库中的 API Key。立即轮换 Key 并检查使用历史中是否有未授权消费。

如何让 Claude Code 使用自定义 API 端点？

设置 ANTHROPIC_BASE_URL 环境变量为你的自定义端点，或在 ~/.claude/settings.json 中添加 baseURL 字段。通过这种方式即可将 Claude Code 指向 TeamoRouter 或任何其他 Anthropic 兼容网关。

把 API Key 存在 .env 文件中安全吗？

安全，前提是你将 .env 加入了 .gitignore，并且从不提交到版本控制。本地开发中，.env 文件是标准的、被广泛接受的做法。但对于生产应用，建议使用专业的密钥管理器。

API Key 应该多久轮换一次？

基线是每 30-90 天轮换一次。如果怀疑泄漏、有团队成员离职、或意外暴露（如截屏、屏幕共享时出现），应立即轮换。

可以为不同的 API Key 设置不同的消费限额吗？

使用 TeamoRouter 可以。后台支持创建多个 Key 并分别为每个 Key 设置月度消费上限。Anthropic 官方目前不支持按 Key 粒度的限额，限制是账户级别的。