Claude API 指南：定價、設定與您的第一個請求

要發出您的第一個 Claude API 請求，請建立一個 Claude Console 金鑰，將其儲存於環境變數中，呼叫 Messages 端點，並讀取回傳的 用法 欄位，並計算代幣成本。本指南將以 2026 年 9 月 8 日已驗證的最新模型 ID 和價格為例，逐步說明此流程。.

一旦理解了 API 路徑，接下來的問題就是：日常工作中究竟有多少部分真正需要自訂整合？就研究、寫作、編碼和創意製作而言，, GlobalGPT 提供了一種更經濟的方式，讓您能將 Claude 與 GPT-5.6 Sol、Gemini 3 Pro、Kimi K3 及其他領先機型搭配使用。 單一訂閱即可將這些模型與一套廣泛的 AI 工具整合至單一儀表板中，讓工作流程能從構思一路推進至產出，無需在不同服務之間來回切換。當您確實需要將 AI 整合至開發環境時，GlobalGPT CLI 能將同一工作區與您的終端機及現有生產工具相連。.

試試 Claude Opus 5

什麼是 Claude API？

Claude API 是 Anthropic 提供的一套開發者介面，用於從應用程式、腳本或後端服務向 Claude 模型發送結構化請求。您只需將訊息傳送至 HTTPS 端點，即可收到包含生成內容以及模型、中斷原因和代幣使用狀況等元資料的結構化回應。.

Claude API 與 Claude.ai 訂閱方案的比較

API 存取權限與 Claude.ai 訂閱服務分別用於處理不同的任務。 Claude.ai 的方案可讓使用者存取 Anthropic 的聊天產品。API 則是透過 Claude 控制台提供的計量式開發者存取服務，並依據使用量進行獨立計費。Anthropic 的說明中心指出，Claude Pro 方案不包含控制台 API 的使用權限。.

若您需要進一步了解消費者方案、Claude 代碼與代幣計費之間的差異，請參閱我們的完整 Claude 定價指南. 在本教學中，重點很簡單：請將 API 帳戶的建立與資金存入，與任何 Claude.ai 訂閱分開處理。.

邁向首次請求的五步驟指南

1. 在 Claude 控制台中建立一個 API 金鑰。.
2. 請將其存放於 ANTHROPIC_API_KEY 環境變數。.
3. 向以下對象發送請求： https://api.anthropic.com/v1/messages.
4. 讀取傳回的內容，並 用法 物件。.
5. 將每個代幣類別乘以其對應的「每百萬枚代幣」費率。.

Claude API 定價與現行模型 ID

Anthropic 將 API 價格以每百萬個代幣（常簡稱為 MTok）的美元為單位列出。輸入與輸出會分別計費。由於提示字串快取會針對五分鐘寫入、一小時寫入及快取讀取設定不同的費率，因此若要獲得可靠的估算，應將這些類別分開計算。.

現行機型與確切的 API ID

進行本教學時，您應該使用哪一款機型？

所使用的官方快速入門指南 克勞德-作品第5號 由於本指南經核實時的情況，因此下文的 cURL 和 Python 範例均使用相同的 ID。請將 Opus 視為本教學的起點，接著根據工作負載、品質需求、延遲及預算來選擇生產環境的模型。模型 ID 和生命週期狀態可能會變更，因此在部署長期運行的程式碼之前，請務必重新查閱「模型」和「已廢棄功能」頁面。.

首次提出申請前您需要準備的事項

建立 Claude 控制台帳戶及 API 金鑰

開啟 Claude 控制台，建立或選取適當的組織，並建立一個 API 金鑰。Anthropic 會提示，新金鑰僅會顯示一次，因此當金鑰出現時，請將其儲存於經核准的機密管理工具或其他安全位置。請勿將金鑰放入螢幕截圖、共享文件、公開儲存庫或瀏覽器端的 JavaScript 中。.

將金鑰儲存於環境變數中

這些範例預期變數 ANTHROPIC_API_KEY. 請僅在您的私人終端機或機密管理系統中輸入實際數值。以下指令會讀取該數值而不將其顯示於螢幕上，然後將其匯出至當前的 shell 工作階段：

read -s ANTHROPIC_API_KEY
export ANTHROPIC_API_KEY

環境變數雖能降低意外洩露的風險，但並非一套完整的機密管理策略。生產環境的應用程式應遵循託管平台的機密儲存與存取控制規範。.

檢查帳單並設定安全的測試限額

API 計費與 Claude.ai 訂閱是分開的。Anthropic 指出，大多數組織會預付使用額度，而採用每月開立發票的組織則屬例外。請確認您的控制台帳戶能夠發出 API 請求，然後將首次請求的量控制在較小範圍，例如： max_tokens：128. 該欄位僅會限制產生的輸出量；它並不會預留或保證 128 個計費輸出代幣。.

使用 cURL 發送您的第一個 Claude API 請求

cURL 非常適合直接檢視請求內容。以下範例使用了 Messages 端點、JSON 內容類型、API 金鑰標頭、Anthropic 的版本標頭、已驗證的 Quickstart 模型 ID，以及一則使用者訊息。.

在執行任何範例之前，請先新增您自己的 API 金鑰，並確認該組織已啟用 API 計費功能。此程式碼遵循 Anthropic 文件中所述的請求格式，且已通過本地語法檢查，但此處未包含實際帳戶的回應。.

curl https://api.anthropic.com/v1/messages \
  --header "content-type: application/json" \
  --header "x-api-key: $ANTHROPIC_API_KEY" \
  --header "anthropic-version: 2023-06-01" \
  --data '{
    "model": "claude-opus-5",
    "max_tokens": 128,
    "messages": [{
 "role": "user",
 "content": "請用一句話說明什麼是 API。"
    }]
  }'

各標頭與 JSON 欄位的用途

若指令傳回錯誤，請先讀取 HTTP 狀態碼和錯誤類型，再修改請求。認證和計費錯誤需透過帳戶設定來解決，而 JSON 格式錯誤或模型 ID 無效的情況，則需修改請求內容。.

使用 Python SDK 傳送相同的請求

安裝官方 Anthropic SDK

python -m pip install anthropic

若虛擬環境是您日常 Python 工作流程的一部分，請使用虛擬環境。SDK 會讀取 ANTHROPIC_API_KEY 當……時，從環境中 anthropic.Anthropic() 是在未指定明確金鑰的情況下建立的。.

執行等效的 Python 請求

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-opus-5",
    max_tokens=128,
    messages=[
 {
 "role": "user",
 "content": "請用一句話解釋什麼是 API。",
 }
    ],
)

for block in message.content:
    if block.type == "text":
    print(block.text)

print(message.usage)

安全地讀取傳回的文字

由於訊息回應可能包含多個內容區塊，因此此範例會在輸出文字前先檢查每個區塊的類型。實際應用中，也應保留請求 ID 以供技術支援與記錄之用（但切勿對外公開），並記錄回傳的模型與中斷原因，同時明確處理 API 錯誤。.

即使預期會收到簡短的文字回答，也請保留內容區塊的檢查。這樣一來，當回應包含多個區塊時，便能更輕鬆地擴展此範例，並且輸出 message.usage 提供您進行以下成本計算所需的數據。.

如何解讀用量並計算費用

找出回應內容、模型、中斷原因及請求 ID

Messages API 的回應合約包含生成的內容、處理該請求的模型，以及中止原因。HTTP 回應中亦包含一個請求識別碼，可協助 Anthropic 支援團隊追蹤問題。請謹慎記錄識別碼；切勿將其與客戶內容或憑證一併公開。.

查閱輸入、輸出及快取代幣的使用情況

的 用法 該物件會回報成本分析所需的代幣類別。至少應確認輸入代幣與輸出代幣。 當使用提示詞快取時，請將五分鐘的快取寫入、一小時的快取寫入以及快取讀取分開處理，因為它們的速率不同。Anthropic 的「字元計數」端點可在請求前估算輸入字元數，但該估算值可能與最終的輸入使用量略有差異，且其本身也有速率限制。.

將代幣使用量轉換為預估成本

請分別計算各類別的數值，然後將結果相加。以採用 Claude Opus 5 並套用標準全球費率的規劃範例為例，1,000 個未快取的輸入代幣的費用為 1,000 × $5 / 1,000,000 = $0.005, ，而 300 個輸出代幣的價格為 300 × $25 / 1,000,000 = $0.0075. 估計總額為 $0.0125. 請將這些用作示例的標記計數替換為 用法 來自您自身回應的數值。.

Claude API 定價計算器

請使用計算機調整模型、請求數量、標記類別、計費模式及推論地區。 批次處理會以 50% 的標準費率計算符合資格的使用量。僅限美國境內的推論，對於符合資格的 Claude 4.6+ 模型，所有代幣類別均適用 1.1 倍的係數；Claude Haiku 4.5 模型不符合資格，因此該組合會返回「不支援」的狀態。.

此估價單僅供規劃參考，並非正式發票。其中不包含稅金、貨幣兌換費用、協商條款、「快速模式」、伺服器工具費用，以及特定帳戶的條件。價格與資格要求可能有所變動，因此在做出採購或架構決策前，請務必再次查閱官方定價頁面。.

上方的計算器顯示了可程式化、按量計費的 Claude API 呼叫的費用結構。對於涉及多種模型和 AI 功能的日常工作，, GlobalGPT 提供了一種截然不同的價值：單一訂閱即可將多種主流模型與工具整合至單一儀表板中，不僅讓成本更易於預估，還能避免研究、撰寫、編碼及創意工作分散在不同的訂閱方案與零散的介面之中。其命令列介面（CLI）將同一平台延伸至終端機開發環境，並與您現有的生產工具無縫整合。我們的指南介紹 在同一個平台上同時運用多個 AI 模型 展示了較寬的平台是如何組裝在一起的。.

Claude API 的常見錯誤與解決方法

請先從 HTTP 狀態碼和 Anthropic 錯誤類型著手，接著在不洩露金鑰的情況下檢查該請求。官方的解釋有助於縮小搜尋範圍；但實際原因仍取決於您的帳戶、所選模型、請求格式以及流量狀況。.

安全的除錯順序

1. 記錄狀態、錯誤類型、時間戳記及請求 ID，但不要記錄 API 金鑰。.
2. 請檢查端點、標頭、JSON 語法、模型 ID 以及請求大小限制。.
3. 請檢查組織的帳務設定、權限、速率限制標頭，以及當前模型的生命週期。.
4. 僅針對那些合理推測為暫時性的錯誤進行重試，並採用有限的指數退避與抖動機制。.
5. 如果錯誤仍然存在，請在聯絡技術支援之前，將請求簡化為最小的可重現案例。.

Anthropic 的官方 SDK 預設會對連線錯誤、429 回應及 5xx 回應進行兩次重試。應用程式層級的重試邏輯仍需設定限制並考量幂等性，特別是在請求可能觸發工具或另一項外部動作的情況下。.

如何控制 Claude API 的成本

設定保守的輸出限制

從最小的開始 max_tokens 仍能產生有用結果的數值。在增加輸出量之前，請先測量實際的輸出使用量。縮短提示字串或許有幫助，但刪除那些會阻止重試、錯誤或無用輸出的指示，整體而言可能造成更高成本。.

僅在適合的情況下使用提示字串快取和批次處理

• 當提示詞的前綴大量重複出現，且快取有效期與工作流程相符時，請使用提示詞快取功能。.
• 對於可異步完成的工作，請使用 Batch；符合資格的 Batch 使用量將按 50% 的標準費率計費。.
• 在報表中應將快取寫入與讀取分開呈現，以便清楚顯示實際節省的成效，而非僅是假設性的。.
• 僅當居住地要求足以支持其 1.1 倍的代幣價格係數，且所選模型符合資格時，才應使用「僅限美國」的推論。.

監控使用狀況、速率限制及支出限額

請追蹤請求次數、模型 ID、輸入與輸出的使用情況、快取類別、重試次數及錯誤。請設定您組織可用的警示或支出控制措施，但請勿假設其他帳戶的服務層級或限制同樣適用於您的帳戶。我們更詳盡的指南請見 Claude 方案、API 費用與限制 涵蓋更廣泛的計費路徑。.

首次提出請求後的下一步驟

為您的下一個專案選擇正確的道路

若要進行實際應用，請參閱 Anthropic 的官方 Messages API 參考手冊、串流指南、工具使用說明、模型生命週期頁面，並制定您專屬的記錄與評估計畫。請審慎確定模型策略，在導入流量前先處理錯誤，並根據實際使用情況來計算成本，而非僅以提示字串長度為依據。.

若您的主要用途是程式設計，請參閱我們的指南： 使用 Claude AI 進行編碼 內容涵蓋了如何從互動式編碼任務轉變為可重複的開發者工作流程的實用方法。.

何時該選擇多模型工作區作為更合適的工具

當您需要程式碼層級的整合、開發者計費、請求元資料，或是官方平台控制功能時，直接存取 API 是正確的選擇。若您的目標是進行互動式撰寫、研究、規劃，或是比較不同供應商的輸出結果，且無需建置應用程式，那麼多模型工作區可能更為實用。.

常見問題

Claude API 是免費的嗎？

此處並未承諾提供任何通用的免費 API 配額。Claude 的 API 使用量將透過 Claude 控制台另行計費；據 Anthropic 表示，多數組織皆以預付點數支付使用費用，而採用每月開立發票的組織則屬例外。在提交請求前，請先查閱您所屬組織的最新控制台資訊及官方定價資訊。.

如何取得 Claude API 金鑰？

請在 Claude 控制台中為相應的組織建立一個金鑰。Anthropic 會提示新金鑰僅會顯示一次，因此當其出現時，請務必妥善保存。請透過伺服器端的環境變數或機密管理工具載入該金鑰，切勿在瀏覽器程式碼、螢幕截圖或公開儲存庫中洩露此金鑰。.

我應該使用哪一個 Claude 型號 ID？

本教學使用 克勞德-作品第5號 因為這是 2026 年 9 月 8 日經確認時，Anthropic 官方《快速入門指南》中所列的模型。請選擇符合您的工作負載和預算的模型，並再次查閱 Anthropic 的「模型」與「已廢棄項目」頁面，因為模型 ID、別名及生命週期狀態可能會有所變更。.

Claude API 使用哪個端點？

本指南中的第一個請求使用位於 https://api.anthropic.com/v1/messages 的 Messages 端點。 該請求會傳送包含 content-type、x-api-key 及 anthropic-version 標頭的 JSON 資料。Anthropic 還提供其他 API 功能，因此請參閱參考頁面以了解您正在實作的操作。.

Claude Pro 是否包含 API 配額？

Anthropic 的說明中心指出，Claude Pro 並不包含透過 Claude Console 的使用權限。Claude.ai 訂閱與 API 計費是兩項獨立的產品。請在 Console 中設定 API 計費以處理開發人員的請求，並使用我們的 Claude 定價指南 以便進行更全面的方案比較。.

一個 Claude API 請求的費用是多少？

費用取決於所選的模型、輸入代幣數、輸出代幣數、快取寫入、快取讀取、批次模式，以及符合資格的推論地理區域。計算各類別的費用時，請將請求數乘以代幣數，再乘以其每百萬代幣的實際費率，最後除以一百萬，然後將各類別的費用相加。請使用上方的計算器進行估算。.

為什麼會出現 401 錯誤？

401 代表驗證錯誤。請確認 API 金鑰是否存在、是否仍處於有效狀態、是否屬於預期的組織，以及是否已傳送至伺服器中的 x-api-key 標題。在除錯期間，請勿列印或分享該金鑰。即使多次重試，也無法修復遺失或無效的憑證。.

為什麼會出現 429 錯誤？

代碼 429 表示該請求超出速率限制。限制會因組織及使用層級而異，因此請檢查回傳的速率限制標頭，並參閱當前的控制台或相關文件。請降低並發量、遵守重試時程，並採用帶有抖動的有界指數退避機制，而非立即重複相同的突發請求。.

來源與新鮮度說明： 模型 ID、價格、API 行為及支援政策均已於 2026 年 9 月 8 日參照 Anthropic 的官方文件進行核對。在投入生產環境使用前，請先查閱最新的模型與定價頁面，然後使用您自己的 Claude 控制台金鑰、計費設定及帳戶存取權限來執行範例程式。.