Claude を使用した LLM 駆動アプリケーションの構築
このスキルは、Claude を使用した LLM 駆動アプリケーションの構築を支援します。ニーズに基づいて適切なサーフェスを選択し、プロジェクトの言語を検出して、関連する言語固有のドキュメントを参照してください。
始める前に
対象ファイル(または、対象ファイルがない場合はプロンプトとプロジェクト)をスキャンして、Anthropic 以外のプロバイダーのマーカー(import openai、from openai、langchain_openai、OpenAI(、gpt-4、gpt-5、agent-openai.py や *-generic.py などのファイル名、またはコードをプロバイダー非依存に保つという明示的な指示)がないか確認します。見つかった場合は、処理を停止し、このスキルは Claude/Anthropic SDK コードを生成するものであることをユーザーに伝えます。ファイルを Claude 用に切り替えるか、Claude 以外の実装を希望するかを尋ねてください。Anthropic 以外のファイルを Anthropic SDK 呼び出しで編集しないでください。
出力要件
ユーザーが Claude 機能の追加、変更、実装を依頼した場合、コードは次のいずれかを通じて Claude を呼び出す必要があります。
- 公式 Anthropic SDK(プロジェクトの言語に対応。
anthropic、@anthropic-ai/sdk、com.anthropic.*など)。これは、プロジェクトにサポートされている SDK が存在する場合のデフォルトです。 - Raw HTTP(
curl、requests、fetch、httpxなど)— ユーザーが明示的に cURL/REST/raw HTTP を要求した場合、プロジェクトがシェル/cURL プロジェクトの場合、または言語に公式 SDK がない場合にのみ使用します。
この2つを決して混在させないでください。Python や TypeScript プロジェクトで、軽量だからという理由で requests/fetch を使用しないでください。OpenAI 互換のシムにフォールバックしないでください。
SDK の使用法を推測しないでください。 関数名、クラス名、名前空間、メソッドシグネチャ、インポートパスは、このスキルの {lang}/ ファイル、公式 SDK リポジトリ、または shared/live-sources.md にリストされているドキュメントリンクからの明示的なドキュメントに基づく必要があります。必要なバインディングがスキルファイルに明示的に文書化されていない場合は、コードを書く前に shared/live-sources.md から関連する SDK リポジトリを WebFetch してください。cURL の形状や別の言語の SDK から Ruby/Java/Go/PHP/C# の API を推測しないでください。
WebFetch またはリポジトリアクセスが失敗した場合(ネットワーク制限、タイムアウト、クローンのブロック):再試行を続けずに、{lang}/ ファイルのパターンと名前空間/パッケージテーブルからコードを書き、コンパイラまたはインタプリタを実行し、エラー出力に基づいて反復してください。静的型付け SDK(C#、Java、Go)の場合、ローカルエラーに対するコンパイル・修正ループの方が、ブロックされたネットワーク調査よりも早く動作するコードに到達できます。
デフォルト
ユーザーが特に要求しない限り:
Claude モデルバージョンには、Claude Opus 5 を使用してください。正確なモデル文字列 claude-opus-5 でアクセスできます。複雑な処理には、アダプティブ思考(thinking: {type: "adaptive"})をデフォルトで使用してください。また、長い入力、長い出力、高い max_tokens が予想されるリクエストには、デフォルトでストリーミングを使用してください。これにより、リクエストのタイムアウトを防ぐことができます。個々のストリームイベントを処理する必要がない場合は、SDK の .get_final_message() / .finalMessage() ヘルパーを使用して完全なレスポンスを取得してください。
⚠️ API ドリフト — トレーニングデータが古い可能性があります
いくつかの一般的な Claude API の形状は、2025~2026年に変更されました。トレーニングからパターンを覚えている場合は、コードを書く前にこのスキルの {lang}/ ファイルで確認してください。以下の行は、最も頻繁なドリフトポイントです。
| 領域 | 古い知識 | 現在の API |
|---|---|---|
| 拡張思考 | thinking: {type: "enabled", budget_tokens: N} | Claude 4.6+ モデル:thinking: {type: "adaptive"}。budget_tokens は Opus 4.6 / Sonnet 4.6 では非推奨であり、Fable 5 / Sonnet 5 / Opus 5 / 4.8 / 4.7 では 400 エラーで拒否されます。4.6 より前のモデルは引き続き budget_tokens を使用します。 |
| Web 検索 / Web フェッチツールのタイプ | web_search_20250305、web_fetch_20250910 | Opus 5/4.8/4.7/4.6、Sonnet 5、Sonnet 4.6 では web_search_20260209、web_fetch_20260209(動的フィルタリング)。古いモデルは基本バリアントを維持します。Vertex AI では基本の web_search_20250305 のみが利用可能で(Web フェッチは Vertex では利用不可)— 以下のサーバーツール QR を参照してください。 |
| PHP パラメータ名 | スネークケースのワイヤ名を名前付き引数として使用(max_tokens) | トップレベルの名前付き引数はキャメルケース(maxTokens)。ネストされた配列キーは機能によって異なります(例:'taskBudget'、'skillID'、'mcp_server_name')— ドキュメントの例から正確なキーをコピーしてください。一括変換しないでください。 |
| Managed Agents の認証情報 | カスタムツールを介してホスト側でシークレットを保持(Vault が出荷される前の唯一のオプション) | Vault environment_variable 認証情報 — Anthropic によって保存され、出力時に置き換えられ、サンドボックス内では決して表示されません(shared/managed-agents-tools.md → Vaults)。ホスト側のカスタムツールは、セルフホスト型サンドボックスのためのフォールバックとして残ります。 |
このスキルの {lang}/ ファイルは、覚えているパターンよりも優先されます。
サブコマンド
このプロンプトの下部にあるユーザーリクエストが、散文を含まない単なるサブコマンド文字列である場合、このドキュメント内のすべての サブコマンド テーブル(以下に追加されたセクションを含む)を検索し、該当するアクション列に直接従ってください。これにより、ユーザーは /claude-api <サブコマンド> で特定のフローを呼び出すことができます。ドキュメント内のテーブルが一致しない場合は、リクエストを通常の散文として扱ってください。
| サブコマンド | アクション |
|---|---|
migrate | 既存の Claude API コードを新しいモデルに移行します。すぐに shared/model-migration.md を読み、順番に従ってください:ステップ0(スコープの確認 — 編集前にどのファイル/ディレクトリか尋ねる)、ステップ1(各ファイルを分類)、次にターゲットごとの破壊的変更セクション。ガイドを要約しないでください — 実行してください。ユーザーがターゲットモデルを指定しなかった場合は、スコープの質問と同じターンでどのモデルに移行するか尋ねてください。 |
言語検出
コード例を読む前に、ユーザーがどの言語で作業しているかを判断します。
-
プロジェクトファイルを確認して言語を推測します。
*.py、requirements.txt、pyproject.toml、setup.py、Pipfile→ Python —python/を読む*.ts、*.tsx、package.json、tsconfig.json→ TypeScript —typescript/を読む*.js、*.jsx(.tsファイルが存在しない) → TypeScript — JS は同じ SDK を使用するため、typescript/を読む*.java、pom.xml、build.gradle→ Java —java/を読む*.kt、*.kts、build.gradle.kts→ Java — Kotlin は Java SDK を使用するため、java/を読む*.scala、build.sbt→ Java — Scala は Java SDK を使用するため、java/を読む*.go、go.mod→ Go —go/を読む*.rb、Gemfile→ Ruby —ruby/を読む*.cs、*.csproj→ C# —csharp/を読む*.php、composer.json→ PHP —php/を読む
-
複数の言語が検出された場合(例:Python と TypeScript ファイルの両方):
- ユーザーの現在のファイルや質問がどの言語に関連しているかを確認する
- それでも曖昧な場合は、尋ねる:「Python と TypeScript の両方のファイルを検出しました。Claude API の統合にどの言語を使用していますか?」
-
言語が推測できない場合(空のプロジェクト、ソースファイルがない、またはサポートされていない言語):
- AskUserQuestion を使用してオプションを提示:Python、TypeScript、Java、Go、Ruby、cURL/raw HTTP、C#、PHP
- AskUserQuestion が利用できない場合は、Python の例をデフォルトとし、次のように注意書きをする:「Python の例を表示しています。別の言語が必要な場合はお知らせください。」
-
サポートされていない言語が検出された場合(Rust、Swift、C++、Elixir など):
curl/から cURL/raw HTTP の例を提案し、コミュニティ SDK が存在する可能性があることを伝える- 参考実装として Python または TypeScript の例を表示することを提案する
-
ユーザーが cURL/raw HTTP の例を必要とする場合、
curl/から読み取ります。
言語固有の機能サポート
上記のすべての SDK 言語は、ベータ版の Tool Runner と Managed Agents(ベータ版)の両方をサポートしています。Python(@beta_tool デコレータ)、TypeScript(betaZodTool + Zod)、Java(アノテーション付きクラス)、Go(toolrunner パッケージの BetaToolRunner)、Ruby(BaseTool + tool_runner)、C#(BetaToolRunner + 生の JSON スキーマ)、PHP(BetaRunnableTool + toolRunner())。コードのエントリポイントは、以下のツール使用パターンのクイックリファレンスにあります。cURL は raw HTTP(SDK 機能なし)であり、Managed Agents をサポートしています。
Managed Agents のコード例:以下の「## Managed Agents (Beta)」セクションのリーディングガイドを参照してください。
どのサーフェスを使用すべきか?
シンプルに始めましょう。 ニーズを満たす最もシンプルな階層をデフォルトにしてください。単一の API 呼び出しとワークフローでほとんどのユースケースに対応できます。エージェントは、タスクが本当にオープンエンドでモデル駆動型の探索を必要とする場合にのみ使用してください。「最もシンプル」とは、あなたが所有するコードが最も少ないことを意味します。ホスト型、スケジュール型、メモリバックアップ型のエージェントには、Managed Agents が通常最もシンプルなオプションです(ループコード、状態ファイル、スケジューラが不要)が、より大きなプラットフォームです。
| ユースケース | 階層 | 推奨サーフェス | 理由 |
|---|---|---|---|
| 分類、要約、抽出、Q&A | 単一 LLM 呼び出し | Claude API | 1リクエスト、1レスポンス |
| バッチ処理または埋め込み | 単一 LLM 呼び出し | Claude API | 特殊なエンドポイント |
| コード制御ロジックによるマルチステップパイプライン | ワークフロー | Claude API + ツール使用 | ループをあなたが調整する |
| 独自ツールを使用したカスタムエージェント | エージェント | Claude API + ツール使用 | 最大の柔軟性 |
| サーバー管理のステートフルエージェント(ワークスペース付き) | エージェント | Managed Agents | Anthropic がループを実行し、ツール実行サンドボックスをホストする |
| 永続化、バージョン管理されたエージェント設定 | エージェント | Managed Agents | エージェントは保存されたオブジェクト;セッションはバージョンに固定される |
| ファイルマウント付きの長時間実行マルチターンエージェント | エージェント | Managed Agents | セッションごとのコンテナ、SSE イベントストリーム、スキル + MCP |
| スケジュールで実行されるエージェント(cron、「毎晩」) | エージェント | Managed Agents — スケジュールされたデプロイメント | デプロイメントが自律的にセッションを開始;クライアント側のスケジューラは不要 |
注記: Managed Agents は、Anthropic にエージェントループを実行させ、ツールが実行されるコンテナをホストさせたい場合に適切な選択です。ファイル操作、bash、コード実行はすべてセッションごとのワークスペースで実行されます。コンピュートを自分でホストするか、独自のカスタムツールランタイムを実行したい場合は、Claude API + ツール使用が適切な選択です。ツールランナーをエージェントループに使用してください。そのターンごとのフックは、承認ゲート、ロギング、エラーインターセプト、条件付き実行を提供します(
shared/tool-use-concepts.mdを参照)。ループ全体を自分で完全に制御したい場合は、手動ループを使用してください。
クラウドプロバイダーアクセス。 AWS 上の Claude Platform は Anthropic が運営し、同日 API パリティを提供します。クライアント設定は
shared/claude-platform-on-aws.mdを参照してください。AWS 上の Claude Platform、Amazon Bedrock、Google Vertex AI、Microsoft Foundry の機能ごとの可用性については、shared/platform-availability.mdを参照してください。このテーブルはこのスキル内の唯一の情報源です。他の場所から可用性を推測しないでください。
エージェントの構築:4つのアプローチ
実際にエージェント(オープンエンドでモデル駆動型のツール使用)が必要だと判断したら、それを構築する4つの明確な方法があります。2つの独立した質問がそれらを区別します:誰がハーネスを提供するか(エージェントループ + コンテキスト管理)と誰がデプロイメントを提供するか(エージェントが実行されるインフラ)。Tool Runner と Claude Agent SDK はどちらも ハーネスのみ を提供します。それらを自分でホストしてデプロイする必要があります。これが、これらを混同しやすい理由です。Managed Agents (CMA) は、ハーネス と 管理されたデプロイメントの 両方 を提供する唯一のオプションです。手動ループはどちらも提供しません。
| # | アプローチ | あなたが書くもの | ハーネスとデプロイメント | 利用可能なツール | 使用するタイミング |
|---|---|---|---|---|---|
| 1 | Claude API — 手動ループ | while stop_reason == "tool_use" ループを自分で書く | ハーネスを構築;ホストは自分 | 自分で定義したツールのみ | ループ全体を完全に制御したい場合 — ベータ依存を避けたい、または Tool Runner のターンごとのフックに合わない制御フローがある場合 |
| 2 | Claude API — Tool Runner(client.beta.messages.tool_runner + @beta_tool / betaZodTool) | ツール関数だけ | SDK がループを提供する(ハーネスのみ);ホストは自分 | 自分で定義したツールのみ | 手動でループを書かずにカスタムツールエージェントが必要な場合(ほとんどのケース)。ターンごとのフックは、承認ゲート、エラーインターセプト、結果の変更(例:cache_control)、リトライ、ストリーミング、コンパクションを提供する |
| 3 | Managed Agents(REST、ベータ版) | エージェント設定 + ツール結果 | Anthropic がハーネス と セッションごとのサンドボックスを提供する(ハーネス + デプロイメント) | Anthropic ホストのサンドボックス(bash、ファイル、コード実行)+ スキル/MCP + あなたのツール | Anthropic にループを実行 させ、セッションごとのワークスペースをホストさせたい場合;永続化/バージョン管理された設定;長時間実行セッション |
| 4 | Claude Agent SDK — 別製品(claude-agent-sdk / @anthropic-ai/claude-agent-sdk) | プロンプト + オプション | SDK が Claude Code のハーネス + 組み込みツールを提供する(ハーネスのみ);ホストは自分 | 組み込みの Read/Write/Edit/Bash/Glob/Grep/WebSearch/WebFetch + MCP + サブエージェント | 独自のインフラで動作する、バッテリー同梱のコーディング/ファイルシステムエージェントが必要な場合 |
ハーネス/デプロイメントの分割が重要なメンタルモデルです:オプション1、2、4はすべて デプロイメントをあなたに任せます。オプション3(CMA)だけが管理されたデプロイメントを追加します。オプション1~3はこのスキルが生成するものです。オプション4は別のライブラリで、独自のドキュメントがあります。以下の区別を参照してください。
Tool Runner ≠ Claude Agent SDK。 これらは似たように聞こえますが、異なるパッケージです。
- Tool Runner は通常の Anthropic API SDK(
anthropic/@anthropic-ai/sdk)の一部で、client.beta.messages.tool_runnerでアクセスします。