它到底是什么

/login 是 Claude Code 会话内的 slash 命令，用于触发 OAuth 认证流程并写入本地凭证存储（macOS 为加密的 Keychain，其余平台为 .credentials.json 文件，详见下方平台对照表）。官方文档原文："Claude Code manages .credentials.json through /login and /logout"，并补充 "On macOS, credentials are stored in the encrypted macOS Keychain."

首次运行 claude 时，程序会自动打开浏览器完成初始登录，无需手动输入 /login。/login 的典型用途是在已有会话内重新认证——例如切换账户、凭证失效或从 API Key 模式切回订阅 OAuth 模式。

订阅/账户要求（来自官方文档）：

怎么触发 / 怎么使用

在 Claude Code 会话提示符下直接输入：

/login

1. 有浏览器环境（标准流程）

# 在会话内输入
/login

Claude Code 自动打开浏览器窗口 → 在浏览器中登录 Claude.ai / Console → 成功后自动重定向回终端，凭证写入本地存储。

2. 无浏览器直连环境（WSL2 / SSH / 容器）

官方文档说明：若浏览器无法回调 localhost（常见于 WSL2、SSH 会话、容器），浏览器登录后会显示一串验证码，而非自动跳转。

# 1. 在会话内输入
/login

# 2. 若浏览器无法自动打开，按 c 复制登录 URL，粘贴至浏览器手动访问

# 3. 浏览器登录成功后，将页面显示的 code 粘贴回终端：
Paste code here if prompted: <粘贴此处>

保存 / 配置 / 集成

凭证存储位置

支持的凭证类型

官方文档列出的 Supported authentication types：Claude.ai credentials、Claude API credentials、Azure Auth、Bedrock Auth、Vertex Auth。

CI / 非交互环境的替代方案

/login 需要交互式浏览器流程，不适用于 CI pipeline。官方推荐使用 claude setup-token 生成一年期 OAuth token：

# 执行一次，跟随提示完成 OAuth 授权，复制输出的 token
claude setup-token

# 在 CI 中设置为环境变量
export CLAUDE_CODE_OAUTH_TOKEN=your-token

此 token 需要 Pro、Max、Team 或 Enterprise 订阅，且仅限推理使用，不能建立 Remote Control 会话。使用 --bare 模式时该变量不生效，应改用 ANTHROPIC_API_KEY 或 apiKeyHelper。

运行约束 / 限制

跟同类原语对比

经典使用场景

• 从个人 Pro 账户切换到团队 Team/Enterprise 账户，在会话内执行 /login 重新绑定。
• 凭证过期或 /status 显示认证失效时，在当前会话直接 /login 而无需退出重启。
• 误设 ANTHROPIC_API_KEY 导致走 API Key 路径，unset ANTHROPIC_API_KEY 后执行 /login 切回订阅 OAuth。

常见坑

1. ANTHROPIC_API_KEY 遮盖 /login：若环境变量中存在 ANTHROPIC_API_KEY，它的优先级（第 3 位）高于 /login 写入的 OAuth 凭证（第 6 位）。即使 /login 成功，实际请求仍会走 API Key。官方建议：执行 unset ANTHROPIC_API_KEY，再用 /status 确认当前生效的认证方式。

2. WSL2/SSH/容器中浏览器回调失败：/login 触发后若浏览器无法回调 localhost，终端不会自动收到凭证。需手动访问 URL，完成登录后将浏览器显示的 code 粘贴到终端的 Paste code here if prompted 提示处。

关闭 / 退出 / 卸载

/logout 清除当前会话凭证，之后可再次执行 /login 重新认证。

来源

• Authentication – Claude Code Docs
• Commands – Claude Code Docs