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 3.5	$0.80 / 1M tokens	$4 / 1M tokens
Claude Sonnet 4	$3 / 1M tokens	$15 / 1M tokens
Claude Opus 4.1	$15 / 1M tokens	$75 / 1M tokens

以上是 2026-08-04 查閱官方價格頁時的示例，價格、模型與可用性可能更新；正式估算請以 Anthropic API pricing 為準。API 沒有固定月費，實際費用取決於輸入、輸出、快取、工具與請求量；建議在 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-20250514",
    "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-20250514",
    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-20250514",
    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-20250514",
  "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-3-5-haiku-20241022（速度快、費用低，適合分類任務）
System	`你是一個 email 分類助手。判斷這封 email 是否需要人工回覆。只回答 "yes" 或 "no"，不要其他文字。`
Message	`{{ $json.body }}`

用 Haiku 做分類、Sonnet 做生成，費用差 3 倍，但分類任務 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-20250514",
    max_tokens=1024,
    system=[
        {
            "type": "text",
            "text": "你是一個 NAS 技術支援助手...[很長的說明]",
            "cache_control": {"type": "ephemeral"}
        }
    ],
    messages=[{"role": "user", "content": "問題..."}]
)

加上 cache_control 後，可以讓重複的輸入使用快取價格；實際節省幅度取決於快取命中、寫入時間、模型與請求內容，請以官方定價規則計算。

常見問題

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），隨著累積用量提升等級。各 tier 的每分鐘請求數與 token 上限依模型不同且會調整，實際數字以 console 的 Limits 頁面顯示為準。

Q：要用哪個模型？ - 簡單分類、格式轉換：Haiku（最便宜） - 一般寫作、問答、分析：Sonnet（最常用） - 複雜推理、長文撰寫：Opus - 最難的推理與長時間 agent 任務：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-20250514，正式使用前請確認目前可用的 model ID。

資訊來源與版本限制

本文示範 Anthropic Messages API、Python SDK、curl 與 n8n 的基本串接，不是固定價格表或模型效能評測。API model ID、價格、rate limit、SDK 介面與快取計費規則都可能變動；正式環境請先閱讀官方文件、設定成本上限，並在非正式資料上測試。

🔗 延伸閱讀

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

—

關於作者 Dairny

15 年以上系統管理與 IT 維運經驗，NAS 從 FreeNAS 一路玩到 Synology。文章裡的每個步驟，都在自己的環境實際跑過。更多關於我 →