Claude Code 怎麼登入？API Key 跟訂閱別搞混
文 / Coolkid發布：2026-07-19 · 最後更新：2026-09-01閱讀約 8 分鐘
短答給趕時間的人：Claude Code 有兩種身分驗證方式，搞混會多花錢。第一種是訂閱制，多數人走這條。有 Pro(US$20/月)就在第一次啟動時用瀏覽器登入 Anthropic 帳號，完成授權即可使用，完全不用碰 API key。第二種是 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 再重新登入 | 換環境變數的值 |
判斷方法一句話就講完。
你是「人坐在電腦前用」，走訂閱登入。
你要「程式在沒有人的時候自己跑」，像是排程機器人、伺服器上的自動化，那個環境才需要 API key。
我自己的 Threads 機器人跟 LINE 機器人都是後者，但我平常做網站、寫東西的時候，全部都是訂閱登入。
訂閱登入的 3 個常見卡點
- 瀏覽器沒自動跳出：終端機上其實印了一條授權網址，手動複製到瀏覽器開，登入完成就接上了。常發生在預設瀏覽器設定怪怪的機器上。
- 公司網路卡在授權頁：有些公司防火牆會擋外部的授權流程。分辨的方法是手機開熱點讓電腦連，能登就是公司網路的事，找 MIS 處理；還是不能登，才是帳號問題。
- 登入了卻說沒有權限：通常是帳號沒有有效訂閱，免費帳號登入不能用 Claude Code；也可能是登到另一個帳號，公司信箱跟個人信箱搞混。打 /logout 登出，確認用有訂閱的那個帳號重登。
這三個卡點，我自己或幫別人排查的時候全都遇過。
共通點是什麼？問題幾乎都不在 Claude Code 本身。
而是瀏覽器、公司網路、帳號，這三件周邊的事。
API key 的正確放法(安全鐵律，別跳過)
先講怎麼拿到 key，再講怎麼安全地放。
第一步，到 console.anthropic.com 登入。左邊選單點 API Keys，再點 Create Key，取個名字，key 就生好了。這串 key 只會顯示一次，關掉就看不到了，要馬上複製存起來。
第二步，加信用卡。左邊選單的 Billing 進去設定付款方式。沒加的話 key 生了也不能用，跑程式會回錯誤。
新帳號通常有一小筆免費試用額度，實際金額以後台 Billing 頁面顯示為準，用完才開始扣卡。
key 拿到之後，下一步是放到對的地方。這邊有一條鐵律。
如果你走 API 這條，先記住一條鐵律：key 絕對不寫進程式碼。
API key 等於你的錢包。
寫在程式裡、跟著上傳 GitHub，等於把錢包公開在網路上，有人撿到就能燒掉你的額度，而且這種盜刷每天都在發生。
掃 GitHub 找 key 的機器人是全自動的。
正確做法是什麼？放環境變數，程式執行的時候才讀進來：
# 當次測試(PowerShell):
$env:ANTHROPIC_API_KEY = 'sk-ant-你的key'
# 永久設定(使用者層級):
[Environment]::SetEnvironmentVariable('ANTHROPIC_API_KEY', 'sk-ant-你的key', 'User')設完重開終端機才會生效。
專案要分開管理的話，把 key 放在專案資料夾的 .env 檔。
.env 要存 UTF-8 但是不要 BOM，原因看編碼那篇，另外要確認 .gitignore 有擋住 .env，這樣程式讀得到、Git 也傳不出去。
萬一 key 不小心外洩了怎麼辦？貼到公開的地方、傳給別人看過，都算外洩。
去後台把那把 key 作廢、生一把新的，別心存僥倖。
三不：不寫進程式碼、不傳進聊天室 / 截圖、不 commit 進 Git。一要：洩漏就立刻作廢重生。
Claude Code 身分驗證有兩條路。第一條是訂閱登入，有 Pro(US$20/月)的人第一次啟動用瀏覽器授權就能用，不用碰 API key。卡住的話查三點：授權網址手動複製開、換熱點分辨是不是公司網路的問題、打 /logout 確認登對帳號。第二條是 API key，給自動化排程這種「沒有人在場」的場景。申請三步：到 console.anthropic.com 生 key（只顯示一次要馬上複製）、去 Billing 加信用卡、設 ANTHROPIC_API_KEY 環境變數。新帳號通常有免費試用額度，用完按 token 計費。安全鐵律：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 讀試算表。
- token（字元計費單位）
- AI 讀寫文字的計量單位，一個中文字約 1-2 個 token。訂閱方案的用量限制、API 的計費都是按 token 算，所以「講重點、少貼無關內容」直接等於省錢。
如果內容對你有用就太好了
隨喜斗內
常見問題FAQ
Claude Code 需要 API key 嗎？
多數人不需要。有 Pro 訂閱(US$20/月)的話，第一次啟動時用瀏覽器登入 Anthropic 帳號授權就能用，完全不碰 API key。需要 API key 的是「程式在沒有人的時候自己跑」的場景，像是排程機器人、伺服器自動化。那個執行環境沒辦法開瀏覽器登入，才用 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 機器人那類半夜自己跑的程式走 API。
Claude API key 怎麼申請？
到 console.anthropic.com 登入，左邊選單點 API Keys，再點 Create Key，取個名字就生好了。key 只會顯示一次，要馬上複製存起來。第一次用 API 還要去 Billing 加信用卡，沒加的話 key 有了也不能用。生好之後設成 ANTHROPIC_API_KEY 環境變數，Claude Code 啟動時就會自動讀到。
Claude API 有免費額度嗎？
新帳號通常有一小筆免費試用額度，實際金額跟期限以 console.anthropic.com 後台的 Billing 頁面為準，用完之後按 token 用量計費。如果你只是「人坐在電腦前用 Claude Code」，走 Pro 訂閱（US$20/月）就好，不需要碰 API，也不用擔心按量計費的事。
看完這篇之前先確認:
- 第一次啟動卡在登入 瀏覽器沒跳出來
- 搞不清楚訂閱登入跟 API key 是不是同一回事
- 聽說 API key 不能亂放 想知道正確放法
- 還沒裝好 Claude Code (先看安裝排查)
- 帳號本身的問題 忘記密碼 (去 claude.ai 處理)
- 想找免登入免付費的用法 (沒有這種東西)