Claude 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 Code のバンドルスキルの動作方法の詳細については、Claude Code スキルドキュメント を参照してください。

スキルリポジトリから

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

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

新しい Claude モデルへの移行

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

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

スコープが曖昧な場合 (例: 単純な /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 サブコマンドを呼び出します。

スキルはインタビューを実行し、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 を処理するのに役立つタスクの例を以下に示します。

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

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

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

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

次のステップ