claude-api

Overview

claude-api でできること

claude-api スキルは、Claude API、公式の Anthropic SDK、利用可能な場合は Agent SDK の資料を使って、Claude を組み込んだ LLM アプリケーションを構築するための実践的なリファレンスです。言語ごとに整理されているため、セットアップから実際のリクエスト送信、streaming レスポンス、tool use、バックエンド統合パターンまでスムーズに進められます。

このスキルは、すでに Claude を使うことが決まっていて、AI 全般の概要ではなく実装の指針が欲しい場合に特に役立ちます。リポジトリには C#、Go、Java、PHP、Ruby、Python、TypeScript 向けの言語別ドキュメントに加えて、curl/ 配下に生の HTTP 例も含まれています。

こんな人に向いています

claude-api は、次のようなケースに特に適しています。

• サービス、ワーカー、社内ツールに Claude を組み込むバックエンド開発者
• 直接の HTTP 呼び出しと公式 SDK のどちらを使うか検討している API 開発者
• Python、TypeScript、Go、Java、PHP、Ruby、C# のどれを標準採用するか決める前に、言語サポートを比較したいチーム
• streaming、tool use、batching、Files API の利用例やエラーハンドリングのサンプルが必要な開発者
• Python または TypeScript の Agent SDK 資料を使ってエージェントを構築したい開発者

解決できる課題

claude-api は、散在するサンプルを自分でつなぎ合わせる代わりに、よくある実装判断の出発点を整理して提供します。

• どの SDK または API インターフェースを使うべきか
• 最初にどの言語フォルダを読むべきか
• ANTHROPIC_API_KEY でどう認証するか
• 最初のメッセージリクエストをどう送るか
• 長い出力で streaming を優先すべきタイミング
• tool use、batches、Files API、prompt caching、モデル一覧、エラーコードをどこで確認できるか

また、shared/error-codes.md、shared/models.md、shared/prompt-caching.md、shared/live-sources.md、shared/tool-use-concepts.md といった共通リファレンスも含まれているため、最小限の hello-world 例を超えて、バックエンドの挙動まで確認したいときにも便利です。

リポジトリでサポートされている主なドキュメント領域

リポジトリから確認できる主な構成は次のとおりです。

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

この構成から、claude-api は単一言語のコード断片集ではありません。Claude API エコシステム向けの、複数言語対応バックエンド統合スキルとして捉えるのが適切です。

claude-api が向いている場面

次のような場合は claude-api が有力です。

• コードベースで anthropic、@anthropic-ai/sdk、claude_agent_sdk を利用している
• 公式の Anthropic SDK の使い方に沿って実装したい
• サーバーサイドで Claude API を組み込む実践的な例が欲しい
• 実装前に、言語ごとの導入ガイドを確認したい
• streaming、tool use、batches、Files API などのサポート状況を把握したい

claude-api が向いていない場面

次のようなケースでは、このスキルは最適ではありません。

• プロジェクトが openai など別の AI プロバイダーの SDK を使っている
• Claude 統合と無関係な汎用的なプログラミング支援が必要
• API やバックエンドのワークフローではなく、フロントエンド UI パターンを探している
• リポジトリでカバーされていない言語が必要で、curl/ の生 HTTP 例も使いたくない

How to Use

スキルをインストールする

Anthropic skills リポジトリから claude-api を追加します。

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

インストール後は、まず SKILL.md を確認し、その後で自分のコードベースに合う言語フォルダへ進んでください。

最初に適切なフォルダを選ぶ

claude-api を効率よく活用するには、実装の詳細を読む前に、まず言語別のパスを選ぶのが近道です。

リポジトリ内の主な導線は次のとおりです。

• 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 の対応状況を見極めたい場合は、複数の言語フォルダを並べて確認すると分かりやすいです。リポジトリでは、Claude API の直接利用と、Python / TypeScript 向けの Agent SDK ガイドが明確に分かれています。

用途に合ったインターフェースを選ぶ

リポジトリ構成を見る限り、claude-api には実用的な使い分けのパターンがあります。

• 生の HTTP リクエストや未対応言語には curl/examples.md を使う
• 公式 SDK の利用パターンを知りたいなら go/、java/、php/、ruby/、csharp/ などの言語フォルダを使う
• streaming、tool use、batches、Files API などをより深く確認したいなら python/claude-api/ または typescript/claude-api/ を使う
• 単なるメッセージ呼び出しではなく、エージェントワークフロー中心のプロジェクトなら python/agent-sdk/ または typescript/agent-sdk/ を使う

この構成は導入判断にも役立ちます。というのも、すべての言語で同じ高水準機能が提供されているわけではないからです。たとえば、リポジトリには Python と TypeScript 向けの Agent SDK ドキュメントが明示的に含まれていますが、他の言語は Claude API SDK の使い方が中心です。

安全に認証を設定する

リポジトリ内のサンプルでは、秘密情報をコードに埋め込むのではなく、ANTHROPIC_API_KEY 環境変数を使うのが標準的なパターンです。そのため claude-api は、本番運用を意識したバックエンドや CI 環境にもなじみやすい構成になっています。

サンプルを試す前に、実行環境から ANTHROPIC_API_KEY を参照できることを確認してください。

言語別の代表的なインストール方法

リポジトリ上では、次のようなインストール例が確認できます。

• 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 を使った依存関係の設定
• Raw HTTP: https://api.anthropic.com/v1/messages に対して curl を使う

SDK と HTTP のどちらにするか迷う場合は、対応している言語ならまず SDK から始め、より低レベルにリクエストを制御したいときや別言語で実装する場合に curl/ の例へ切り替えるのがおすすめです。

まずは基本のメッセージリクエストから始める

claude-api の多くの言語ガイドは、ほぼ共通した実践的フローで始まります。

1. クライアントを初期化する
2. 環境変数から API キーを読み込む
3. Claude モデルを指定してメッセージリクエストを送る
4. レスポンスからテキストブロックを読み取る

この一貫性は、複数のバックエンド言語をまたいで開発するチームにとって便利です。コードの文法は違っても、リクエストの考え方を共通化できます。

長い応答では streaming を使う

リポジトリの SKILL.md では、入力や出力が長くなりそうなリクエスト、あるいは max_tokens が大きいケースでは、タイムアウト回避のために streaming を基本にすることが明示的に推奨されています。これは claude-api から得られる運用上の重要なポイントのひとつです。

アプリケーションで長文回答、要約、tool loop、長めの推論を扱う場合は、まず streaming 関連のドキュメントを確認してください。

• 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 など各言語ガイド内の streaming セクション

高度なバックエンド機能も確認する

単なるクイックスタートではなく claude-api を導入する理由のひとつが、リポジトリ内のより踏み込んだトピックの充実です。主な関連ファイルは次のとおりです。

• 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：モデル関連のリファレンス
• shared/live-sources.md：ソース関連のガイダンス

特にエラーコードのリファレンスは便利で、429、500、529 のような再試行可能な状態と、400 のようなリクエスト不備、401 のような認証エラーを区別して確認できます。

claude-api 導入前の実用チェックリスト

プロジェクトでこのスキルを採用する前に、次の点を確認しておくと安心です。

• サポート対象言語のいずれかで、公式 SDK のサンプルが必要か
• 長い出力を想定しており、streaming の指針が必要か
• tool use、Files API、batch 処理の例が必要か
• Python または TypeScript でエージェントワークフローを構築するか
• curl を使ったフォールバックの生 HTTP パスも欲しいか

いくつかに当てはまるなら、claude-api は有力な選択肢です。

FAQ

このリポジトリの claude-api とは何ですか？

claude-api は anthropics/skills に含まれるスキルで、Claude API、Anthropic SDK、Agent SDK のリソースを使ってアプリケーションを構築する開発者を支援します。言語ごとに整理されており、共通リファレンス文書でも補完されています。

claude-api はどうやってインストールしますか？

次を実行します。

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

その後、SKILL.md と自分のスタックに合う言語フォルダを開いてください。

claude-api はどの言語に対応していますか？

リポジトリ上では、C#、Go、Java、PHP、Ruby、Python、TypeScript に加え、curl による生の HTTP 例が用意されています。

claude-api には Agent SDK のガイドも含まれていますか？

はい。ただしリポジトリ構成を見ると、Agent SDK の資料は python/agent-sdk/ と typescript/agent-sdk/ に特化して用意されています。エージェントワークフローの例が必要なら、まずこの 2 つのフォルダを確認するのがよいでしょう。

claude-api は streaming や tool use にも対応していますか？

はい。リポジトリには streaming と tool use のドキュメントがあり、特に Python と TypeScript の Claude API フォルダで充実しています。さらに、いくつかの言語別ガイドにも streaming セクションがあります。

claude-api は直接 API を呼ぶ用途だけのものですか？

いいえ。Claude API の直接利用だけでなく、SDK ベースの統合パターンもカバーしています。また、SDK を使いたくない場合や別言語で実装する場合のために、curl/examples.md に生の HTTP 例も含まれています。

SDK ではなく curl を使うべきなのはどんなときですか？

生の HTTP 例が必要なとき、このスキル内で公式 SDK の対象になっていない言語を使うとき、あるいはクライアントライブラリを採用する前に request / response の構造を直接確認したいときは curl が適しています。

claude-api にはエラーハンドリングのガイドもありますか？

はい。shared/error-codes.md で HTTP エラーコード、よくある原因、再試行可能かどうかが整理されています。そのため claude-api は、初期設定だけでなく本番統合の検討にも役立ちます。

claude-api は汎用的なコーディング支援にも向いていますか？

いいえ。リポジトリの説明は Claude API と Anthropic SDK の利用に特化しています。Claude 統合と無関係なタスクには、このスキルは専門特化しすぎています。

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 などの共通リファレンス