账号与认证

账号与认证

装好了，但还没登录，Claude Code 不让你用。这一页讲清楚账号怎么选、怎么登、怎么在多个账号间切换、怎么给 CI 配长期凭证。

两种账号，怎么选

Claude Code 支持两种账号体系：

账号类型	计费方式	适合谁
Claude.ai（Pro/Max/Team 订阅）	包月，token 算在订阅里	个人开发者、小团队
Claude Console（API 预付）	按 token 计费	CI/脚本、企业

官方对个人用户的建议是 Claude.ai 订阅——简单、可预测、不用担心某天突然跑出大账单。

Console 适合两类场景：一是 CI/自动化脚本里没人盯着，二是企业要走自己的 API key、Bedrock/Vertex 出口、SSO。

同一个邮箱可以同时挂两种账号：用 me@example.com 注册 Claude.ai 订阅，也能用同一个邮箱在 Console 充值。两者计费独立，互不影响。

第一次启动

claude

第一次启动会看到登录提示，给你两个选择：

1. Login with Claude.ai——跳浏览器走 OAuth，登回订阅账号。
2. Login with Console——填 API key，走 Console 计费。

跟着提示走完，凭据会自动存到本地，下次启动不用再登。

切换账号

日常用得最多的两个斜杠命令：

/login    # 切换或重新登录
/logout   # 登出当前账号

比如你白天用订阅账号干活，晚上要跑个脚本走 Console 计费，就 /logout 再 /login 选 Console。

命令行认证

不想进交互模式，命令行直接管认证：

claude auth status    # 看当前登录状态
claude auth login     # 命令行登录
claude auth logout    # 命令行登出

claude auth status 在 CI 排错时特别有用——能告诉你当前会话用的是哪个账号、token 还剩多久。

几个常用 flag

# 预填邮箱，省得手输
claude --email me@example.com

# 强制走 SSO（企业用户）
claude --sso

# 用 Console 计费（即使你登了订阅）
claude --console

--email 在脚本里特别顺——不用每次手输邮箱。--sso 给企业用户，强制走 SSO 流程，避免有人偷偷用个人订阅。

setup-token：给 CI 配长期凭证

OAuth 登录的 token 会过期，CI 跑两天就掉线。解决办法是 setup-token——生一个长期凭证给 CI 用。

# 生成一个长期 token
claude setup-token

它会打印一串 token，你把它塞到 CI 的 secret 里：

# GitHub Actions / GitLab CI 里
export CLAUDE_CODE_OAUTH_TOKEN=your-long-token-here
claude -p "fix the failing lint"

CI 不用再走浏览器 OAuth，靠这个 token 就能调 Claude Code。别把 token 写进代码里，一律走环境变量 + secret store。

凭证存在哪，安不安全

Claude Code 的凭证存在本地：

• macOS / Linux：~/.claude/ 下，文件权限 600
• Windows：%USERPROFILE%\.claude\

文件权限默认只有你自己能读。但有几个小坑：

1. 别把 ~/.claude/ 提交到 git——确认你的 .gitignore 包含它。
2. 共享开发机要登出——/logout 不仅清内存，也清本地凭证。
3. CI 的 token 单独建——别用个人账号的 token 跑 CI，跑没了你自己心疼。

Console 首次认证的「魔法」

第一次用 Console 账号认证时，Claude Code 会在 Console 里自动给你建一个名叫 “Claude Code” 的 workspace。这是设计如此，不是 bug：

• 这个 workspace 专门给 Claude Code 用，token 用量独立统计
• 你可以在 Console 后台看到 Claude Code 单独的成本曲线
• 团队管理者可以给这个 workspace 单独设预算上限

第一次认证完，去 Console 后台看一眼，确认 workspace 建好了、预算设对了，再大规模用。

一个常见的坑

/login 切账号之后，token 没清干净，导致 Claude Code 还在用旧账号计费。如果你发现 /cost 显示的额度对不上，先 /logout 再 /login，强制刷新一遍。

一句话总结

个人用户走订阅，CI/企业走 Console；多账号靠 /login 切，长期凭证靠 setup-token。

下一站 5 分钟第一个任务，让 Claude Code 真的帮你改一行代码。🚀