它到底是什么

/logout 是 Claude Code 的会话内 slash 命令,用于退出当前 Anthropic 账户并触发重新认证流程。执行后,Claude Code 会清除本地存储的 OAuth 凭据,下次使用时需重新登录。

官方认证文档对此命令的完整描述为:

To log out and re-authenticate, type /logout at the Claude Code prompt.

注意:/logout 是 CLI 终端会话内的命令。官方文档说明 Claude Desktop 和 cloud 会话仅使用 OAuth,不调用 apiKeyHelper、也不读取 API key 环境变量(原文 'Claude Desktop and cloud sessions use OAuth exclusively and do not call apiKeyHelper or read API key environment variables'),其认证机制与 CLI 的 API key / env 链路相互独立。

怎么触发 / 怎么使用

在任意 Claude Code 会话提示符处直接输入:

/logout

执行后,Claude Code 会登出当前 Anthropic 账户并需要重新认证(官方原文 'To log out and re-authenticate, type /logout')。命令页表格中 /logout 未标注 [arg]/<arg> 占位,实际使用时直接输入即可,无需附加参数。

重新登录使用配对命令 /login,或直接退出后重新运行 claude(首次启动时会自动触发浏览器登录流程)。

保存 / 配置 / 集成

/logout 操作的目标是各平台的凭据文件。官方文档明确了各平台的存储位置:

官方文档原文:"Claude Code manages .credentials.json through /login and /logout."

相关配置项:

• CLAUDE_CONFIG_DIR — 覆盖 Linux/Windows 上的凭据目录路径
• /config 内的 "Use custom API key" 开关 — 控制 ANTHROPIC_API_KEY 是否生效

运行约束 / 限制

跟同类原语对比

经典使用场景

• 切换账户:在同一台机器上从个人 Claude Pro 账户切换到团队 Enterprise 账户,先 /logout 再 /login。
• 共享机器安全清理:结束使用前退出,防止其他用户继承本地 OAuth 凭据。
• 认证故障排查:当 /status 显示认证异常时,通过 /logout → /login 强制刷新凭据链。
• 从订阅账户切换到 API Key:先 /logout 清除 OAuth,再在新 shell 中 export ANTHROPIC_API_KEY=sk-...。

常见坑

1. /logout 后仍用原账户请求:如果 shell 中设置了 ANTHROPIC_API_KEY,它的优先级高于 OAuth 凭据(认证优先级链第 3 位 vs 第 6 位)。/logout 不会清除 env var。解决方法:先 unset ANTHROPIC_API_KEY,再用 /status 确认当前生效的认证方式。

2. VS Code 扩展中命令不可用:Claude Code VS Code 扩展目前未实现 /logout(GitHub Issue #45509,已关闭为 not planned)。临时方案是打开扩展外部的独立终端,在那里运行 claude 并执行 /logout。

来源

• Authentication — Claude Code Docs
• Commands — Claude Code Docs
• Bug: /logout command is missing in Claude Code VS Code Extension · Issue #45509 · anthropics/claude-code