Claude APIのコードを書くとき、どのパラメータが変わったか、キャッシュをどこに置くべきか、毎回ドキュメントを調べている人は多いはずです。

/claude-apiスキルはその手間をまるごと引き受けます。2026年3月にClaude Codeに同梱され、4月29日にはCodeRabbit・JetBrains・Resolve AI・Warpへの展開も発表されました。

この記事でわかること：

  • /claude-apiスキルが解決するClaude API開発の課題
  • モデル移行コマンド/claude-api migrateの動作
  • プロンプトキャッシュ設定の自動診断
  • Managed Agentsのセットアップ支援機能
  • 対応8言語とインストール方法

https://claude.com/blog/claude-api-skill

Claude APIコードが抱える問題

Claude APIのモデルバージョンが上がるたびに、開発者は複数の変更を同時に対応しなければならない状況が続いていました。

例えばClaude Opus 4.7への移行では、temperature・top_p・top_kパラメータが廃止され、thinking: {type: "enabled", budget_tokens: N}はthinking: {type: "adaptive"}に書き換える必要があります。さらにベータヘッダーの整理、型定数の一括置換、プロンプトの挙動調整まで含めると、影響範囲が広く見落としやすい変更が多数あります。

プロンプトキャッシュも同様で、プレフィックスの安定性設計やブレークポイントの配置を誤るとキャッシュが一切効かない状態になりますが、その原因は実行時にわかりにくいことが多い。

/claude-apiスキルはこうした「知識の更新漏れ」を起こしやすい箇所を体系的にカバーします。

スキルが自動的に動き出す仕組み

Claude Codeに/claude-apiスキルは標準搭載されており、インストール不要です。

自動アクティベートは2つの条件で起動します。ひとつはプロジェクトにAnthropicのSDK（Pythonならanthropic、TypeScriptなら@anthropic-ai/sdk）がインポートされているとき。もうひとつはClaudeにAPIのビルド・デバッグ・最適化を依頼したときです。

逆に起動しないのは、一般的なプログラミングタスクやOpenAI SDKを使ったコード作業の場合です。余計なドキュメントをロードしない「プログレッシブ開示」設計により、コンテキスト消費を最小限に抑えています。

手動で呼び出す場合は/claude-apiと入力するだけです。

モデル移行を1コマンドで完了させる

/claude-api migrateはコードベース全体のモデル移行を自動処理します。

/claude-api migrate this project to claude-opus-4-7

スコープを指定して実行範囲を絞ることもできます。

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

スキルが処理する内容は以下のとおりです。

  • モデルID一括置換: 型定数（Model.CLAUDE_OPUS_4_6 → Model.CLAUDE_OPUS_4_7）を含む全ファイルを対象に、各ファイルをcaller・model definer・opaque string referenceに分類してから編集
  • 廃止パラメータの除去: temperature・top_p・top_kの削除と、thinking設定のadaptiveへの書き換え
  • ベータヘッダーのクリーンアップ: 対象モデルでGAになったヘッダー（effort-2025-11-24など）を削除し、client.beta.messages.createをclient.messages.createに戻す
  • effortの推奨値提示: Claude Opus 4.7のコーディング・エージェント用途にはxhighを推奨
  • プロンプト挙動の警告: 長さ制御・ツール起動・サブエージェント指示が新モデルで変わる可能性のある箇所にフラグを立てる

処理完了後には、手動確認が必要な項目（統合テスト、プロンプトチューニング、コスト再計測など）がチェックリスト形式で出力されます。

プロンプトキャッシュの最適化診断

「キャッシュヒット率を上げたい」と依頼すると、スキルはプロンプト構造を分析して問題箇所を特定します。診断対象は、プレフィックスの安定性設計（毎回変わる部分が前半に混入していないか）、ブレークポイントの配置（キャッシュ境界が最適な位置にあるか）、サイレント無効化の原因（気づかずキャッシュが効いていない箇所の特定）の3つです。

開発者がドキュメントを読んで手動で追うよりも短時間で問題を特定できます。

Managed Agentsのセットアップ支援

長時間の調査・処理を自動化したい場合には、/claude-api managed-agents-onboardコマンドが使えます。

/claude-api managed-agents-onboard

スキルがインタビュー形式で質問しながら、Agent ConfigとSessionの設計をガイドします。出力されるのはそのまま動くコードで、対応言語はPython・TypeScript・Java・Go・Ruby・PHP・cURLの7つです。

Managed Agentsはanthropicライブラリのclient.beta.agents.*系APIを使い、エージェントの設定は一度だけ作成してIDで参照する設計です。model・system・toolsはエージェント側に持たせ、セッション起動のたびに渡さないというルールを、スキルがテンプレートコードで示します。

Managed AgentsはAnthropic直接利用のみで、Amazon BedrockやGoogle Vertex AI経由では使えません。スキルはこの制約も検知し、サードパーティ環境ではMessages API + tool useへ自動的に誘導します。

対応言語と他ツールへの展開

Messages APIは8言語（Python・TypeScript・Java・Go・Ruby・C#・PHP・cURL）に対応しています。Managed Agentsは7言語に対応しており、C#のみ未対応です。Rust・Swift・C++など非対応言語ではcURLのraw HTTPサンプルが提供されます。

2026年4月29日時点で、スキルが使える環境はClaude Code・CodeRabbit・JetBrains（Junie）・Resolve AI・Warpです。

Claude Code以外でインストールする場合は、以下のコマンドで追加できます。

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

スキルはオープンソースで公開されており、SDKの変更に追従して自動更新されます。自分のツールへ組み込む場合はAnthropicのバンドルガイドに従って20行程度のCI設定で完了します。

まとめ

/claude-apiスキルの核心は「常に最新の状態を維持する」ことです。モデルリリースやSDK変更があっても、スキル側が追従するため、開発者がドキュメントを都度追い直す手間がなくなります。Claude Codeユーザーは今すぐ/claude-apiと入力するだけで使い始めることができます。