
Claude API Key 怎麼取得?依照 Anthropic 官方文件,API Key 存放在 Claude Console 的 API keys 頁面,登入後點選「Create key」、命名、選擇到期時間並指定綁定的帳號,就能建立。完整的 Key 以 sk-ant- 開頭,只會在建立當下顯示一次,弄丟了無法再查看,只能重建。這篇文章帶你走完建立流程,說明官方的三種 Key 類型該怎麼選,再整理環境變數設定與 401、403 錯誤的排查方式。資料為 2026 年 11 月查閱的官方文件,介面可能調整,請以官方最新說明為準。
platform.claude.com/settings/keys),點「Create key」,命名、選到期時間、選綁定帳號,複製以 sk-ant- 開頭的 Key 並存到安全的地方,再設定成環境變數 ANTHROPIC_API_KEY。
本篇文章大綱
建立 API Key 的 4 個步驟
官方文件列出的步驟如下:
- 登入 Claude Console:到 platform.claude.com 登入,沒有帳號就先建立。
- 開啟 API keys 頁面:Console 的設定裡有 API keys 頁面。
- 建立 Key:按下「Create key」,為 Key 命名、選擇到期時間(expiration),並設定「Linked account」為自己或某個服務帳號。也可以選擇一個 workspace,把 Key 限縮在該範圍。
- 複製並保存:Console 只顯示一次完整 Key,請存進密碼管理工具或秘密管理服務。
如果「Create key」按鈕是灰色的,官方說明可能是你的角色沒有權限,請聯絡組織管理員調整角色,或請他替你的工作負載建立服務帳號 Key。
要先確認的是,這個流程和 claude.ai 的訂閱無關。訂閱與 API 的差別,見Claude 訂閱包含 API 嗎。

三種 Key 類型怎麼選
官方文件把 Key 分成三種:
| 類型 | 說明 | 適合 |
|---|---|---|
| 個人 Key(personal key) | 以你的身分運作,你離開組織後就失效 | 自己的開發與測試 |
| 服務帳號 Key(service account key) | 代表服務帳號,供 CI、正式服務或代理使用 | 團隊共用或正式環境 |
| Workspace Key | 沒有擁有者的舊式 Key,屬於建立它的 workspace | 官方不建議,偏好前兩者 |
官方的建議是:自己開發用個人 Key,凡是共用的用途都用服務帳號 Key。原因是個人與服務帳號 Key 會在對應帳號被移出組織時自動失效,比較不會留下遺漏的存取權。Key 到期設定可以降低外洩後被長期濫用的風險,具體的到期選項請看 Console 當下顯示。
免費領取《從零到百萬:新手快速提升行銷收入指南》
學會如何建立一套能 24 小時自動培養名單、自動化成交系統
環境變數與第一次驗證
官方 SDK 會自動讀取名為 ANTHROPIC_API_KEY 的環境變數。在 macOS 或 Linux,官方範例是:
export ANTHROPIC_API_KEY="your-api-key-here"Windows 的 PowerShell 可用 $env:ANTHROPIC_API_KEY = "..." 暫時設定,這是 PowerShell 的一般語法,不是官方文件的特別說明。
設定後,最快的驗證方式是跑官方快速入門的第一個請求。可以看Claude API 教學走完整流程,或直接選語言:Python、Node.js。
常見錯誤與保管原則
官方錯誤文件對應如下:
| 狀態碼 | 錯誤類型 | 常見原因 |
|---|---|---|
| 401 | authentication_error | Key 格式錯誤、已撤銷或已到期 |
| 402 | billing_error | 帳單或付款資訊有問題 |
| 403 | permission_error | Key 沒有該資源的權限,請檢查組織與 workspace 設定 |
| 429 | rate_limit_error | 超過速率限制或每月花費上限 |
每個回應都帶有 request-id,聯絡支援時附上可以加速處理。
保管原則可以整理成幾點(以下是通用的資安做法,並非官方逐字規範):
- 不要把 Key 寫進原始碼或提交到 Git。
- 前端網頁不要直接放 Key,應該透過後端呼叫。
- 為不同專案建立不同的 Key,方便個別撤銷。
- 懷疑外洩就到 Console 撤銷並重建。

API 的整體介紹與費用,見Claude API 是什麼。
官方沒有說明的部分
- 到期時間有哪些具體選項,取得 Key 的官方頁面沒有逐項列出。
- 官方 Key 頁面寫直接發送 HTTP 請求時用
Authorization: Bearer <key>,而快速入門的 curl 範例用的是x-api-key標頭;兩者如何並存,頁面沒有進一步說明。照官方快速入門的範例使用即可。 - 帳號開通後需要先儲值多少,本次查閱的取得 Key 頁面沒有說明。
- 如何偵測 Key 已外洩,官方該頁面沒有提供流程。
結論:建立很簡單,難的是保管
取得 Key 只要幾分鐘,但它代表你的帳單與權限。用個人 Key 開發、服務帳號 Key 上線,設定到期時間,並放進環境變數,就能避開大多數問題。拿到 Key 之後,下一步通常是認識Claude API 價格怎麼算,並在 Console 設定自己的花費上限。
常見問題 FAQ
API Key 弄丟了可以再看一次嗎?
不行。官方說明 Console 只在建立時顯示一次,弄丟只能重建。
沒有付費訂閱可以拿 API Key 嗎?
官方取得 Key 的頁面只要求 Console 帳號,訂閱與 API 是分開的。是否需要先儲值,官方該頁未說明。
Create key 按鈕不能按怎麼辦?
可能是角色權限不足,請組織管理員調整角色或幫你建立服務帳號 Key。
Key 要放哪裡?
建議放在環境變數或秘密管理服務,官方 SDK 會自動讀取 ANTHROPIC_API_KEY。
參考資料
- Claude 開發者文件:Get your Claude API key
- Claude 開發者文件:Get started
- Claude 開發者文件:API errors
- 圖片來源:George Becker、Uday Veeru(Pexels)
想建立 24/7 自動成交的課程獲利系統嗎?
如果你想建立的不只是電子報,而是一套真正能自動幫你成交的內容變現系統,那你可以進一步了解:
《百萬課程獲利藍圖:打造 24/7 幫你自動賣課的印鈔系統》
這套系統會完整分享:
- 如何建立高轉換Email名單
- 如何設計Lead Magnet
- 如何打造Email自動化流程
- 如何透過內容建立穩定現金流
- 如何讓線上課程24小時自動成交
即使沒有大量粉絲,也能透過內容、Email與自動化漏斗,慢慢建立穩定的獲利模式。

