Claude APIスキル

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

• Messages API： 単一リクエスト、ストリーミングチャット、「tool use」（ツール使用）、バッチ処理、「prompt caching」（プロンプトキャッシング）、「structured outputs」（構造化出力）、カスタムエージェントループのための主要なサーフェスです。
• 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.5、Claude Sonnet 5.5、Claude Haiku 5.5、およびClaude Fable 5.1における破壊的変更と動作の変化を含む）
• 保持された思考への移行： thinkingブロックを無効化する履歴の編集の検出、測定、修正（/claude-api preserved-thinking-migrationサブコマンドで利用可能）
• 最新のモデル情報： モデル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 Codeでバンドルされたスキルがどのように機能するかの詳細については、Claude Codeのスキルに関するドキュメントを参照してください。

スキルリポジトリから

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

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

または、Claude CodeプラグインとしてインストールするようClaude Codeに依頼することもできます。

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

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

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

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

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

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

• モデルIDの置き換え： サポートされているすべての言語における型付きSDK定数（Model.CLAUDE_OPUS_4_8 → Model.CLAUDE_OPUS_5_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()に戻します
• effortの調整： ターゲットモデルに対する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.5、Claude Opus 5、またはClaude Sonnet 5.5の場合、レスポンスの内容を読み取る前にstop_reason: "refusal"の処理を追加し、フォールバック再試行パス（サーバー側のfallbacksパラメータ（通常は"default"モード）、SDKの拒否フォールバックミドルウェア、またはフォールバッククレジットによる再試行）をセットアップします。また、以前のプレビュー版の形式に基づいて書かれたフォールバックコードを更新します

スキルは編集を進めながら、各変更とその理由をインラインで説明します。完了時には、手動での検証が必要な項目のチェックリスト（通常は統合テスト、長さ制御のプロンプト調整、コスト/「rate limit」（レート制限）のベースライン再設定）を作成します。

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

保持された思考に対応するための統合のチェック

「Preserved thinking」（保持された思考）は、systemプロンプト、tools、およびその前のメッセージが変更されない間のみ、thinkingブロックを有効に保ちます。コードがその履歴を編集している箇所を見つけて修正するには、リクエストを構築するリポジトリを開き、preserved-thinking-migrationサブコマンドを呼び出します。

スキルは次の5つのステップで作業を進めます。

1. スコープ： 統合が影響を受けるかどうかを確認し、その後3つのテストリクエストを送信して、意図的な編集をAPIが報告することを確認します。
2. 検出： 独自のマルチターンセッションをいくつかキャプチャし、連続するリクエストの差分を取り、コードがプレフィックスを編集している各箇所を一覧表示します。
3. 測定： "drop_block"を使用してセッションを再生し、どの会話でthinkingブロックが失われるか、どのターンで、なぜ失われるかを報告します。
4. 修正： 編集を1つずつ、プレフィックスを編集せずに変更を加えるの対応するパターンに置き換え、各変更の後に再度測定します。
5. レポート： 各原因、それに対して行った変更、および変更前後の件数をまとめます。

プロジェクトに評価（eval）がある場合、スキルはthinkingブロックが削除された場合とされない場合のスコアとトークン使用量も比較します。

テストリクエストと再生は実際のMessages APIリクエストであり、モデルの通常料金で課金されます。各再生はごく少数の出力トークンのみをリクエストし、tool_choiceをnoneに設定するため、ツールは実行されません。スキルは送信前にコストを提示し、承認を求めます。

Managed Agentのセットアップ

新しいManaged Agentをゼロから構築するには、managed-agents-onboardサブコマンドを呼び出します。

スキルはインタビューを実行し、Managed Agentsのメンタルモデル（エージェント設定とセッションの違い）の説明、エージェント設定のテンプレート化、環境とツールの構成、セッションループのセットアップを順に案内し、使用している言語で実行可能なコードを出力します。また、スキルは必須のエージェント（1回）→ セッション（実行ごと）のフローもカバーしています。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の処理を支援するタスクの例です。

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

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

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

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

次のステップ