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 4.8における破壊的変更と動作の変化を含む）
• 最新のモデル情報： モデルID、コンテキストウィンドウサイズ、価格
• よくある落とし穴： APIとの統合時によくある間違いを回避するための詳細なガイダンス

Managed Agents（ベータ）向け：

• オンボーディングフロー： /claude-api managed-agents-onboardサブコマンドで利用可能な、新しいManaged Agentをゼロからセットアップするためのインタビュー形式のウォークスルー
• 言語固有の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-4-8

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

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

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

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

• モデルIDの置き換え：サポートされているすべての言語にわたる型付きSDK定数（Model.CLAUDE_OPUS_4_7 → Model.CLAUDE_OPUS_4_8）を含み、編集前に各ファイルを呼び出し元、モデル定義元、または不透明な文字列参照として分類します
• クラウドプラットフォームの検出：プラットフォーム固有のモデル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に戻します
• エフォートのキャリブレーション：ターゲットモデルに対するoutput_config.effortの開始点を推奨します（例：Claude Opus 4.8およびClaude Opus 4.7でのコーディングおよびエージェント的ユースケースにはxhigh）
• プロンプト動作のチューニング：ターゲットモデルで動作が異なる可能性のある長さ制御、ツールトリガー、サブエージェント、指示追従のプロンプトにフラグを立てます
• サイレントデフォルトの処理：Claude Opus 4.8およびClaude Opus 4.7で推論がユーザーに表示される場合、思考の要約化（thinking.display: "summarized"）に再度オプトインします
• 拒否フォールバック設定：ターゲットがClaude Fable 5の場合、レスポンスコンテンツを読み取る前にstop_reason: "refusal"の処理を追加し、フォールバック再試行パス（サーバーサイドのfallbacksパラメータ、SDKの拒否フォールバックミドルウェア、またはフォールバッククレジット再試行）を設定し、以前のプレビュー形式に対して書かれたフォールバックコードを更新します

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

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



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-4-8 and re-tune effort

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

/claude-api managed-agents-onboard

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



次のステップ