Claude Code官方文档身份验证登录API Key

Claude Code 身份验证完全指南 - 个人 / 团队 / 组织登录方案

发布于 2025年5月1日 · 阅读约 10 分钟

Claude Code 支持多种身份验证方法，具体取决于您的设置。个人用户可以使用 Claude.ai 账户登录，而团队可以使用 Claude for Teams 或 Enterprise、Claude Console 或云提供商（如 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry）。

登录 Claude Code

安装 Claude Code 后，在终端中运行 claude。首次启动时，Claude Code 会打开浏览器窗口供您登录。

如果浏览器没有自动打开，请按 c 将登录 URL 复制到剪贴板，然后将其粘贴到浏览器中。

如果您的浏览器在您登录后显示登录代码而不是重定向回来，请将其粘贴到终端的 Paste code here if prompted 提示符处。这种情况在浏览器无法访问 Claude Code 的本地回调服务器时会发生，这在 WSL2、SSH 会话和容器中很常见。

您可以使用以下任何账户类型进行身份验证：

Claude Pro 或 Max 订阅：使用您的 Claude.ai 账户登录。在 claude.com/pricing 订阅。
Claude for Teams 或 Enterprise：使用您的团队管理员邀请您的 Claude.ai 账户登录。
Claude Console：使用您的 Console 凭证登录。您的管理员必须先邀请您。
云提供商：如果您的组织使用 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry，请在运行 claude 之前设置所需的环境变量。不需要浏览器登录。

要登出并重新身份验证，请在 Claude Code 提示符处输入 /logout。

如果您在登录时遇到问题，请参阅身份验证故障排除。

设置团队身份验证

对于团队和组织，您可以通过以下方式之一配置 Claude Code 访问：

Claude for Teams 或 Enterprise，推荐用于大多数团队
Claude Console
Amazon Bedrock
Google Vertex AI
Microsoft Foundry

Claude for Teams 或 Enterprise

Claude for Teams 和 Claude for Enterprise 为使用 Claude Code 的组织提供最佳体验。团队成员可以访问 Claude Code 和网络版 Claude，具有集中式计费和团队管理。

Claude for Teams：自助服务计划，具有协作功能、管理工具和计费管理。最适合较小的团队。
Claude for Enterprise：添加 SSO、域名捕获、基于角色的权限、合规性 API 和托管策略设置，用于组织范围的 Claude Code 配置。最适合具有安全和合规性要求的大型组织。

邀请团队成员

从管理员仪表板邀请团队成员。

安装并登录

团队成员安装 Claude Code 并使用其 Claude.ai 账户登录。

Claude Console 身份验证

对于偏好基于 API 的计费的组织，您可以通过 Claude Console 设置访问权限。

创建或使用 Console 账户

使用您现有的 Claude Console 账户或创建新账户。

添加用户

您可以通过以下任一方法添加用户：

从 Console 内批量邀请用户：Settings -> Members -> Invite
设置 SSO

分配角色

邀请用户时，分配以下角色之一：

Claude Code 角色：用户只能创建 Claude Code API 密钥
Developer 角色：用户可以创建任何类型的 API 密钥

用户完成设置

每个受邀用户需要：

接受 Console 邀请
检查系统要求
安装 Claude Code
使用 Console 账户凭证登录

云提供商身份验证

对于使用 Amazon Bedrock、Google Vertex AI 或 Microsoft Foundry 的团队：

遵循提供商设置

遵循 Bedrock 文档、Vertex 文档或 Microsoft Foundry 文档。

分发配置

将环境变量和生成云凭证的说明分发给您的用户。阅读有关如何在此处管理配置的更多信息。

安装 Claude Code

用户可以安装 Claude Code。

凭证管理

Claude Code 安全地管理您的身份验证凭证：

存储位置：
- 在 macOS 上，凭证存储在加密的 macOS Keychain 中。
- 在 Linux 上，凭证存储在 ~/.claude/.credentials.json 中，文件模式为 0600。
- 在 Windows 上，凭证存储在 %USERPROFILE%\.claude\.credentials.json 中，并继承您的用户配置文件目录的访问控制，默认情况下将文件限制为您的用户帐户。
- 如果您在 Linux 或 Windows 上设置了 CLAUDE_CONFIG_DIR 环境变量，.credentials.json 文件将位于该目录下。
- Claude Code 通过 /login 和 /logout 管理 .credentials.json。要通过自定义 API 端点路由请求，请改为设置 ANTHROPIC_BASE_URL 环境变量。
支持的身份验证类型：Claude.ai 凭证、Claude API 凭证、Azure Auth、Bedrock Auth 和 Vertex Auth。
自定义凭证脚本：apiKeyHelper 设置可以配置为运行返回 API 密钥的 shell 脚本。
刷新间隔：默认情况下，apiKeyHelper 在 5 分钟后或在 HTTP 401 响应时调用。设置 CLAUDE_CODE_API_KEY_HELPER_TTL_MS 环境变量以获得自定义刷新间隔。
缓慢助手通知：如果 apiKeyHelper 返回密钥需要超过 10 秒，Claude Code 会在提示栏中显示警告通知，显示经过的时间。如果您经常看到此通知，请检查您的凭证脚本是否可以优化。

apiKeyHelper、ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 仅适用于终端 CLI 会话。Claude Desktop 和远程会话仅使用 OAuth，不会调用 apiKeyHelper 或读取 API 密钥环境变量。

身份验证优先级

当存在多个凭证时，Claude Code 按以下顺序选择一个：

云提供商凭证，当设置了 CLAUDE_CODE_USE_BEDROCK、CLAUDE_CODE_USE_VERTEX 或 CLAUDE_CODE_USE_FOUNDRY 时。有关设置，请参阅第三方集成。
ANTHROPIC_AUTH_TOKEN 环境变量。作为 Authorization: Bearer 标头发送。当通过 LLM 网关或代理进行路由时使用此选项，该网关或代理使用持有者令牌而不是 Anthropic API 密钥进行身份验证。
ANTHROPIC_API_KEY 环境变量。作为 X-Api-Key 标头发送。用于直接 Anthropic API 访问，使用来自 Claude Console 的密钥。在交互模式下，系统会提示您一次批准或拒绝该密钥，您的选择会被记住。要稍后更改它，请使用 /config 中的”使用自定义 API 密钥”切换。在非交互模式（-p）下，当密钥存在时始终使用该密钥。
apiKeyHelper 脚本输出。用于动态或轮换凭证，例如从保管库获取的短期令牌。
CLAUDE_CODE_OAUTH_TOKEN 环境变量。由 claude setup-token 生成的长期 OAuth 令牌。用于 CI 管道和脚本，其中浏览器登录不可用。
来自 /login 的订阅 OAuth 凭证。这是 Claude Pro、Max、Team 和 Enterprise 用户的默认设置。

如果您有活跃的 Claude 订阅，但环境中也设置了 ANTHROPIC_API_KEY，则 API 密钥在批准后优先。如果密钥属于已禁用或过期的组织，这可能会导致身份验证失败。运行 unset ANTHROPIC_API_KEY 以回退到您的订阅，并检查 /status 以确认哪种方法处于活跃状态。

Claude Code on the Web 始终使用您的订阅凭证。沙箱环境中的 ANTHROPIC_API_KEY 和 ANTHROPIC_AUTH_TOKEN 不会覆盖它们。

生成长期令牌

对于 CI 管道、脚本或其他不可用交互式浏览器登录的环境，使用 claude setup-token 生成一年期 OAuth 令牌：

claude setup-token

该命令会引导您完成 OAuth 授权并将令牌打印到终端。它不会将令牌保存在任何地方；复制它并将其设置为 CLAUDE_CODE_OAUTH_TOKEN 环境变量，无论您想在何处进行身份验证：

export CLAUDE_CODE_OAUTH_TOKEN=your-token

此令牌使用您的 Claude 订阅进行身份验证，需要 Pro、Max、Team 或 Enterprise 计划。它的范围仅限于推理，无法建立 Remote Control 会话。

Bare mode 不读取 CLAUDE_CODE_OAUTH_TOKEN。如果您的脚本传递 --bare，请改用 ANTHROPIC_API_KEY 或 apiKeyHelper 进行身份验证。

本文翻译自 Anthropic Claude Code 官方文档，最近一次同步：2025-05-01。