Claude API 怎麼用？申請金鑰、環境設定與 Python 串接教學整理

串接 AI 模型的 API 早就不是工程師的專利。現在 Claude API 的設計已經很貼近一般開發者的使用習慣，只要掌握正確的操作流程，從申請金鑰到發出第一個請求，整個過程通常不用半個小時。這篇文章整理了從註冊帳號、金鑰生成、環境變數設定到程式碼呼叫的完整步驟，同時會說明不同模型層級的定位，幫助大家在實作時選對模型、控制預算並避開常見的連線錯誤。

Claude API 有哪些存取方式？兩種核心金鑰類型整理

在開始之前，有一個常讓新手困惑的地方值得先釐清：Claude API 在 2026 年有兩種不同的認證方式，搞錯的話可能導致非預期的帳單或配額耗盡。

API Key（sk-ant-api03- 開頭）：在 Anthropic 開發者主控台建立，採按量計費（pay-as-you-go）。適合：需要正式串接的應用程式、自動化流程、後端服務。

OAuth Token（sk-ant-oat01- 開頭）：綁定 Claude.ai 的 Pro 或 Max 訂閱帳號。使用時會消耗訂閱配額，適合個人實驗或小規模使用，但不適合生產環境的自動化應用。

一般開發或串接教學所說的「Claude API Key」，指的是 API Key（sk-ant-api03-），不是 OAuth Token。

Claude API 金鑰怎麼申請？五大核心步驟完整教學

步驟 1：建立 Anthropic 開發者帳號

前往 console.anthropic.com（會自動跳轉至 platform.claude.com），使用 Email/密碼、Google OAuth 或 SSO 完成註冊。

步驟 2：設定帳單方式

進入帳號後，前往 Settings → Billing，加入信用卡資訊。Claude API 採按量計費，建議開發初期設定 $10–$25 的月費上限，避免測試期間產生非預期費用。

步驟 3：建立 API Key

點選左側選單的 API Keys
點選 Create Key
為 Key 取一個有意義的名稱（例如：my-chatbot-dev、production-webapp）——這在管理多個 Key 時非常重要
立即複製並保存 Key——完整 Key 只會顯示一次，之後只能看到前幾個字元

步驟 4：安全儲存 API Key

API Key 等同密碼，需要謹慎保管。

最佳做法：使用環境變數

# 加入 ~/.zshrc 或 ~/.bashrc
export ANTHROPIC_API_KEY="sk-ant-api03-你的key"

# 套用設定
source ~/.zshrc

或使用 .env 檔案（搭配 python-dotenv）：

# .env 檔案
ANTHROPIC_API_KEY=sk-ant-api03-你的key

絕對不可以做的事： 將 Key 直接寫入程式碼或上傳至 GitHub。一旦 Key 外洩，需立即到 Console 撤銷並重新生成。

步驟 5：確認 Key 生效

Key 生成並存入環境變數後，用以下指令確認設定是否正確：

echo $ANTHROPIC_API_KEY

如果正確顯示以 sk-ant-api03- 開頭的字串，代表環境變數設定成功。

Claude API 請求怎麼發出？Python 與 Node.js 程式碼範例

環境設定完成後，可以用 Python 或 Node.js 發出第一個請求。

Python 範例

首先安裝 SDK：

pip install anthropic

接著建立 first_call.py：

import anthropic

# SDK 自動讀取 ANTHROPIC_API_KEY 環境變數
client = anthropic.Anthropic()

response = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "請用繁體中文說明 Claude API 是什麼？"}
    ]
)

print(response.content[0].text)

Node.js 範例

安裝 SDK：

npm install @anthropic-ai/sdk

建立 first_call.js：

import Anthropic from '@anthropic-ai/sdk';

const client = new Anthropic();

const response = await client.messages.create({
  model: 'claude-sonnet-4-6',
  max_tokens: 1024,
  messages: [
    { role: 'user', content: '請用繁體中文說明 Claude API 是什麼？' }
  ],
});

console.log(response.content[0].text);

Claude API 模型有哪些規格？三大模型層級與計費對照

Anthropic 在 2026 年提供三個主要模型層級，各有不同的效能與成本定位：

模型	模型代碼	輸入	輸出	適合場景
Opus 4.6	`claude-opus-4-6`	$5/MTok	$25/MTok	複雜推理、深度分析、企業 Agent
Sonnet 4.6	`claude-sonnet-4-6`	$3/MTok	$15/MTok	多數開發任務、日常串接
Haiku 4.5	`claude-haiku-4-5`	$1/MTok	$5/MTok	高頻率輕量任務、即時回應

選擇建議： 大多數開發者日常任務從 Sonnet 4.6 開始，複雜推理或 Agent 系統再考慮 Opus 4.6；需要控制成本的高頻應用選 Haiku 4.5。

Claude API 費用怎麼節省？三大成本控制技巧整理

Prompt Caching（提示快取）
當 System Prompt 或大段背景資料重複使用時，可以啟用 Prompt Caching，讓後續請求跳過重新處理這部分內容，最高可降低 90% 的快取部分費用。適合需要重複提供大量背景說明的應用。
Batch Processing（批次處理）
不需要即時回應的任務（如批量翻譯、大量文件分析），使用 Batch API 可享有 50% 折扣。資料在 24 小時內處理完成，適合排程式的資料處理工作。
設定月費上限
在 Console 的 Billing 頁面設定月費上限，當費用達到上限時 API 會暫停運作而非持續計費。開發初期強烈建議設定 $10–$25 的上限作為安全網。

Claude API 流程怎麼自動化？客服回信場景應用範例

掌握基礎 API 呼叫之後，可以進一步將 Claude 整合進自動化工作流程。以下是一個常見的實際應用場景：

場景：自動處理客服回信

從資料庫或 Email 讀取新進客服訊息
將訊息傳入 Claude API，System Prompt 設定為客服回覆規範
接收 Claude 生成的回覆草稿
記錄至資料庫或直接發送（視工作流程而定）

Claude API 錯誤怎麼排解？常見失敗原因與解決方法

錯誤：AuthenticationError: Invalid API key

原因：Key 未正確設定或已被撤銷。確認環境變數是否正確設定，或嘗試重新生成 Key。

錯誤：RateLimitError

原因：超過每分鐘或每日的請求上限。新帳號有較低的速率限制，使用量增加後可申請提升。可在 Console 的 Rate Limits 頁面查看當前限制。

錯誤：OverloadedError

原因：API 端服務繁忙，非帳號問題。建議加入指數退避（exponential backoff）重試邏輯。

費用超出預期

排查方向：確認是否誤用了 OAuth Token 消耗訂閱配額，或 max_tokens 設定過高。也可以在 Console 的 Usage 頁面查看各模型的用量明細。

串接金鑰並發出第一個請求只是起步，後面還有很多進階功能值得嘗試。當基礎的呼叫沒問題之後，可以試著把這些流程跟日常的工作串聯起來，像是結合資料庫做自動化串接，或是搭配其他工具打造自動化腳本。隨著 API 功能不斷翻新，後續還能進一步研究直接操作介面的功能，讓這套工具在實際應用中發揮更大的效益。

常見 FAQ

Q：Claude API Key 要怎麼申請？

前往 console.anthropic.com，建立帳號並設定帳單後，在 Settings → API Keys 點選 Create Key 即可生成。Key 只顯示一次，需立即複製保存。

Q：Claude API 免費嗎？

Claude API 採按量計費，沒有永久免費額度，但新帳號可能有初始試用額度。開發初期建議設定月費上限，費用依模型和使用量而定。

Q：API Key 和 Claude Pro 訂閱有什麼差別？

兩者完全獨立。API Key 用於開發者串接，採按 token 計費；Claude Pro 是 claude.ai 的訂閱方案，供個人在網頁和 App 使用，不能互通。

Q：哪個 Claude 模型適合新手入門？

建議從 Sonnet 4.6（claude-sonnet-4-6）開始——效能與成本的平衡最佳，適合多數開發需求，確認用途後再考慮是否升級 Opus 4.6 或降級 Haiku 4.5。

Q：如何確認 API Key 是否有效？

發送一個簡單的測試請求，如果收到正常回應代表 Key 有效。若收到 AuthenticationError，請確認環境變數設定正確，或至 Console 確認 Key 狀態是否為 Active。