本文根据 Claude Code 官方文档《Authentication》《Troubleshoot installation and login》《Commands》整理,资料核对于 2026-11-05。配图为本站整理的示意图,不是界面截图。本站(bigolab.com)不是 Anthropic 官方网站。
适用于谁
- 搜「claude code 提示未登录」,看到
Not logged in · Please run /login的人; - 搜「claude code 取消登录」「怎么退出登录」,想换账号或清掉登录状态的人;
- 想同时用工作号和个人号,又怕互相串的人。
结论先说
- 登录用
/login,退出用/logout,都在 Claude Code 提示符里输入。官方对这两个命令的描述分别是:登录 Anthropic 账号、退出 Anthropic 账号。 /logout同时会重置首次启动的设置状态,下次运行claude会重新走一遍登录和初始设置。- 登录不上时,官方推荐的重置办法:
/logout→ 关闭 Claude Code → 重新运行claude并重新认证。 - 想同时保持两个账号登录:给每个账号设单独的配置目录,也就是启动时指定环境变量
CLAUDE_CONFIG_DIR,写法见下文。 - 订阅账号却被拒绝,常见原因是
ANTHROPIC_API_KEY在覆盖订阅,用/status看当前生效的是哪种登录方式。

图:本站根据 Claude Code 官方文档:Troubleshoot installation and login 整理的示意图
一、能用什么账号登录
官方列出的登录方式包括:
- Claude Pro、Max 或 Ultra 订阅:用 claude.ai 账号登录;
- Claude for Teams 或 Enterprise:用团队管理员邀请你的 claude.ai 账号登录;
- Claude Console:用 Console 账号登录,管理员要先邀请你;
- 云厂商:Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry,先设环境变量,或在登录提示里选「3rd-party platform」,不需要浏览器登录。
订阅登录和 API 计费怎么选,见 /guides/claude-code-pro-max-or-api;需要订阅可以了解 /chongzhi/claude-code。
第一次运行 claude 会打开浏览器让你登录。浏览器没自动打开时,按 c 复制登录链接,贴到浏览器里;如果浏览器登录后显示的是一个代码而不是跳回终端,把代码粘贴到 Paste code here if prompted 提示处。登录完成后终端显示 Login successful,按 Enter 继续。
二、提示未登录:Not logged in 怎么办
官方在排查页写的是:Claude Code 在一次会话后又要你登录,可能是 OAuth 令牌过期了,运行 /login 重新认证;如果频繁发生,检查系统时钟是否准确,因为令牌校验依赖正确的时间戳。
另外官方说明:
- 同一台机器上的多个会话共享一份保存的登录,并协调续期,同一时刻只有一个进程在刷新令牌;
- 登录距离过期不到 3 天时,启动会提示
Your login expires in 3 days · run /login to renew,这只是提醒,不会拦截请求; - 登录真正过期、又无法刷新后,每次请求会报
Login expired · Please run /login,直到你重新登录; - 用
/status可以在请求失败之前检查:它的Login行会写Expired — log in again,并列出保存的组织和邮箱,这一行需要 v2.1.210 或更新版本。
在后台会话或 Remote Control 会话里,登录过期会让它停止推进,且在你重新登录之前无法恢复,长任务前可以先续期。
三、怎么退出登录、怎么换账号
退出:在提示符输入 /logout。官方在凭据管理里说明,退出会移除所有已存的凭据,包括保存的 MCP 服务器登录和插件的敏感值,之后可能要重新授权 MCP 服务器、重新输入插件密钥。
换账号:官方文档里没有出现单独的「切换账号」命令,做法是 /logout,然后重新运行 claude 或 /login,用另一个账号登录(这是根据官方的登录流程推出的做法)。
命令行里的写法:官方文档里出现过 claude auth login(在 shell 里登录,它会打印登录链接,粘贴的代码从标准输入读取)、claude auth logout(退出)和 claude auth status,后两条本文只确认了命令名,用法以官方 CLI 参考页为准。
同时保持两个账号登录,官方的办法是给每个账号用单独的配置目录。启动 claude 时设置环境变量 CLAUDE_CONFIG_DIR 指向对应账号的目录,每个目录有自己的设置、会话历史、claude.ai 登录或 API 密钥。官方示例,写进 ~/.bashrc 或 ~/.zshrc:
bash
alias claude-work='CLAUDE_CONFIG_DIR=~/.claude-work claude'
之后用 claude-work 启动工作账号,用 claude 启动个人账号。第一次在新目录运行会走一遍登录和设置。注意官方说:不创建 API 密钥的两个 Console 登录,不会被这样隔开,因为那种登录存在配置目录之外。
四、登录凭据存在哪
官方在凭据管理里写明:
- macOS:存在加密的 Keychain,Keychain 拒绝写入时(比如在 SSH 里被锁定)退回到
~/.claude/.credentials.json; - Linux:
~/.claude/.credentials.json,权限0600; - Windows:
%USERPROFILE%\.claude\.credentials.json,沿用用户目录的访问控制; - 设置了
CLAUDE_CONFIG_DIR时,该文件放在那个目录下,macOS 的 Keychain 条目也按目录区分。
~/.claude 里其他文件的用途见 /guides/claude-code-folders-history-location。
五、订阅账号却被拒:先查 ANTHROPIC_API_KEY

图:本站根据 Claude Code 官方文档:Authentication 与 Troubleshoot installation and login 整理的示意图
如果你有订阅,却看到 API Error: 400 ... "This organization has been disabled",官方说通常是环境变量 ANTHROPIC_API_KEY 覆盖了订阅:旧雇主或旧项目的 API 密钥还留在 shell 配置里。官方的处理:
- macOS/Linux:
unset ANTHROPIC_API_KEY后再运行claude; - Windows PowerShell:
Remove-Item Env:ANTHROPIC_API_KEY; - 检查
~/.zshrc、~/.bashrc、~/.profile里有没有export ANTHROPIC_API_KEY=...,删掉才会永久生效;Windows 上检查 PowerShell 配置文件$PROFILE和用户环境变量; - 用
/status确认当前生效的认证方式。
官方列出的凭据优先级(高到低)是:云厂商凭据、ANTHROPIC_AUTH_TOKEN、ANTHROPIC_API_KEY、apiKeyHelper 输出、CLAUDE_CODE_OAUTH_TOKEN、Anthropic profile 凭据,最后才是 /login 的订阅凭据。所以环境里有前面任何一种,都会盖过订阅登录。更多登录错误对照见 /guides/claude-code-common-errors 和 /guides/claude-login-errors-table。
六、WSL、SSH、容器里浏览器打不开
官方说没有浏览器、或浏览器登录后显示连接 localhost 的错误时:在登录提示处按 c 复制链接,在本机浏览器登录,把页面显示的代码粘贴回 Paste code here 处;粘贴没反应就用终端的备用粘贴快捷键,或者直接运行 claude auth login。远程服务器上怎么用见 /guides/claude-code-ssh-remote-server。
常见问题
Q:/logout 会不会删掉我的会话历史?
官方说退出会移除凭据和相关登录,没有说会删会话记录;会话记录在 ~/.claude/projects/ 下,由保留期规则管理。
Q:退出后设置还在吗?
官方没有说 /logout 会删 settings.json。它说的是退出会重置首次启动的设置状态,并移除凭据、已保存的 MCP 登录和插件敏感值。
Q:换了账号后,之前的会话能继续吗?
官方说会话记录存在本机 ~/.claude/projects/ 下,claude --resume 的恢复方式见 /guides/claude-code-resume-history;官方没有写换账号对已有会话的影响,用量和模型可用范围按你登录的账号算。
Q:团队成员登录报 Claude Code access has not been granted for this account?
官方说这是企业组织把你的角色设成 Custom,且没有任何自定义角色授予 Claude Code,需要组织 Owner 调整角色,之后重新登录。
相关教程
参考资料
- Claude Code 官方文档:Authentication — https://code.claude.com/docs/en/authentication
- Claude Code 官方文档:Troubleshoot installation and login — https://code.claude.com/docs/en/troubleshoot-install
- Claude Code 官方文档:Commands — https://code.claude.com/docs/en/commands
0 条评论
还没有评论,来抢沙发~