是什么

authentication 描述 Claude Code 支持的多种认证方式:个人用户通过 Claude.ai 账号登录,团队可选 Teams/Enterprise、Console API key,或通过 Amazon Bedrock、Google Vertex AI、Microsoft Foundry 等云提供商认证。

核心机制

个人登录流程

  1. 运行 claude,首次启动自动打开浏览器
  2. 浏览器无法自动跳转时按 c 复制登录 URL
  3. WSL2/SSH/容器环境中浏览器可能显示 login code,粘贴到终端的 Paste code here 提示处
  4. 登出:/logout

账号类型

  • Claude Pro/Max:个人订阅,claude.ai 账号登录
  • Claude for Teams:团队协作,管理员邀请后登录
  • Claude for Enterprise:SSO、域名捕获、RBAC、合规 API、managed policy
  • Claude Console:API-first,需管理员先邀请用户
  • 云提供商(Bedrock/Vertex/Foundry):设置环境变量,无需浏览器登录

Console 认证设置

  1. 创建/使用 Console 账号
  2. 邀请用户:Settings → Members → Invite,或配置 SSO
  3. 分配角色:Claude Code 角色(只能创建 CC API key)或 Developer 角色(可创建任意 API key)
  4. 用户接受邀请后安装 Claude Code 并用 Console 凭证登录

云提供商认证

  • Bedrock:设置 AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_REGION、ANTHROPIC_MODEL
  • Vertex AI:设置 ANTHROPIC_VERTEX_PROJECT_ID、CLOUD_ML_REGION,使用 gcloud auth
  • Foundry:设置 Azure 相关环境变量

关键细节

  • Console 认证时自动创建名为 “Claude Code” 的 workspace,专用于 CC 认证和用量追踪,不能创建 API key
  • Teams/Enterprise 提供 claude.ai + Claude Code 统一订阅,推荐大多数团队使用
  • Enterprise 额外支持:SSO、域名捕获、RBAC、合规 API、managed policy settings

与其他概念的关联

实践要点

  • 第三方开发者不得通过 Free/Pro/Max 订阅凭证路由请求,必须使用 API key
  • 混合环境(部分用户用 Bedrock,部分用 Teams)需分别配置认证
  • OAuth token 仅供订阅用户使用,不适合构建产品或服务