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をサポートする任意の環境にインストールできます。

このスキルはプログレッシブディスクロージャーを使用してコンテキストを効率的に保ちます。Claudeは、すべてを一度に読み込むのではなく、プロジェクトの言語、サーフェス（Messages APIまたはManaged Agents）、および目の前の特定のタスク（ツール使用、ストリーミング、バッチなど）に関連するドキュメントのみを読み込みます。



スキルが提供するもの

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

Messages API向け:

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

Managed Agents（ベータ版）向け:

• オンボーディングフロー: /claude-api managed-agents-onboardサブコマンドで利用できる、新しいManaged Agentをゼロからセットアップするためのインタビュー形式のウォークスルー
• 言語固有のManaged Agentsドキュメント: Python、TypeScript、C#、Go、Java、PHP、Ruby、cURL向けの永続的なエージェントの作成、セッションの開始、イベントのストリーミング、ツール確認の処理
• クライアントパターン: ロスレスなストリーム再接続、processed_atのqueued/processedゲート、割り込み処理、ファイルマウントの注意点、認証情報の取り扱い
• デプロイメントの制約: 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"}への変換など
• プレフィルの置き換え。該当する場合、アシスタントメッセージのプレフィルパターンを構造化出力に変換します
• ベータヘッダーのクリーンアップ。ターゲットモデルでGAとなっているヘッダー（たとえば、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"）に再度オプトインします
• 拒否フォールバックの設定。レスポンスコンテンツを読み取る前にstop_reason: "refusal"の処理を追加し、ターゲットがClaude Fable 5またはClaude Opus 5の場合にフォールバックリトライパスを設定します（サーバーサイドのfallbacksパラメータ（通常は"default"モード）、SDKの拒否フォールバックミドルウェア、またはフォールバッククレジットリトライ）。また、以前のプレビュー形式に対して書かれたフォールバックコードを更新します

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

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



Managed Agentのセットアップ

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

/claude-api managed-agents-onboard

このスキルは、Managed Agentsのメンタルモデル（Agent設定とSessionの違い）を案内するインタビューを実行し、エージェント設定をテンプレート化し、環境とツールを設定し、セッションループをセットアップし、使用言語向けの実行可能なコードを出力します。このスキルは、必須の**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をガイドします。



次のステップ