本文根據 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 條評論
還沒有評論,來搶沙發~