认证

原文：Authentication

一句话

解决 Claude Code 登录和配置个人、团队和组织认证的问题。

什么时候翻这页

• 首次安装 Claude Code 需要登录时
• 需要为团队设置 Claude Code 访问权限时
• 遇到认证问题需要排查时
• 需要配置云服务提供商认证时

核心概念

• 认证方式：个人用户使用 Claude.ai 账户，团队可使用 Teams/Enterprise、Console 或云服务提供商（Amazon Bedrock、Google Vertex AI、Microsoft Foundry）
• 登录流程：首次启动会自动打开浏览器，如未自动打开可按 c 复制登录链接
• 团队认证：支持 Teams/Enterprise、Console 和云服务提供商三种方式
• 凭证管理：不同操作系统有不同存储位置，支持多种认证类型和自定义凭证脚本
• 认证优先级：当存在多种凭证时，按特定顺序选择使用，云服务提供商凭证优先级最高

怎么做

登录 Claude Code

1. 安装后，在终端运行 claude
2. 首次启动会自动打开浏览器窗口进行登录
3. 如果浏览器未自动打开，按 c 复制登录链接到浏览器
4. 如果浏览器显示登录代码而非自动跳转，将代码粘贴到终端的 Paste code here if prompted 提示处

团队认证设置

Claude for Teams or Enterprise

1. 订阅 Claude for Teams 或联系销售获取 Claude for Enterprise
2. 从管理员仪表板邀请团队成员
3. 团队成员安装 Claude Code 并使用 Claude.ai 账户登录

Claude Console

1. 创建或使用现有 Claude Console 账户
2. 通过以下方式添加用户：
   • 从 Console 批量邀请：Settings -> Members -> Invite
   • 设置 SSO
3. 邀请用户时分配角色：
   • Claude Code 角色：只能创建 Claude Code API 密钥
   • Developer 角色：可以创建任何类型的 API 密钥
4. 被邀请用户需要：
   • 接受 Console 邀请
   • 检查系统要求
   • 安装 Claude Code
   • 使用 Console 账户凭据登录

Cloud provider

1. 遵循相应提供商的文档设置：
   • Bedrock docs
   • Vertex docs
   • Microsoft Foundry docs
2. 向用户分发环境变量和生成云凭证的说明
3. 用户安装 Claude Code

生成长期令牌

claude setup-token

1. 运行命令并完成 OAuth 授权
2. 复制生成的令牌
3. 设置为环境变量：

export CLAUDE_CODE_OAUTH_TOKEN=your-token

命令 / 配置速查

初学者易错点

• 浏览器未自动打开时需要按 c 复制登录链接，而非等待
• 在 WSL2、SSH 会话和容器中可能需要手动输入登录代码
• 设置了 ANTHROPIC_API_KEY 但属于已禁用或过期的组织会导致认证失败，需运行 unset ANTHROPIC_API_KEY 回退到订阅认证
• apiKeyHelper 脚本执行超过 10 秒会显示警告，应优化脚本性能
• Bare 模式（--bare）不读取 CLAUDE_CODE_OAUTH_TOKEN，需使用 ANTHROPIC_API_KEY 或 apiKeyHelper

相关词条

• setup 安装 Claude Code
• settings 配置和管理设置
• amazon-bedrock Amazon Bedrock 集成
• google-vertex-ai Google Vertex AI 集成
• microsoft-foundry Microsoft Foundry 集成
• troubleshoot-install 安装和认证故障排除