結論先說
- 官方的「免登入」就是用憑據代替網頁登入,不是繞過認證。官方寫明:設定了
ANTHROPIC_API_KEY環境變量並在 Claude Code 詢問時批准該密鑰,就會跳過登入提示。 - 密鑰必須是你自己的、來自 Claude Console 的。 用量按 API 計費,計到密鑰所有者名下,和 Pro、Max 訂閱的額度無關。
- 想讓密鑰動態生成或定期輪換,用
apiKeyHelper:在設定裏配置一個會輸出密鑰的腳本。 - 環境變量的優先級高於訂閱登入,設了它,訂閱登入就被頂替。想回到訂閱,要取消設定。
- 不要用別人的密鑰,不要把訂閱登入或密鑰交給第三方轉發。 官方合規文檔明確不允許。

圖:本站根據 Claude Code 官方文檔:Authentication 整理的示意圖
本文根據 Claude Code 官方文檔《Authentication》《Error reference》《Legal and compliance》整理,資料核對於 2026-11-13。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 Anthropic 官方網站。
適用於誰
- 搜「claude code 配置 跳過 登入」「claude code 免登入配置」的人;
- 有自己的 Claude Console API 密鑰,想讓 Claude Code 直接用它的人;
- 在伺服器、容器、CI 裏沒有瀏覽器,沒法走網頁登入的人。
一、官方認可的幾種登入方式
官方《Authentication》頁寫明,第一次運行 claude 時,Claude Code 會打開瀏覽器讓你登入,但在這些情況下可以跳過登入提示:
- API 密鑰:你設定了
ANTHROPIC_API_KEY環境變量,並且在 Claude Code 詢問是否使用該密鑰時批准; - 之前已登入:比如你在 shell 裏先運行了
claude auth login,或者重建了在卷裏儲存憑據的開發容器。
可以使用的帳號類型包括:Claude Pro、Max、Ultra 訂閱;Team 或 Enterprise;Claude Console;雲廠商(Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry),設定對應環境變量或在登入提示裏選第三方平台即可,不需要瀏覽器登入;以及組織自己的 Claude apps gateway。
二、用環境變量:ANTHROPIC_API_KEY
做法分三步(密鑰用佔位符表示):
- 在 Claude Console 裏創建你自己的 API 密鑰,創建方法見 /guides/claude-api-key-console;
- 在運行 Claude Code 的終端裏設定變量:
bash
# macOS / Linux
export ANTHROPIC_API_KEY="你的密鑰"
claude
powershell
# Windows PowerShell(只對當前窗口有效)
$env:ANTHROPIC_API_KEY = "你的密鑰"
claude
- 第一次啟動時,在交互模式下 Claude Code 會詢問是否使用這個密鑰,批准即可,選擇會被記住。以後要改,在
/config裏用「Use custom API key」開關,官方說這個開關只在環境裏設定了ANTHROPIC_API_KEY時才出現。
要點:
- 非交互模式(
claude -p)下,密鑰只要存在就一直被使用,不會詢問; - 密鑰儲存在環境變量裏,不要寫進代碼倉庫,也不要貼到聊天裏。長期儲存用系統的密鑰管理或 shell 配置文件,注意權限,通用的安全習慣見 /guides/ai-coding-security-secrets-permissions;
- 這種方式下,用量是 API 計費,Claude Code 裏看到的「額度」不再是訂閱的 5 小時和每週額度。訂閱和 API 怎麼選,見 /guides/claude-code-pro-max-or-api。
三、用 apiKeyHelper:動態或輪換的密鑰
官方說 apiKeyHelper 用於動態或輪換的憑據,例如從密鑰庫取回的短期令牌。配置方法是在設定裏指定一個會輸出密鑰的腳本,設定文件的位置和優先級見 /guides/claude-code-settings-json。
官方給出的相關行為:
- 腳本需要把密鑰打印到標準輸出,沒有輸出、報錯退出、超時,或者輸出了密鑰以外的東西(比如登入橫幅、日誌行),都會失敗;
- 腳本如果超過 10 秒還沒返回,提示欄會顯示一個帶耗時的警告,說明你的憑據腳本該優化了;
- 失敗時,請求會在三次嘗試內報
Your apiKeyHelper script is failing;這時運行/status可以看到腳本的錯誤輸出; - 當 API 返回 401 或 403 時,Claude Code 會重新運行腳本並用新的輸出重試;
- 刷新間隔等細節,官方放在設定參考頁的
apiKeyHelper一節,本文沒有展開,請以官方為準。
適用範圍:官方說明 apiKeyHelper、ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN 作用於命令行和包着它的介面,包括 VS Code 擴展、Agent SDK 和 GitHub Actions;而 Claude Desktop 和雲端會話不會調用它們,使用 OAuth。CI 裏的完整用法見 /guides/claude-code-ci-end-to-end-headless-github-actions。
四、優先級:同時有多種憑據時用哪個
官方給出的順序,從高到低:
- 雲廠商憑據(設定了
CLAUDE_CODE_USE_BEDROCK、CLAUDE_CODE_USE_VERTEX或CLAUDE_CODE_USE_FOUNDRY); ANTHROPIC_AUTH_TOKEN,用於經 LLM 網關或代理、用承載令牌認證的場景;ANTHROPIC_API_KEY;apiKeyHelper腳本輸出;CLAUDE_CODE_OAUTH_TOKEN,由claude setup-token生成的長期令牌,用於沒有瀏覽器的 CI 和腳本,要求 Pro、Max、Ultra、Team 或 Enterprise 訂閱;- Anthropic 的 profile 與聯合身份憑據;
/login儲存的訂閱登入,這是 Pro、Max、Ultra、Team、Enterprise 用戶的預設。
所以你只要設了前面任何一個,後面的訂閱登入就不會被用到。這也是「明明買了訂閱,卻被扣 API 費用」的最常見原因。

圖:本站根據 Claude Code 官方錯誤參考 整理的示意圖
五、常見問題和排查
- 設了變量還是彈登入:先看是否是第一次,應當會詢問是否使用該密鑰;檢查變量在當前終端裏確實存在;
- 想回到訂閱登入:取消設定變量(
unset ANTHROPIC_API_KEY或 PowerShell 裏Remove-Item Env:ANTHROPIC_API_KEY),再用/login,並用/status確認。登入退出等見 /guides/claude-code-login-logout-switch-account; - 報「organization has been disabled」:很可能是舊組織的密鑰殘留,見 /guides/claude-account-disabled-appeal;
- 公司電腦被攔:官方說明,管理員用
forceLoginMethod或forceLoginOrgUUID時,ANTHROPIC_API_KEY、ANTHROPIC_AUTH_TOKEN和apiKeyHelper會在啟動時被攔截,需要按管理員的要求用指定方式登入; - 想用第三方模型或網關:官方有云廠商和 LLM 網關的接入方式,見 /guides/claude-code-other-models-bedrock-vertex-foundry。
六、合規邊界
官方《Legal and compliance》寫明:
- 開發產品或服務、使用 Agent SDK 的人,應當使用 Claude Console 或受支持雲廠商的 API 密鑰認證;
- 不允許第三方通過 Free、Pro、Max、Ultra 訂閱憑據替用戶轉發請求,也不允許收集、存儲或中轉 Claude.ai 的憑據或會話令牌;
- 為自己授權的用戶在開發環境、密鑰管理系統裏配置自己的 API 密鑰是允許的,前提是用量計到密鑰所有者名下,並且沒有被轉售或中轉。
所以這篇文章只適合「用自己的密鑰」。別人給你的、來路不明的密鑰,別用。
七、訂閱還是 API,怎麼選
API 密鑰按用量付費,適合自動化、CI、集成。如果你主要是個人日常用 Claude Code,訂閱登入通常更省心,額度規則見官方幫助中心。想了解本站的 Claude Code 訂閱相關商品,可以看 /chongzhi/claude-code,具體限制以頁面為準。
常見問題
Q:設了 API 密鑰後,還能用訂閱額度嗎?
不能同時用。環境變量的優先級更高,訂閱登入會被頂替。
Q:能把密鑰寫進 settings.json 嗎?
本文沒有讀到官方對這一做法的明確說明。更穩妥的是用環境變量或 apiKeyHelper 從密鑰庫取。
Q:Docker 或伺服器上沒有瀏覽器怎麼辦?
可以用環境變量裏的 API 密鑰,或用 claude setup-token 生成長期令牌(需訂閱)。後者的使用見官方認證頁。
相關教學
- /guides/claude-api-key-console:創建 API 密鑰
- /guides/claude-code-settings-json:settings.json 位置與優先級
參考資料
- Claude Code 官方文檔:Authentication — https://code.claude.com/docs/en/authentication
- Claude Code 官方文檔:Error reference — https://code.claude.com/docs/en/errors
- Claude Code 官方文檔:Legal and compliance — https://code.claude.com/docs/en/legal-and-compliance
0 條評論
還沒有評論,來搶沙發~