是什么
authentication 描述 Claude Code 支持的多种认证方式:个人用户通过 Claude.ai 账号登录,团队可选 Teams/Enterprise、Console API key,或通过 Amazon Bedrock、Google Vertex AI、Microsoft Foundry 等云提供商认证。
核心机制
个人登录流程
- 运行
claude,首次启动自动打开浏览器 - 浏览器无法自动跳转时按
c复制登录 URL - WSL2/SSH/容器环境中浏览器可能显示 login code,粘贴到终端的
Paste code here提示处 - 登出:
/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 认证设置
- 创建/使用 Console 账号
- 邀请用户:Settings → Members → Invite,或配置 SSO
- 分配角色:
Claude Code角色(只能创建 CC API key)或Developer角色(可创建任意 API key) - 用户接受邀请后安装 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
与其他概念的关联
- admin-setup - 组织部署的整体决策框架
- amazon-bedrock - Bedrock 详细配置
- google-vertex-ai - Vertex AI 详细配置
- microsoft-foundry - Foundry 详细配置
- server-managed-settings - Enterprise managed policy 配置
实践要点
- 第三方开发者不得通过 Free/Pro/Max 订阅凭证路由请求,必须使用 API key
- 混合环境(部分用户用 Bedrock,部分用 Teams)需分别配置认证
- OAuth token 仅供订阅用户使用,不适合构建产品或服务