Claude API スキル

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

• Messages API — 単一リクエスト、ストリーミングチャット、ツール使用、バッチ処理、プロンプトキャッシング、構造化出力、およびカスタムエージェントループの主要なサーフェス。
• Claude Managed Agents (ベータ) — Anthropic がホストするツール実行、永続的なエージェント設定、およびセッションごとのコンテナを備えたサーバー管理のステートフルエージェント用のファーストパーティサーフェス。

Messages API 用に 8 つのプログラミング言語 (Python、TypeScript、Java、Go、Ruby、C#、PHP、cURL) をサポートし、Managed Agents 用に 7 つの言語 (Python、TypeScript、Java、Go、Ruby、PHP、cURL — C# は現在サポートされていません) をサポートしています。

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

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

スキルが提供するもの

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

Messages API の場合:

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

Managed Agents (ベータ) の場合:

• オンボーディングフロー: /claude-api managed-agents-onboard サブコマンドで利用可能な、新しい Managed Agent をゼロから設定するためのインタビュー駆動型ウォークスルー
• 言語固有の Managed Agents ドキュメント: Python、TypeScript、Java、Go、Ruby、PHP、および cURL の永続的なエージェント作成、セッション開始、ストリーミングイベント、およびツール確認の処理
• クライアントパターン: ロスレスストリーム再接続、processed_at キューイング/処理ゲート、割り込み処理、ファイルマウントの落とし穴、および認証情報処理
• デプロイメント制約: Managed Agents はファーストパーティのみです (Amazon Bedrock、Google Vertex AI、または 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/raw 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-7

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

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

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

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

• モデル ID スワップ。すべてのサポート言語にわたる型付き SDK 定数 (Model.CLAUDE_OPUS_4_6 → Model.CLAUDE_OPUS_4_7) を含み、各ファイルを呼び出し元、モデル定義者、または不透明な文字列参照として分類してから編集
• 破壊的パラメータ変更。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.7 のコーディングとエージェント的なユースケースの場合は xhigh)
• プロンプト動作チューニング。ターゲットモデルで異なる動作をする可能性がある長さ制御、ツールトリガー、サブエージェント、および命令追従プロンプトにフラグを立てる
• サイレントデフォルト処理。Claude Opus 4.7 でユーザーに推論が表示される場合、思考要約 (thinking.display: "summarized") にオプトバック

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

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

Managed Agent の設定

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

/claude-api managed-agents-onboard

スキルはインタビューを実行し、Managed Agents のメンタルモデル (エージェント設定対セッション) を説明し、エージェント設定をテンプレート化し、環境とツールを設定し、セッションループを設定し、言語の実行可能なコードを生成します。スキルは必須の Agent (一度) → 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-7 and re-tune effort

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

/claude-api managed-agents-onboard

各ケースで、スキルは関連する言語固有のドキュメントを読み込み、現在の API パターンとベストプラクティスを使用して Claude を実装ガイドします。

次のステップ