claude-api

Overview

claude-api 可以幫你做到什麼

claude-api 這個 skill 是一份實用參考資料，協助你運用 Claude API、官方 Anthropic SDK，以及在可用情況下的 Agent SDK 文件，使用 Claude 建構由 LLM 驅動的應用程式。內容依語言整理，讓開發者能快速從環境設定進入可實作的請求、串流回應、工具使用，以及後端整合模式。

如果你已經確定要使用 Claude，現在需要的是實作層面的指引，而不是泛泛而談的 AI 總覽，那這個 skill 會特別有幫助。此 repository 包含 C#、Go、Java、PHP、Ruby、Python 與 TypeScript 的語言專屬文件，另外也提供 curl/ 下的原始 HTTP 範例。

這個 skill 適合誰

claude-api 特別適合：

• 將 Claude 整合進服務、workers 與內部工具的後端開發者
• 正在評估直接呼叫 HTTP 或採用官方 SDK 的 API 開發者
• 想在 Python、TypeScript、Go、Java、PHP、Ruby 或 C# 之間比較語言支援，再決定標準技術棧的團隊
• 需要串流、工具使用、批次處理、files API 使用方式與錯誤處理範例的開發者
• 使用 Python 或 TypeScript Agent SDK 文件建立 agent 的開發者

它解決了哪些問題

claude-api 不需要你自己把零散範例東拼西湊，而是為常見的實作決策提供有結構的起點：

• 該使用哪個 SDK 或 API 介面
• 應該先看哪個語言資料夾
• 如何用 ANTHROPIC_API_KEY 做驗證
• 如何送出第一個 message request
• 什麼情況下長輸出應優先使用串流
• 到哪裡查找工具使用、batches、files API、prompt caching、model 參考資料與錯誤代碼

這個 skill 也包含共用參考檔案，例如 shared/error-codes.md、shared/models.md、shared/prompt-caching.md、shared/live-sources.md 與 shared/tool-use-concepts.md，當你需要的不只是最基本的 hello-world 範例，而是更完整的後端行為指引時，會很有幫助。

repository 中支援的文件範圍

從 repository 內容可見，主要包含以下區塊：

• csharp/
• curl/
• go/
• java/
• php/
• python/agent-sdk
• python/claude-api
• ruby/
• typescript/agent-sdk
• typescript/claude-api
• shared/

因此，claude-api 不只是單一語言的程式片段集合。更貼切地說，它是一套涵蓋多種語言、面向 Claude API 生態系的後端整合 skill。

什麼情況下 claude-api 很適合

以下情況很適合使用 claude-api：

• 你的程式碼會匯入 anthropic、@anthropic-ai/sdk 或 claude_agent_sdk
• 你想採用官方 Anthropic SDK 的使用模式
• 你需要伺服器端整合 Claude API 的實作範例
• 你想在正式開發前先看語言專屬的安裝指引
• 你需要了解串流、工具使用、batches 或 files API 支援等功能

什麼情況下 claude-api 不適合

以下情況下，這個 skill 可能不是最佳選擇：

• 你的專案使用的是其他 AI provider 的 SDK，例如 openai
• 你需要的是與 Claude 整合無關的一般程式設計協助
• 你想找的是前端 UI 模式，而不是 API 與後端工作流程
• 你需要 repository 未涵蓋的語言，而且也不想使用 curl/ 中的原始 HTTP 範例

How to Use

安裝這個 skill

從 Anthropic skills repository 加入 claude-api：

npx skills add https://github.com/anthropics/skills --skill claude-api

安裝完成後，先從 SKILL.md 開始，再進入與你程式碼基底相符的語言資料夾。

先選對資料夾

想有效使用 claude-api，最快的方法就是在閱讀實作細節前，先選定對應語言的路徑。

repository 中適合作為起點的檔案包括：

• SKILL.md
• csharp/claude-api.md
• curl/examples.md
• go/claude-api.md
• java/claude-api.md
• php/claude-api.md
• ruby/claude-api.md
• python/claude-api/README.md
• typescript/claude-api/README.md
• python/agent-sdk/README.md
• typescript/agent-sdk/README.md

如果你是在選技術棧前先評估 SDK 支援情況，建議並排查看多個語言資料夾。這個 repository 清楚區分了直接使用 Claude API，以及在 Python 與 TypeScript 中使用 Agent SDK 的指引。

依使用情境選擇介面

根據 repository 結構，claude-api 支援幾條實用路徑：

• 使用 curl/examples.md 查看原始 HTTP requests，或應對 repository 未支援的語言
• 使用 go/、java/、php/、ruby/ 或 csharp/ 等語言資料夾，採用官方 SDK 模式
• 使用 python/claude-api/ 或 typescript/claude-api/ 深入查看串流、工具使用、batches 與 files API 等主題
• 如果你的專案核心是 agent workflow，而不只是直接呼叫 message，請使用 python/agent-sdk/ 或 typescript/agent-sdk/

這樣的結構很適合拿來做安裝前評估，因為不同語言支援的高階功能並不完全相同。舉例來說，repository 明確提供了 Python 與 TypeScript 的 Agent SDK 文件，而其他語言則主要聚焦在 Claude API SDK 的使用方式。

安全設定驗證方式

在 repository 的範例中，標準做法都是使用 ANTHROPIC_API_KEY 環境變數，而不是把密鑰直接寫死在程式裡。這讓 claude-api 很適合用於重視正式環境實務的後端工作流程與 CI 環境。

在測試範例前，先確認你的執行環境可以讀取 ANTHROPIC_API_KEY。

各語言常見安裝方式

從 repository 內容可看到以下安裝範例：

• C#: dotnet add package Anthropic
• Go: go get github.com/anthropics/anthropic-sdk-go
• PHP: composer require "anthropic-ai/sdk"
• Ruby: gem install anthropic
• Java: 以 com.anthropic:anthropic-java 設定 dependency
• Raw HTTP: 使用 curl 呼叫 https://api.anthropic.com/v1/messages

如果你正在評估要用 SDK 還是 HTTP，當語言有支援時，建議先從 SDK 開始；若你需要更低階的 request 控制，或使用的是其他語言，再改看 curl/ 範例。

從基本 message request 開始

claude-api 中多數語言指南都從相同的實作流程開始：

1. 初始化 client
2. 從環境變數讀取 API key
3. 使用 Claude model 送出 message request
4. 從 response 讀取 text blocks

這種一致性對跨多種後端語言協作的團隊特別有幫助。即使程式語法不同，你仍可統一 request 模式。

長回應建議使用串流

repository 的 SKILL.md 明確建議，對於可能涉及長輸入、長輸出，或高 max_tokens 的 request，預設應優先使用串流，因為串流有助於避免 request timeout。這是 claude-api 最值得留意的實務重點之一。

如果你的應用程式會產生較長的答案、摘要、工具迴圈或延伸推理，建議先閱讀串流相關文件：

• python/claude-api/streaming.md
• typescript/claude-api/streaming.md
• 各語言檔案中的串流章節，例如 go/claude-api.md、java/claude-api.md、ruby/claude-api.md 與 csharp/claude-api.md

深入了解進階後端功能

相較於只看單一 quickstart，安裝 claude-api 的一個重要理由，是它在 repository 中提供了更深入的主題文件。相關檔案包括：

• python/claude-api/tool-use.md
• typescript/claude-api/tool-use.md
• python/claude-api/batches.md
• typescript/claude-api/batches.md
• python/claude-api/files-api.md
• typescript/claude-api/files-api.md
• shared/tool-use-concepts.md
• shared/prompt-caching.md
• shared/models.md

對需要正式環境後端工作流程的人來說，這些內容特別有價值，因為你需要的通常不會只是單一 request-response 範例。

善用共用參考文件排查問題

如果你的第一次整合沒有成功，claude-api 也提供了有助於除錯與規劃的支援資料：

• shared/error-codes.md：說明 HTTP 錯誤的意義、是否可重試，以及常見原因
• shared/models.md：提供 model 相關參考資料
• shared/live-sources.md：提供 source 相關指引

其中錯誤代碼參考尤其實用，因為它清楚區分了可重試的情況，例如 429、500、529，以及不可重試的 request 問題，如 400，或像 401 這類驗證失敗問題。

採用 claude-api 前的實用評估清單

在專案中正式採用這個 skill 前，建議先問自己：

• 我們是否需要某個支援語言中的官方 SDK 範例？
• 我們是否預期會有長輸出，因此需要串流指引？
• 我們是否需要工具使用、files API 或批次處理範例？
• 我們是否要在 Python 或 TypeScript 中建立 agent workflow？
• 我們是否希望保留使用 curl 的原始 HTTP 備用路徑？

如果以上有幾項答案都是肯定的，那麼 claude-api 很可能就是相當合適的選擇。

FAQ

這個 repository 裡的 claude-api 是什麼？

claude-api 是 anthropics/skills 中的一個 skill，協助開發者使用 Claude API、Anthropic SDK 與 Agent SDK 資源來打造應用程式。內容依語言整理，並搭配共用參考文件。

要怎麼安裝 claude-api？

使用：

npx skills add https://github.com/anthropics/skills --skill claude-api

接著開啟 SKILL.md，再進入與你技術棧相符的語言資料夾。

claude-api 支援哪些語言？

從 repository 內容可見，文件涵蓋 C#、Go、Java、PHP、Ruby、Python、TypeScript，以及搭配 curl 的原始 HTTP 範例。

claude-api 有包含 Agent SDK 指引嗎？

有，但從 repository 結構來看，Agent SDK 文件主要位於 python/agent-sdk/ 與 typescript/agent-sdk/。如果你需要 agent workflow 範例，建議先看這兩個資料夾。

claude-api 有支援串流和工具使用嗎？

有。repository 包含串流與工具使用文件，特別是在 Python 與 TypeScript 的 Claude API 資料夾中；此外，多個語言專屬指南也包含串流章節。

claude-api 只適合直接呼叫 API 嗎？

不是。它同時涵蓋直接使用 Claude API，以及以 SDK 為基礎的整合模式。對於不想使用 SDK，或使用其他語言的開發者，也提供了 curl/examples.md 中的原始 HTTP 範例。

什麼情況下應該用 curl，而不是 SDK？

當你需要原始 HTTP 範例、你的語言不在這個 skill 的官方 SDK 支援範圍內，或你想在採用 client library 前先直接檢視 request 與 response 結構時，就適合使用 curl。

claude-api 有包含錯誤處理指引嗎？

有。shared/error-codes.md 說明了 HTTP 錯誤代碼、常見原因，以及哪些問題可以重試。這讓 claude-api 不只適合初始設定，也很適合用來規劃正式環境整合。

claude-api 適合拿來做一般程式開發協助嗎？

不適合。這個 repository 的定位很明確，就是聚焦在 Claude API 與 Anthropic SDK 的使用。如果你的任務與 Claude 整合無關，這個 skill 會過於專門。

安裝完 claude-api 後，應該先看什麼？

先從 SKILL.md 開始，再進到符合你語言與使用情境的檔案。對多數團隊來說，建議順序是：

1. SKILL.md
2. 你的語言指南，例如 go/claude-api.md 或 php/claude-api.md
3. 主題型文件，例如 streaming.md、tool-use.md、batches.md 或 files-api.md
4. 共用參考資料，例如 shared/error-codes.md