Claude API 入門：取得 API Key、發第一支請求、整合 n8n

Claude API 請求流程

Claude.ai 網頁版適合對話，但如果你想把 Claude 整合進自己的工具——n8n 工作流、自架服務、Python 腳本——就需要 Anthropic API。

這篇從申請 API Key 開始，到發出第一支請求，再到實際整合進 n8n。

取得 API Key

申請步驟

前往 console.anthropic.com
用 Google 帳號或 Email 註冊
左側選單 → API Keys → Create Key
給這個 Key 一個名稱（例如 n8n-production）
複製 Key（只顯示一次，要妥善保存）

API Key 格式

sk-ant-api03-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

費用

Anthropic API 按用量計費（pay-as-you-go），沒有月費。

模型	輸入	輸出
Claude Haiku 4.5	$1 / 1M tokens	$5 / 1M tokens
Claude Sonnet 4.6	$3 / 1M tokens	$15 / 1M tokens
Claude Opus 4.8	$5 / 1M tokens	$25 / 1M tokens

一般使用量下，一個月費用通常在幾美元到幾十美元之間。可以在 console 設定用量上限避免超支。

發第一支請求

curl（最快測試）

curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "用一句話解釋什麼是 NAS"}
    ]
  }'

把 $ANTHROPIC_API_KEY 換成你的 Key。

Python SDK

pip install anthropic

import anthropic

client = anthropic.Anthropic(api_key="sk-ant-api03-xxx")

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "用一句話解釋什麼是 NAS"}
    ]
)

print(message.content[0].text)

System Prompt

大多數應用會用到 system prompt 設定 AI 的角色和規則：

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    system="你是一個 NAS 技術支援助手。回答問題時用繁體中文，語氣親切但專業。如果不確定，說不確定，不要猜測。",
    messages=[
        {"role": "user", "content": "我的 Synology NAS 無法開機怎麼辦？"}
    ]
)

回應結構

API 回傳的 JSON：

{
  "id": "msg_01xxxx",
  "type": "message",
  "role": "assistant",
  "content": [
    {
      "type": "text",
      "text": "NAS（Network Attached Storage）是一種透過網路提供儲存空間的裝置。"
    }
  ],
  "model": "claude-sonnet-4-6",
  "stop_reason": "end_turn",
  "usage": {
    "input_tokens": 20,
    "output_tokens": 35
  }
}

content[0].text 是 Claude 的回應文字，usage 是這次呼叫消耗的 token 數。

整合進 n8n

如果你的 NAS 上有跑 n8n，可以把 Claude API 串進工作流，做自動化 AI 處理。

設定 Credentials

n8n → 左側 Credentials → Add Credential
搜尋 Anthropic
輸入你的 API Key
儲存

基本 Workflow：自動分類 Email

這個範例每小時掃描收到的 email，用 Claude 判斷是否需要回覆：

[Schedule Trigger] → [Gmail: Get Messages] → [Anthropic: Message] → [IF: 需要回覆] → [Gmail: Send Reply]

Anthropic 節點設定：

欄位	值
Credential	你剛設定的 Anthropic Credential
Model	claude-haiku-4-5（速度快、費用低，適合分類任務）
System	`你是一個 email 分類助手。判斷這封 email 是否需要人工回覆。只回答 "yes" 或 "no"，不要其他文字。`
Message	`{{ $json.body }}`

用 Haiku 做分類、Sonnet 做生成，費用差 4 倍，但分類任務 Haiku 就夠了。

基本 Workflow：自動摘要 RSS

每天抓取 RSS，用 Claude 幫你整理成摘要：

[Schedule: 每天早上 8 點] → [HTTP Request: 取得 RSS] → [XML: Parse] → [Anthropic: 摘要] → [Email/Notion: 寄出]

Prompt Caching（降低費用）

如果你的 system prompt 很長（幾千 token），每次呼叫都要重複計費。Prompt Caching 讓同樣的內容只計費一次：

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    system=[
        {
            "type": "text",
            "text": "你是一個 NAS 技術支援助手...[很長的說明]",
            "cache_control": {"type": "ephemeral"}
        }
    ],
    messages=[{"role": "user", "content": "問題..."}]
)

加上 cache_control 後，同樣的 system prompt 在 5 分鐘內再次呼叫，費用降低 90%。對高頻呼叫的應用很有效。

常見問題

Q：API 和 Claude Pro 訂閱是不同的帳戶嗎？ 是的。API 在 console.anthropic.com，按用量計費，不包含 Claude.ai 網頁版的使用。Claude Pro 是網頁版訂閱，不包含 API 用量。

Q：API Key 泄漏怎麼辦？ 馬上到 console.anthropic.com → API Keys 刪掉那個 Key，然後建立新的。API Key 不要直接寫在程式碼裡，用環境變數或 .env 檔案存放，並確保不提交到 git。

Q：rate limit 是多少？ 新帳號有較低的 rate limit，隨著使用量和帳齡提升。目前 Tier 1（新帳號）限制：每分鐘 50 requests，每天 50,000 tokens。可以在 console 查看你目前的 tier 和限制。

Q：要用哪個模型？ - 簡單分類、格式轉換：Haiku（最便宜） - 一般寫作、問答、分析：Sonnet（最常用） - 複雜推理、長文撰寫：Opus（最強但最貴）

大多數應用從 Sonnet 開始，需要降費用換 Haiku，需要更好品質換 Opus。

小結

Claude API 的核心流程： 1. console.anthropic.com 申請 API Key 2. POST /v1/messages 發請求，帶上 model、messages、max_tokens 3. 整合到 n8n 或自己的程式

費用從每月幾美元起，高頻應用搭配 Prompt Caching 降低成本。從 claude-sonnet-4-6 開始，有需要再換模型。

🔗 延伸閱讀

這篇有幫助嗎？ API 讓 Claude 成為你應用程式的一部分。

—