Claude Code 登入/認證失敗(Invalid API key/Please run /login/OAuth)的原因與解決方法
現在有故障嗎?
Claude Code 官方狀態正常。若此錯誤持續出現,多半是實作或你的運作環境問題。
更新於: 2026年6月6日 凌晨4:56 UTC
查看 Claude Code 的運作狀態 →錯誤含義
Claude Code 無法登入或完成認證。常見原因包括 OAuth 登入回呼逾時、macOS 鑰匙圈遭鎖定而無法儲存權杖、API 金鑰與 base URL 不相符,或是 DNS/網路問題。「Invalid API key · Please run /login」代表金鑰錯誤或權杖已過期。
常見原因
- •OAuth 登入回呼逾時
- •macOS 鑰匙圈遭鎖定,無法儲存認證權杖
- •API 金鑰(sk-ant-…)與 base URL(官方或 proxy)不相符
- •在無瀏覽器環境(SSH/CI/Docker)中嘗試使用 OAuth
- •DNS/proxy/防火牆封鎖了認證伺服器
- •版本過舊或快取損毀
解決方法
- 1.執行 /logout 徹底清除舊權杖,再重新執行 /login
- 2.更新 Claude Code、刪除 ~/.claude/cache 後重試
- 3.在無瀏覽器環境(SSH/CI/Docker)中,請改設定 ANTHROPIC_API_KEY 環境變數,而非使用 OAuth
- 4.確認你的 API 金鑰與 base URL 來自同一平台(官方金鑰搭配官方 base URL)
- 5.執行 /doctor 一次檢查設定、認證與更新問題
- 6.在 macOS 上解鎖鑰匙圈;並確認網路/proxy 設定
何時該等待 / 等待也無濟於事的情況
這是認證/設定的問題,等待並不會自行修復。請重新執行 /logout 再 /login、更新並清除快取,或在無瀏覽器環境中設定 ANTHROPIC_API_KEY。先執行 /doctor 是釐清原因最快的方式。
Claude Code 當機時的替代方案
相關錯誤
常見問題
Login / authentication failed 是什麼?
Claude Code 無法登入或完成認證。常見原因包括 OAuth 登入回呼逾時、macOS 鑰匙圈遭鎖定而無法儲存權杖、API 金鑰與 base URL 不相符,或是 DNS/網路問題。「Invalid API key · Please run /login」代表金鑰錯誤或權杖已過期。
Login / authentication failed 如何解決?
執行 /logout 徹底清除舊權杖,再重新執行 /login / 更新 Claude Code、刪除 ~/.claude/cache 後重試 / 在無瀏覽器環境(SSH/CI/Docker)中,請改設定 ANTHROPIC_API_KEY 環境變數,而非使用 OAuth / 確認你的 API 金鑰與 base URL 來自同一平台(官方金鑰搭配官方 base URL) / 執行 /doctor 一次檢查設定、認證與更新問題 / 在 macOS 上解鎖鑰匙圈;並確認網路/proxy 設定