12.1 登录失败解决方案

OAuth 浏览器登录问题

浏览器无法完成跳转

在 WSL2、SSH 或 Docker 容器中，浏览器可能无法完成 OAuth 回调。使用「登录码粘贴」方式：

1. 运行 claude login
2. 终端会显示一个 URL，按 c 复制到剪贴板
3. 在浏览器中打开该 URL，登录 Claude 账号
4. 页面会显示一串登录码（Login Code）
5. 将登录码粘贴回终端，完成认证

浏览器显示空白页

• 尝试禁用浏览器扩展（尤其是广告拦截器）
• 换用无痕/隐私模式
• 尝试不同的浏览器（Chrome / Firefox / Edge）
• 确认系统时间正确，SSL 证书依赖正确的时间校准

凭据问题

登录后仍提示未登录

# 在 Claude Code 会话中
→ /logout
→ /login

如果问题仍然存在，手动清理凭据文件：

# Linux
rm ~/.claude/.credentials.json
claude login

# macOS（从钥匙串删除）
security delete-generic-password -s "Claude Code"
claude login

提示"组织尚未添加此成员"

你的订阅计划不包含 Claude Code 访问权限，或管理员尚未将你添加到组织。在 Claude Console（console.anthropic.com）中更新订阅或联系管理员。

企业认证问题

缺少企业认证选项

# 尝试更新到最新版本
claude update

# 重启终端后重试

API Key 认证替代方案

如果 OAuth 登录持续失败，可以使用 API Key 方式认证：

export ANTHROPIC_API_KEY=sk-ant-api03-xxxxx
claude

这种方式不需要浏览器登录，适合服务器和 CI/CD 环境。

WSL / 容器环境问题

WSL 中 claude 命令无响应

# 从普通 shell 运行诊断
claude doctor

# 如果 doctor 也无响应，尝试安装 Windows 版 Claude Code
# 或将项目放在 WSL 文件系统内（~/projects/）而非 /mnt/c/

容器中登录失败

容器环境通常无法完成浏览器 OAuth，推荐使用 API Key 或长有效期 Token：

# 生成 1 年有效期 Token
claude setup-token

# 在容器中设置
export CLAUDE_CODE_OAUTH_TOKEN=your-token

常见错误信息与解决