---
title: Claude APIスキル
url: https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/claude-api-skill
description: Claude APIおよびClaude Managed Agentsを使用したアプリケーション構築のための最新のAPIリファレンス資料、SDKドキュメント、ベストプラクティスをClaudeに提供する、オープンソースのAgent Skillです。
---
`claude-api`スキルは、オープンソースの[Agent Skill](https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/overview)です。Anthropicの2つのサーフェス上でアプリケーションを構築するための、詳細かつ最新のリファレンス資料をClaudeに提供します。
* **Messages API：** 単一リクエスト、ストリーミングチャット、「tool use」（ツール使用）、バッチ処理、「prompt caching」（プロンプトキャッシング）、「structured outputs」（構造化出力）、カスタムエージェントループのための主要なサーフェスです。
* **Claude Managed Agents（ベータ）：** サーバー管理型のステートフルなエージェントのための、Anthropicがホストするサーフェスです。Anthropicがホストするツール実行、永続的なエージェント設定、セッションごとのサンドボックスを備えています。
Messages APIとManaged Agentsの両方について、Python、TypeScript、C#、Go、Java、PHP、Ruby、cURLの8つのプログラミング言語をカバーしています。
このスキルは[Claude Code](https://code.claude.com/docs/ja/overview)にバンドルされているほか、オープンソースの[Anthropicスキルリポジトリ](https://github.com/anthropics/skills)でも公開されており、Agent Skillsをサポートする任意の環境にインストールできます。
このスキルは「[progressive disclosure](https://platform.claude.com/docs/ja/agents-and-tools/agent-skills/overview#how-skills-work)」（段階的開示）を使用してコンテキストを効率的に保ちます。Claudeはすべてを一度に読み込むのではなく、プロジェクトの言語、サーフェス（Messages APIまたはManaged Agents）、および当面の具体的なタスク（ツール使用、ストリーミング、バッチなど）に関連するドキュメントのみを読み込みます。
## スキルが提供するもの
トリガーされると、このスキルはClaudeに以下を提供します。
**Messages API向け：**
* **言語固有のSDKドキュメント：** プロジェクトの言語に対応したインストール、クイックスタート、一般的なパターン、エラー処理
* **ツール使用のガイダンス：** 関数呼び出しに関する言語固有の例と[概念的な基礎](https://platform.claude.com/docs/ja/agents-and-tools/tool-use/overview)（利用可能な場合はベータ版のツールランナーを含む）
* **ストリーミングパターン：** チャットUIの構築と段階的な表示の処理に関する実装の詳細
* **バッチ処理：** 50%のコストでのオフラインバッチ処理
* **プロンプトキャッシング：** プレフィックスの安定性を考慮した設計、ブレークポイントの配置、サイレントな無効化要因の監査
* **モデル移行：** 新しいClaudeモデルへの移行に関するステップバイステップのガイダンス（[Claude Opus 5.5](https://platform.claude.com/docs/ja/models/opus-5-5/migration-guide#migrating-from-claude-opus-5)、[Claude Sonnet 5.5](https://platform.claude.com/docs/ja/models/sonnet-5-5/migration-guide#migrating-from-claude-sonnet-5)、[Claude Haiku 5.5](https://platform.claude.com/docs/ja/models/haiku-5-5/migration-guide)、および[Claude Fable 5.1](https://platform.claude.com/docs/ja/models/fable-5-1/migration-guide)における破壊的変更と動作の変化を含む）
* **保持された思考への移行：** `thinking`ブロックを無効化する履歴の編集の検出、測定、修正（`/claude-api preserved-thinking-migration`サブコマンドで利用可能）
* **最新のモデル情報：** モデルID、コンテキストウィンドウのサイズ、料金
* **よくある落とし穴：** APIとの統合時によくある間違いを避けるための詳細なガイダンス
**Managed Agents（ベータ）向け：**
* **オンボーディングフロー：** 新しいManaged Agentをゼロからセットアップするための、インタビュー形式のウォークスルー。`/claude-api managed-agents-onboard`サブコマンドで利用できます
* **言語固有のManaged Agentsドキュメント：** Python、TypeScript、C#、Go、Java、PHP、Ruby、cURLでの永続的なエージェントの作成、セッションの開始、イベントのストリーミング、ツール確認の処理
* **クライアントパターン：** ロスのないストリーム再接続、`processed_at`によるキュー済み/処理済みの判定、割り込み処理、ファイルマウントの注意点、認証情報の取り扱い
* **デプロイメントの制約：** Managed AgentsはClaude APIと[Claude Platform on AWS](https://platform.claude.com/docs/ja/build-with-claude/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`）を調べることでプロジェクトの言語を自動的に検出し、適切なドキュメントを読み込みます。
| 言語 | Messages API SDK | ツールランナー | Managed Agents |
| ---------- | ---------------- | ------- | -------------- |
| Python | はい | はい（ベータ） | はい（ベータ） |
| TypeScript | はい | はい（ベータ） | はい（ベータ） |
| C# | はい | はい（ベータ） | はい（ベータ） |
| Go | はい | はい（ベータ） | はい（ベータ） |
| Java | はい | はい（ベータ） | はい（ベータ） |
| PHP | はい | はい（ベータ） | はい（ベータ） |
| Ruby | はい | はい（ベータ） | はい（ベータ） |
| cURL | はい | 該当なし | はい（ベータ） |
プロジェクトで複数の言語を使用している場合、Claudeはどの言語が該当するかを尋ねます。サポートされていない言語（Rust、Swift、C++）の場合、スキルはcURL/生のHTTPの例を提供します。
## スキルの使い方
### Claude Code内（バンドル版）
このスキルは[Claude Code](https://code.claude.com/docs/ja/overview)に同梱されており、インストールは不要です。Claude APIを使用した何かの構築をClaudeに依頼した場合や、プロジェクトがすでにAnthropic SDKをインポートしている場合、スキルは自動的に有効になります。
直接呼び出すこともできます。
Claude Codeでこのスキルを使用する
```text
/claude-api
```
Claude Codeでバンドルされたスキルがどのように機能するかの詳細については、[Claude Codeのスキルに関するドキュメント](https://code.claude.com/docs/ja/skills#bundled-skills)を参照してください。
### スキルリポジトリから
スキルのソースは[Anthropicスキルリポジトリ](https://github.com/anthropics/skills)で公開されています。`npx`コマンドを使用してインストールできます。
```bash
npx skills add https://github.com/anthropics/skills --skill claude-api
```
または、[Claude Codeプラグイン](https://code.claude.com/docs/ja/plugins)としてインストールするようClaude Codeに依頼することもできます。
Claude Codeにインストールを任せる
```text
anthropics/skillsプラグインマーケットプレイスからclaude-apiプラグインをインストールしてください
```
```text wrap
/plugin marketplace add anthropics/skills
/plugin install claude-api@anthropic-agent-skills
```
## 新しいClaudeモデルへの移行
Claude APIスキルは、コードベース全体にわたってClaudeモデルの移行を実行できます。`/claude-api migrate`で直接呼び出します。
Claude Codeにコードの移行を任せる
```text
/claude-api migrate このプロジェクトを最新のClaude Opusモデルに移行してください
```
スコープ確認の質問をスキップするために、特定のスコープを最初から渡すこともできます。
Claude Codeにコードの移行を任せる
```text
/claude-api migrate src/配下のすべてを最新のClaude Opusモデルに移行してください
```
Claude Codeにコードの移行を任せる
```text
/claude-api migrate apps/api.pyとapps/worker.pyを最新のClaude Opusモデルに移行してください
```
スコープが曖昧な場合（たとえば、単に`/claude-api migrate to claude-opus-5-5`とした場合）、スキルはファイルを編集する前に、作業ディレクトリ全体、特定のサブディレクトリ、または明示的なファイルリストのいずれかを選択するよう求めます。これはMessages APIとManaged Agentsの両方の呼び出し元に適用されます。
このスキルは以下を処理します。
* **モデルIDの置き換え：** サポートされているすべての言語における型付きSDK定数（`Model.CLAUDE_OPUS_4_8` → `Model.CLAUDE_OPUS_5_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"}`に変換したりします
* **プリフィルの置き換え：** 該当する場合、アシスタントメッセージのプリフィルパターンを[構造化出力](https://platform.claude.com/docs/ja/build-with-claude/structured-outputs)に変換します
* **ベータヘッダーのクリーンアップ：** ターゲットモデルで不要なベータヘッダー（たとえば、`effort-2025-11-24`、`fine-grained-tool-streaming-2025-05-14`、`interleaved-thinking-2025-05-14`）を削除し、`client.beta.messages.create()` (go: `client.Beta.Messages.New()`; java: `client.beta().messages().create()`; csharp: `client.Beta.Messages.Create()`; php: `$client->beta->messages->create()`)から`client.messages.create()` (go: `client.Messages.New()`; java: `client.messages().create()`; csharp: `client.Messages.Create()`; php: `$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"`）を再度オプトインします
* **拒否フォールバックの設定：** ターゲットがClaude Fable 5.1、Claude Fable 5、Claude Opus 5.5、Claude Opus 5、またはClaude Sonnet 5.5の場合、レスポンスの内容を読み取る前に`stop_reason: "refusal"`の処理を追加し、[フォールバック再試行パス](https://platform.claude.com/docs/ja/build-with-claude/refusals-and-fallback)（サーバー側の`fallbacks`パラメータ（通常は`"default"`モード）、SDKの拒否フォールバックミドルウェア、またはフォールバッククレジットによる再試行）をセットアップします。また、以前のプレビュー版の形式に基づいて書かれたフォールバックコードを更新します
スキルは編集を進めながら、各変更とその理由をインラインで説明します。完了時には、手動での検証が必要な項目のチェックリスト（通常は統合テスト、長さ制御のプロンプト調整、コスト/「rate limit」（レート制限）のベースライン再設定）を作成します。
スキルが適用するモデル固有の変更の完全なリストについては、[Claude Opus 5からClaude Opus 5.5への移行](https://platform.claude.com/docs/ja/models/opus-5-5/migration-guide#migrating-from-claude-opus-5)、[Claude Opus 4.8からClaude Opus 5.5への移行](https://platform.claude.com/docs/ja/models/opus-5-5/migration-guide#migrating-from-claude-opus-4-8)、[Claude Sonnet 5からClaude Sonnet 5.5への移行](https://platform.claude.com/docs/ja/models/sonnet-5-5/migration-guide#migrating-from-claude-sonnet-5)、[Claude Haiku 5.5移行ガイド](https://platform.claude.com/docs/ja/models/haiku-5-5/migration-guide)、および[Claude Fable 5.1およびClaude Mythos 5.1移行ガイド](https://platform.claude.com/docs/ja/models/fable-5-1/migration-guide)を参照してください。
## 保持された思考に対応するための統合のチェック
「[Preserved thinking](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking)」（保持された思考）は、`system`プロンプト、`tools`、およびその前のメッセージが変更されない間のみ、`thinking`ブロックを有効に保ちます。コードがその履歴を編集している箇所を見つけて修正するには、リクエストを構築するリポジトリを開き、`preserved-thinking-migration`サブコマンドを呼び出します。
Claude Codeにコードのチェックを任せる
```text
/claude-api preserved-thinking-migration
```
スキルは次の5つのステップで作業を進めます。
1. **スコープ：** 統合が影響を受けるかどうかを確認し、その後3つのテストリクエストを送信して、意図的な編集をAPIが報告することを確認します。
2. **検出：** 独自のマルチターンセッションをいくつかキャプチャし、連続するリクエストの差分を取り、コードがプレフィックスを編集している各箇所を一覧表示します。
3. **測定：** `"drop_block"`を使用してセッションを再生し、どの会話で`thinking`ブロックが失われるか、どのターンで、なぜ失われるかを報告します。
4. **修正：** 編集を1つずつ、[プレフィックスを編集せずに変更を加える](https://platform.claude.com/docs/ja/build-with-claude/preserved-thinking#replace-prefix-edits)の対応するパターンに置き換え、各変更の後に再度測定します。
5. **レポート：** 各原因、それに対して行った変更、および変更前後の件数をまとめます。
プロジェクトに評価（eval）がある場合、スキルは`thinking`ブロックが削除された場合とされない場合のスコアとトークン使用量も比較します。
テストリクエストと再生は実際のMessages APIリクエストであり、モデルの通常料金で課金されます。各再生はごく少数の出力トークンのみをリクエストし、`tool_choice`を`none`に設定するため、ツールは実行されません。スキルは送信前にコストを提示し、承認を求めます。
## Managed Agentのセットアップ
新しいManaged Agentをゼロから構築するには、`managed-agents-onboard`サブコマンドを呼び出します。
Claude Codeにエージェントのセットアップを任せる
```text
/claude-api managed-agents-onboard
```
スキルはインタビューを実行し、Managed Agentsのメンタルモデル（エージェント設定とセッションの違い）の説明、エージェント設定のテンプレート化、環境とツールの構成、セッションループのセットアップを順に案内し、使用している言語で実行可能なコードを出力します。また、スキルは必須の**エージェント（1回）→ セッション（実行ごと）**のフローもカバーしています。`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の処理を支援するタスクの例です。
**チャットアプリケーションの構築：**
Claude Codeに構築を任せる
```text
TypeScriptでClaude APIを使用したストリーミングチャットUIを構築してください
```
**既存プロジェクトの移行：**
Claude Codeにコードの移行を任せる
```text
/claude-api migrate このコードベースを最新のClaude Opusモデルに移行し、effortを再調整してください
```
**新しいManaged Agentのオンボーディング：**
Claude Codeにエージェントのセットアップを任せる
```text
/claude-api managed-agents-onboard
```
いずれの場合も、スキルは関連する言語固有のドキュメントを読み込み、最新のAPIパターンとベストプラクティスを使用して実装を進めるようClaudeをガイドします。
## 次のステップ
Agent Skillsの仕組みと段階的開示モデルについて学びます
サポートされているすべての言語向けの公式Anthropic SDKを参照します
GitHub上の公開Anthropicスキルリポジトリを探索します