Claude Code 怎麼登入?API Key 跟訂閱別搞混
先講重點
短答給趕時間的人:Claude Code 有兩種身分驗證,搞混會多花錢。(1) 訂閱制(多數人走這條):有 Pro(US$20/月)就在第一次啟動時用瀏覽器登入 Anthropic 帳號,完成授權即用,完全不用碰 API key。(2) API 制:去後台生一把 API key、設成 ANTHROPIC_API_KEY 環境變數,按用量計費,適合自動化排程或偶爾大量的型態。已訂 Pro 就別再買 API 額度 — 訂閱登入就涵蓋了。
「我訂了 Pro,為什麼教學叫我去生 API key?」— 因為網路上很多教學寫在訂閱制涵蓋 Claude Code 之前,或寫給工程師的自動化場景。這篇把兩條路、常見卡點、跟 API key 的安全放法(這個真的重要)一次講清楚。
兩種登入方式:你該走哪條?
| 面向 | 訂閱登入 (多數人) | API key |
|---|---|---|
| 適合誰 | 訂了 Pro/Max 的個人使用 | 自動化排程 / 偶爾大量的型態 |
| 怎麼驗證 | 瀏覽器跳出 → 登入帳號 → 授權 | 設 ANTHROPIC_API_KEY 環境變數 |
| 費用 | 包在訂閱裡 (Pro US$20/月) | 按 token 用量計費 另外付 |
| 要碰 key 嗎 | 完全不用 | 要 而且要妥善保管 |
| 切換帳號 | /logout 再重新登入 | 換環境變數的值 |
判斷一句話:你是「人坐在電腦前用」→ 訂閱登入;你要「程式在沒有人的時候自己跑」(排程 bot、伺服器上的自動化)→ 那個環境才需要 API key。我的 Threads bot 跟 LINE bot 都是後者,但我平常做網站、寫東西全是訂閱登入。
訂閱登入的 3 個常見卡點
- 瀏覽器沒自動跳出 — 終端機上其實印了一條授權網址,手動複製到瀏覽器開,登入完成就接上了。常發生在預設瀏覽器設定怪怪的機器上。
- 公司網路卡在授權頁 — 有些公司防火牆擋外部授權流程。分辨法:手機開熱點讓電腦連,能登就是公司網路的事(找 MIS),還是不能登才是帳號問題。
- 登入了卻說沒有權限 — 通常是帳號沒有有效訂閱(免費帳號登入不能用 Claude Code),或登到另一個帳號(公司信箱 vs 個人信箱)。打 /logout 登出,確認用有訂閱的那個帳號重登。
API key 的正確放法(安全鐵律,別跳過)
如果你走 API 這條,先記住一條鐵律:key 絕對不寫進程式碼。key 等於你的錢包 — 寫在程式裡、跟著上傳 GitHub,等於把錢包公開在網路上,有人撿到就能燒你的額度(這種盜刷每天都在發生,掃 GitHub 找 key 的機器人是全自動的)。
正確做法是放環境變數,程式執行時才讀進來:
# 當次測試(PowerShell):
$env:ANTHROPIC_API_KEY = 'sk-ant-你的key'
# 永久設定(使用者層級):
[Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-ant-你的key', 'User')設完重開終端機生效。專案要分開管理的話,把 key 放專案資料夾的 .env 檔(存 UTF-8「不要」BOM,原因看編碼那篇)、並確認 .gitignore 有擋 .env — 這樣程式讀得到、Git 傳不出去。萬一 key 不小心外洩(貼到公開的地方、傳給別人看過):去後台把那把 key 作廢、生一把新的,別心存僥倖。
三不:不寫進程式碼、不傳進聊天室 / 截圖、不 commit 進 Git。一要:洩漏就立刻作廢重生。
Claude Code 身分驗證兩條路:(1) 訂閱登入 — 有 Pro(US$20/月)的人第一次啟動用瀏覽器授權即用,不用碰 API key;卡住的話查三點:授權網址手動複製開、換熱點分辨公司網路問題、/logout 確認登對帳號。(2) API key — 給自動化排程等「沒有人在場」的場景,設 ANTHROPIC_API_KEY 環境變數、按量計費。安全鐵律:key 不寫進程式碼、不 commit、放 .env 要配 .gitignore,洩漏立刻作廢重生。已訂 Pro 別再買 API 額度,訂閱就涵蓋日常使用。
名詞解釋
- API 金鑰（API key）
- 服務發給你的一串密碼，程式用它證明「我有權限使用這個服務」。絕對不能公開、不能寫死在程式碼裡。
- OAuth（帳號授權登入）
- 「用你的帳號幫工具開門」的標準流程：跳出瀏覽器讓你登入原服務，工具拿到授權後就能代你操作，全程不用把密碼交給工具。
- 環境變數（environment variable）
- 放在系統層、不寫進程式碼的設定值，最常用來放 API 金鑰等機密，避免跟著程式碼被公開。
- GitHub
- 放 Git 程式碼的雲端平台，也是全世界開源專案的集散地。程式碼推上去之後可以接自動部署。
- Git
- 程式碼的版本紀錄系統：每次改動存成一個「存檔點」（commit），隨時可以回溯、比對、還原，不怕改壞。
- PowerShell
- Windows 內建的指令視窗：用打字下指令的方式操作電腦，Claude Code 在 Windows 上就在這裡面跑。按 Win + X 可以叫出來。
- API（應用程式介面）
- 程式跟程式之間溝通的窗口。例如你的程式透過 LINE 的 API 自動發訊息、透過 Google 的 API 讀試算表。
如果內容對你有用就太好了
隨喜斗內
▸ 常見問題
Claude Code 需要 API key 嗎?
多數人不需要。有 Pro 訂閱(US$20/月)的話,第一次啟動時用瀏覽器登入 Anthropic 帳號授權就能用,完全不碰 API key。需要 API key 的是「程式在沒有人的時候自己跑」的場景:排程 bot、伺服器自動化 — 那個執行環境沒辦法開瀏覽器登入,才用 key 驗證、按量計費。
Claude Code 登入時瀏覽器沒有跳出來怎麼辦?
終端機畫面上有印一條授權網址,手動複製到任何瀏覽器打開、登入你的 Anthropic 帳號完成授權,終端機那邊就會自動接上。如果在公司網路連授權頁都開不了,用手機熱點試一次 — 能登就是公司防火牆的問題,找 MIS 處理。
API key 應該放在哪裡才安全?
放環境變數,絕對不寫進程式碼。Windows 用 PowerShell 打 [Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY','你的key','User') 設定使用者層級變數;專案要分開管就放 .env 檔(UTF-8 不要 BOM)並確認 .gitignore 擋住它。key 寫在程式裡跟著上傳 GitHub = 錢包公開在網路上,掃 key 的機器人是全自動的,被盜刷是遲早的事。
API key 不小心外洩了怎麼辦?
立刻去 Anthropic 後台把那把 key 作廢(revoke)、生一把新的,並更新你環境變數或 .env 裡的值。不要心存僥倖 —「只是貼在群組一下」「截圖有打碼一半」都算外洩,作廢重生只要 2 分鐘,被盜刷的額度可是真金白銀。順手檢查:程式碼裡有沒有寫死的 key、Git 歷史有沒有 commit 過 .env。
訂閱登入跟 API key 可以同時用嗎?
可以,而且是常見組合:平常人在電腦前用訂閱登入(包月划算),排程自動化的環境用 API key(按量計費、不用瀏覽器)。兩邊計費分開:訂閱的額度歸訂閱、API 的用量歸 API 帳單。我自己就是這樣配 — 日常開發走 Pro 訂閱,Threads bot 那類半夜自己跑的程式走 API。
看完這篇之前先確認:
- 第一次啟動卡在登入 瀏覽器沒跳出來
- 搞不清楚訂閱登入跟 API key 是不是同一回事
- 聽說 API key 不能亂放 想知道正確放法
- 還沒裝好 Claude Code (先看安裝排查)
- 帳號本身的問題 忘記密碼 (去 claude.ai 處理)
- 想找免登入免付費的用法 (沒有這種東西)
- 訂了 Pro 又去買 API 額度 — 訂閱登入就好 兩回事
- 把 API key 直接寫進程式碼 — 上傳到 GitHub 就是送人
- 在公司網路登入失敗一直重試 — 先換熱點分辨是網路還是帳號