Claude API Key 怎麼申請？從付款設定到安全保存的完整教學

#API 金鑰 #Claude
目錄6 個章節

想用 Claude API，第一關不是寫程式。

而是先把 API Key 申請出來。

這件事本身不難，但 Anthropic 的流程有兩個地方很容易讓人卡住 API 使用的帳務和 Claude 對話版訂閱是分開的，而且 API Key 顯示出來後，通常只給你看一次。視窗關掉才發現沒保存，你只能重新建立一支KEY。

本文用我實際操作 Claude Console 的截圖，帶你完成以下流程：

  • 登入 Claude Console
  • 設定 Billing 與購買 credits
  • 建立 API Key
  • 設定 Key 名稱與有效期限
  • 安全保存 Key
  • 查看 API 使用量與花費

TL;DR

Claude API Key 要從 Claude Console 建立。先完成 Billing 設定，再到 API keys 建立 Key；建立後立刻複製到 .env 或密碼管理工具，因為 Key 通常不會再次完整顯示。API 的花費依實際使用量計算，最後要回到 Console 查看 credits 和使用費用。

Claude API 和 Claude Pro 是同一件事嗎？

不是。Claude API Key 是給程式呼叫 Claude API 使用的金鑰，API 費用依照 API 使用量計算；Claude 網頁版的 Free、Pro 或其他方案，則是另一套產品與帳務。

你可以把它想成兩個不同入口：

項目Claude 網頁版Claude API
使用方式在瀏覽器和 Claude 對話由程式或工具發送 API 請求
主要入口claude.aiplatform.claude.com
認證方式登入帳號API Key 或其他 API 認證方式
計費方式依訂閱方案依 API 實際使用量與帳務設定
適合情境手動聊天、整理資料自動化、網站、工具、批次處理

所以，就算你已經可以在 Claude 網頁版聊天，也不代表程式已經能直接呼叫 Claude API。

Anthropic 官方文件目前建議從 Claude Console 產生 API Key，並在建立 Key 時設定有效期限；正式環境則應該搭配 secrets manager、定期輪替金鑰。詳情可以參考官方 Authentication 文件。

怎麼申請 Claude API Key？

四步，從登入 Console 到建立金鑰。

Step 1. 開啟 Claude Console 並登入

前往 Claude Console，使用 Email、Google 或 SSO 登入。如果你還沒有 Anthropic 的 Console 帳號，就依畫面指示完成註冊。

登入後會先看到 Dashboard。左側選單有 API keys，右上角也可能看到 Get API key 按鈕。

claude-api-key-apply-01.png

圖 1：Claude Console Dashboard，左側的 API keys 是管理 API Key 的入口。

💡 Claude Console 的版面會更新。如果你找不到左側的 API keys，也可以到帳號設定或 Settings 裡尋找 API keys；重點是找到「管理 API 金鑰」的頁面。

Step 2. 為 API 使用設定 Billing

第一次進入 API keys 頁面時，可能會看到 Set up billing，而不是直接看到建立金鑰的按鈕。

這代表帳務還沒設定完成。點擊 Set up billing，進入付款與 credits 設定。

claude-api-key-apply-02.png

圖 2：API keys 頁面顯示 Set up billing，表示要先完成帳務設定。

進入 Billing 頁面後，依目前帳號可用的選項購買 credits 或設定付款方式。畫面中的 Buy credits 就是購買 API 使用額度的入口。

claude-api-key-apply-03.png

圖 3：Billing 頁面的 Buy credits 按鈕，用來購買 API 使用 credits。

這裡有三件事要先講清楚：

  1. API 是依用量計費，不是登入後就能無限免費使用。
  2. credits、付款方式、可用額度和帳戶資格，可能會依地區、帳戶類型或 Anthropic 當時的政策不同而變化。
  3. 不要直接照抄截圖裡的金額或限制，請以你自己帳號目前看到的數值為準。

我自己的做法是先放一個小額度測試，除非你的特殊能力跟蝙蝠俠一樣(超級有錢，銀彈無限)。完成後回到 Dashboard，就能看到目前 credits 和本月使用情況。

claude-api-key-apply-04.png

圖 4：完成 Billing 後，Dashboard 會顯示 organization credits 與本月使用量。畫面上的金額只是當時帳號的實際狀態，不代表每個帳號都相同。

Step 3. 開啟 API keys 頁面並建立金鑰

回到左側的 API keys。如果帳務設定完成，頁面右上角會出現 Create key。

點擊它，開始建立新的 API Key。

claude-api-key-apply-05.png

圖 5：在 API keys 頁面點擊右上角的 Create key。

建立 API Key 時，這把 Key 會屬於目前選擇的 workspace。Anthropic 官方文件也建議用 workspace 區分不同專案或環境，這樣日後看花費和撤銷權限會比較容易。

Step 4. 設定 Key 名稱與有效期限

建立視窗會要求你填寫兩個重要欄位：Name 和 Expires。

Name：用專案和環境命名

不要只輸入 test、key1 這種三個月後連自己都看不懂的名稱。建議把用途寫進去，例如：

halfmemo-blog-test
claude-tool-test
customer-a-reporting-staging

名稱的目的不是讓 API 判斷功能，而是讓你之後管理金鑰時，知道這把 Key 是哪個專案在使用。

Expires：能短就不要永久

你可以設定 Key 的有效期限。測試用途可以選 1 day 或 7 days；長期服務則依實際需求選擇期限，並安排定期輪替。

claude-api-key-apply-06.png

圖 6：建立 API Key 時設定 workspace、名稱與有效期限。測試用 Key 可以設定短一點，降低遺失後的風險。

我的建議很簡單：測試 Key 用短期限，正式服務才考慮長期限，而且一定要放進 secrets manager。

期限越長，管理起來越省事；但如果 Key 不小心外洩，能造成麻煩的時間也越長。這是方便和安全之間的取捨，不是按下「Never」就代表系統自動幫你保管一輩子。

設定好後按 Add，建立這把 Key。

拿到 Key 之後要注意什麼？

三件事：Key 只顯示一次、清單裡看不到完整內容、花費要回來看。

Step 5. API Key 只顯示一次，立刻保存

建立完成後，Claude Console 會跳出 Save your API key 視窗。這時候請先不要急著按 Done。

先按 Copy key，把完整 Key 複製下來，立刻保存到密碼管理工具或專案的 .env 檔案。

claude-api-key-apply-08.png

圖 7：API Key 完整值只在建立完成時顯示，請先複製保存，再按 Done。圖片中的 Key 已遮蔽，實際使用時不要公開貼出完整內容。

請注意，API Key 是密碼，不是一般設定值。以下幾種做法都不要做：

  • 不要把 Key 貼到 GitHub、GitLab 或公開 Gist
  • 不要直接寫進前端 JavaScript，因為使用者可以在瀏覽器看到
  • 不要放進 README.md、教學截圖或聊天群組
  • 不要把 .env 加進版控
  • 不要把真正的 Key 填進 .env.example

本機開發可以這樣保存：

# .env
ANTHROPIC_API_KEY=你的_API_Key

.env.example 只放欄位名稱和假值：

# .env.example
ANTHROPIC_API_KEY=

程式或官方 SDK 通常會讀取 ANTHROPIC_API_KEY 環境變數。官方 Quickstart 也是採用環境變數保存 Key，再由 SDK 或 API 請求使用；不要把金鑰直接寫死在程式碼裡。

Step 6. 確認 Key 已建立，但不要把遮罩當成完整 Key

回到 API keys 清單後，可以看到剛才建立的 Key 名稱、建立者、建立日期、到期日和最後使用時間。

claude-api-key-apply-07.png

圖 8：API keys 清單只顯示 Key 的部分資訊，方便辨識與管理；完整內容不會再次顯示。

這個頁面適合用來做三件事：

  • 確認 Key 是否真的建立成功
  • 查看 Key 的到期日
  • 發現不用的 Key 後撤銷或刪除

如果你剛才忘記複製完整 Key，不要一直在清單裡找「顯示完整內容」按鈕。正確做法是撤銷遺失的 Key，再建立一把新的。

Step 7. 觀察 API 花費，避免 credits 默默變少

建立 Key 不代表馬上會產生費用，真正呼叫 API、使用模型或其他計費功能後，才會依用量產生花費。

Dashboard 可以看到 organization credits 和本月使用量。以下截圖顯示當時已使用 US$0.02，剩餘 credits 為 US$9.98；這只是一次實際測試的數據，不是固定費率。

claude-api-key-apply-09.png

圖 9：Dashboard 顯示剩餘 credits 與本月花費。實際金額會隨你的 API 呼叫而變化。

如果要看更詳細的統計，可以進入使用量頁面，查看總花費、Token 花費，以及依日期或模型分類的使用情況。

claude-api-key-apply-10.png

圖 10：Usage 頁面可以查看總花費、Token 花費與各模型的使用量。

我建議每次做完新的自動化工具後，都回來看一下這個頁面。尤其是批次處理、迴圈呼叫或把 API 接到網站之後，最容易出現「我只是測一下，怎麼 credits 少了一截」的驚喜。

官方定價與付款方式會調整，實際金額請以官方 Pricing 文件和 Console 顯示為準。

API Key 申請完成後，怎麼做第一次測試？

先把 Key 放進環境變數，再用官方 SDK 或 API 發送測試請求。以 PowerShell 為例：

$env:ANTHROPIC_API_KEY = "你的_API_Key"

如果你使用 Python SDK，程式可以讓 SDK 自動讀取環境變數：

from anthropic import Anthropic

# Client 會從 ANTHROPIC_API_KEY 環境變數讀取 API Key。
client = Anthropic()

message = client.messages.create(
    model="claude-opus-4-8",
    max_tokens=100,
    messages=[
        {"role": "user", "content": "請用一句話介紹你自己。"}
    ],
)

print(message.content[0].text)

如果出現 401 authentication_error，通常是 Key 無效、過期、被撤銷，或環境變數沒有正確載入；如果出現 402 billing_error，則要回 Claude Console 檢查 Billing 和付款資訊。

⚠️ 上面的 model 名稱和 API 參數可能會隨 Anthropic 文件更新。正式開發前，請以官方 Get started 文件的目前範例為準。

常見問題

Q：有 Claude Pro，就可以直接使用 Claude API 嗎？ A：不一定。Claude 網頁版訂閱和 Claude API 是不同產品，API 仍需要在 Claude Console 設定 API Key 與 Billing。

Q：API Key 忘記複製，還能重新查看嗎？ A：目前不能。回到 API keys 清單只能看到遮罩後的資訊，建議撤銷舊 Key，再建立一把新的。

Q：API Key 可以永久不過期嗎？ A：依目前 Console 提供的選項可能可以設定較長期限或不過期，但測試用途不建議這樣做。期限越短，Key 外洩後的風險窗口越小；長期服務則應搭配安全的 secrets manager 和定期輪替。

Q：API 使用一定要先買 credits 嗎？ A：要看你的帳號和當時平台提供的 Billing 方案。若 API keys 頁面要求先 Set up billing，就必須先完成付款或 credits 設定；請以你在 Console 看到的選項為準。

我的建議：一個專案一把 Key

如果只是自己在本機測試，我會建立一把專案專用、期限較短的 Key；正式服務則依環境拆成 development、staging、production，並且不要共用同一把金鑰。

這樣做的好處是：哪個專案出問題比較容易查，哪把 Key 外洩也比較容易撤銷，不用為了救一個測試環境，把整間 API 工廠的電源總開關都關掉。

API Key 申請只是開始，真正重要的是後面的保存、輪替和花費監控。把這三件事做好，之後不管是接 Claude Code、自製工具，還是自己的網站，都會安心很多。