Claude APIスキル

claude-apiスキルは、オープンソースのAgent Skillであり、Anthropicの2つのサーフェス上でアプリケーションを構築するための詳細かつ最新のリファレンス資料をClaudeに提供します。

• Messages API: 単一リクエスト、ストリーミングチャット、ツール使用、バッチ処理、プロンプトキャッシング、構造化出力、カスタムエージェントループのための主要なサーフェスです。
• Claude Managed Agents（ベータ）: Anthropicがホストするツール実行、永続的なエージェント設定、セッションごとのサンドボックスを備えた、サーバー管理型のステートフルエージェントのためのAnthropicホスト型サーフェスです。

Messages APIとManaged Agentsの両方について、Python、TypeScript、C#、Go、Java、PHP、Ruby、cURLの8つのプログラミング言語をカバーしています。

このスキルはClaude Codeにバンドルされており、オープンソースのAnthropicスキルリポジトリでも入手できます。Agent Skillsをサポートする任意の環境にインストールできます。

このスキルは「progressive disclosure」（段階的開示）を使用してコンテキストを効率的に保ちます（詳細はこちら）。Claudeはすべてを一度に読み込むのではなく、プロジェクトの言語、サーフェス（Messages APIまたはManaged Agents）、および目下の特定のタスク（ツール使用、ストリーミング、バッチなど）に関連するドキュメントのみを読み込みます。

スキルが提供するもの

トリガーされると、このスキルはClaudeに以下を提供します。

Messages API向け:

• 言語固有のSDKドキュメント: プロジェクトの言語に対応したインストール、クイックスタート、一般的なパターン、エラー処理
• ツール使用のガイダンス: 関数呼び出しのための言語固有の例と概念的な基礎（利用可能な場合はベータ版のツールランナーを含む）
• ストリーミングパターン: チャットUIの構築と段階的な表示処理のための実装の詳細
• バッチ処理: 50%のコストでのオフラインバッチ処理
• プロンプトキャッシング: プレフィックス安定性の設計、ブレークポイントの配置、サイレントな無効化要因の監査
• モデル移行: 新しいClaudeモデルへ移行するためのステップバイステップのガイダンス（Claude Opus 5およびClaude Fable 5.1における破壊的変更と動作の変化を含む）
• 現行モデルの情報: モデルID、コンテキストウィンドウのサイズ、価格
• よくある落とし穴: APIとの統合時に頻発するミスを避けるための詳細なガイダンス

Managed Agents（ベータ）向け:

• オンボーディングフロー: 新しいManaged Agentをゼロからセットアップするためのインタビュー形式のウォークスルー。/claude-api managed-agents-onboardサブコマンドから利用できます
• 言語固有のManaged Agentsドキュメント: Python、TypeScript、C#、Go、Java、PHP、Ruby、cURL向けの、永続的なエージェントの作成、セッションの開始、イベントのストリーミング、ツール確認の処理
• クライアントパターン: ロスレスなストリーム再接続、processed_atによるキュー済み/処理済みゲート、割り込み処理、ファイルマウントの注意点、認証情報の取り扱い
• デプロイの制約: Managed AgentsはClaude APIおよびClaude Platform on AWSでのみ利用可能です（Amazon Bedrock、Google Cloud、Microsoft Foundryでは利用できません）。このスキルは、その他のデプロイ先についてはMessages APIとツール使用へ誘導します。

スキルが起動するタイミング

このスキルは2つの方法で起動します。

自動起動は以下の場合に発生します。

• コードがAnthropic SDK（Pythonの場合はanthropic、TypeScript/JavaScriptの場合は@anthropic-ai/sdk）をインポートしている
• Claude API、Anthropic SDK、またはManaged Agentsを使った何かの構築、デバッグ、最適化をClaudeに依頼した
• ファイル内でClaudeの機能（プロンプトキャッシング、アダプティブ思考、コンパクション、ツール使用、バッチ、ファイル、引用、メモリ）またはモデル参照を追加、変更、調整した

手動呼び出しは、スキルがインストールされている任意の環境で/claude-api（オプションでサブコマンドまたは文章を付加）と入力することで行います。

このスキルは、一般的なプログラミングタスク、ML/データサイエンスの作業、または他のAI SDK（OpenAIなど）をインポートするコードに対しては起動しません。

サポートされる言語

このスキルは、プロジェクトファイル（例：Pythonの場合はrequirements.txt、TypeScriptの場合はtsconfig.json、Goの場合はgo.mod）を調べることでプロジェクトの言語を自動的に検出し、適切なドキュメントを読み込みます。

プロジェクトで複数の言語を使用している場合、Claudeはどの言語が該当するかを尋ねます。サポートされていない言語（Rust、Swift、C++）については、このスキルはcURL/生のHTTPの例を提供します。

スキルの使い方

Claude Codeで使用する（バンドル済み）

このスキルはClaude Codeに同梱されており、インストールは不要です。Claude APIを使った何かの構築をClaudeに依頼したとき、またはプロジェクトがすでにAnthropic SDKをインポートしているとき、スキルは自動的に起動します。

直接呼び出すこともできます。

/claude-api

Claude Codeにおけるバンドル済みスキルの仕組みの詳細については、Claude Codeスキルのドキュメントを参照してください。

スキルリポジトリから使用する

スキルのソースはAnthropicスキルリポジトリで入手できます。npxコマンドを使用してインストールできます。

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

または、Claude Codeプラグインとしてインストールします。

/plugin marketplace add anthropics/skills
/plugin install claude-api@anthropic-agent-skills

新しいClaudeモデルへの移行

Claude APIスキルは、コードベース全体にわたってClaudeモデルの移行を実行できます。/claude-api migrateで直接呼び出します。

/claude-api migrate this project to claude-opus-5

スコープ確認の質問をスキップするために、特定のスコープをあらかじめ渡すこともできます。

/claude-api migrate everything under src/ to claude-opus-5
/claude-api migrate apps/api.py and apps/worker.py to claude-opus-5

スコープが曖昧な場合（例：単に/claude-api migrate to claude-opus-5とした場合）、スキルはファイルを編集する前に、作業ディレクトリ全体、特定のサブディレクトリ、または明示的なファイルリストのいずれかを選択するよう求めます。これはMessages APIとManaged Agentsの両方の呼び出し元に適用されます。

このスキルは以下を処理します。

• モデルIDの置き換え：サポートされるすべての言語における型付きSDK定数（Model.CLAUDE_OPUS_4_8 → Model.CLAUDE_OPUS_5）を含みます。編集前に各ファイルを呼び出し元、モデル定義元、または不透明な文字列参照のいずれかに分類します
• クラウドプラットフォームの検出：プラットフォーム固有のモデルID形式（例：Amazon Bedrockにおけるanthropic.プレフィックス）を保持し、パートナー運営のプラットフォームで利用できない機能については変更をスキップします
• 破壊的なパラメータ変更：Claude Opus 4.8およびClaude Opus 4.7向けのtemperature、top_p、top_kの削除や、thinking: {type: "enabled", budget_tokens: N}からthinking: {type: "adaptive"}への変換など
• プリフィルの置き換え：該当する場合、アシスタントメッセージのプリフィルパターンを構造化出力に変換します
• ベータヘッダーのクリーンアップ：ターゲットモデルが必要としないベータヘッダー（例：effort-2025-11-24、fine-grained-tool-streaming-2025-05-14、interleaved-thinking-2025-05-14）を削除し、client.beta.messages.createからclient.messages.createに戻します
• エフォートの調整：ターゲットモデル向けのoutput_config.effortの出発点を推奨します（例：Claude Opus 5ではデフォルトのhigh、Claude Opus 4.8およびClaude Opus 4.7でのコーディングやエージェント用途ではxhigh）
• プロンプト動作のチューニング：ターゲットモデルで異なる動作をする可能性のある、長さ制御、ツールトリガー、サブエージェント、指示追従に関するプロンプトにフラグを立てます
• サイレントなデフォルトの処理：Claude Opus 4.8およびClaude Opus 4.7で推論がユーザーに表示される場合、思考の要約（thinking.display: "summarized"）に再度オプトインします
• 拒否フォールバックの設定。ターゲットがClaude Fable 5.1、Claude Fable 5、またはClaude Opus 5の場合、レスポンスコンテンツを読み取る前にstop_reason: "refusal"の処理を追加し、フォールバック再試行パス（サーバー側のfallbacksパラメータ（通常は"default"モード）、SDKの拒否フォールバックミドルウェア、またはフォールバッククレジットによる再試行）をセットアップします。また、以前のプレビュー形式に対して書かれたフォールバックコードを更新します

編集の際、スキルは各変更とその動機をインラインで説明します。完了時には、手動での検証が必要な項目（通常は統合テスト、長さ制御プロンプトのチューニング、コスト/レート制限の再ベースライン化）のチェックリストを生成します。

このスキルが適用するモデル固有の変更の完全なリストについては、Claude Opus 4.8からClaude Opus 5への移行およびClaude Fable 5.1への移行を参照してください。

Managed Agentのセットアップ

新しいManaged Agentをゼロからスキャフォールドするには、managed-agents-onboardサブコマンドを呼び出します。

/claude-api managed-agents-onboard

スキルはインタビューを実行し、Managed Agentsのメンタルモデル（エージェント設定とセッションの違い）を順に説明し、エージェント設定のテンプレートを作成し、環境とツールを設定し、セッションループをセットアップし、使用言語向けの実行可能なコードを出力します。スキルは必須のAgent（1回）→ Session（毎回の実行）フローもカバーします。model、system、toolsはセッションではなく常にエージェント側に置かれ、エージェントは一度だけ作成してIDで参照する必要があります。

Managed Agentsにはmanaged-agents-2026-04-01ベータヘッダーが必要です。SDKはすべてのclient.beta.agents.*、client.beta.environments.*、client.beta.sessions.*、client.beta.vaults.*の呼び出しに対してこのヘッダーを自動的に設定します。

使用例

スキルがClaudeの処理を支援するタスクの例を以下に示します。

チャットアプリケーションの構築:

Build a streaming chat UI with the Claude API in TypeScript

既存プロジェクトの移行:

/claude-api migrate this codebase to claude-opus-5 and re-tune effort

新しいManaged Agentのオンボーディング:

/claude-api managed-agents-onboard

いずれの場合も、スキルは関連する言語固有のドキュメントを読み込み、現行のAPIパターンとベストプラクティスを用いてClaudeの実装をガイドします。

次のステップ