Communitygithub.com

Claude API / Anthropic SDK リファレンス

Claude API / Anthropic SDK のリファレンス — モデルID、料金、パラメータ、ストリーミング、ツール使用、MCP、エージェント、キャッシング、トークンカウント、モデル移行をカバーします。

Anthropic SDK リファレンス とは?

このスキルは、Claude / Anthropic を使用して LLM を活用したアプリケーションを構築するための包括的なガイドです。Claude API、Managed Agents、Tool Runner、Claude Agent SDK など、さまざまな統合サーフェスをカバーしており、単一の LLM 呼び出しから複雑なマルチエージェントシステムまで、あらゆるユースケースに対応します。このスキルは、Python、TypeScript、Java、Go、Ruby、C#、PHP の公式 Anthropic SDK をサポートしており、プロジェクトファイルから使用言語を自動検出します。cURL や HTTP の例も提供しています。API のドリフト(例:拡張思考における `thinking` パラメータの変更や Web 検索ツールのバージョン更新)に関する最新情報を含み、開発者が常に最新の API 仕様に従ってコードを記述できるよう支援します。また、モデル移行のためのステップバイステップガイドも含まれており、既存のコードを新しいモデルに安全にアップグレードできます。

対応✓Claude Code✓Codex CLI~Cursor✓Antigravity✓Gemini CLI
npx skills add https://github.com/LiChangZheng10086/doyin_ai_video/tree/HEAD/.agents/skills/claude-api

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

Claude を使用した LLM 駆動アプリケーションの構築

このスキルは、Claude を使用した LLM 駆動アプリケーションの構築を支援します。ニーズに基づいて適切なサーフェスを選択し、プロジェクトの言語を検出して、関連する言語固有のドキュメントを参照してください。

始める前に

対象ファイル(または、対象ファイルがない場合はプロンプトとプロジェクト)をスキャンして、Anthropic 以外のプロバイダーのマーカー(import openai、from openai、langchain_openai、OpenAI(、gpt-4、gpt-5、agent-openai.py や *-generic.py などのファイル名、またはコードをプロバイダー非依存に保つという明示的な指示)がないか確認します。見つかった場合は、処理を停止し、このスキルは Claude/Anthropic SDK コードを生成するものであることをユーザーに伝えます。ファイルを Claude 用に切り替えるか、Claude 以外の実装を希望するかを尋ねてください。Anthropic 以外のファイルを Anthropic SDK 呼び出しで編集しないでください。

出力要件

ユーザーが Claude 機能の追加、変更、実装を依頼した場合、コードは次のいずれかを通じて Claude を呼び出す必要があります。

  1. 公式 Anthropic SDK(プロジェクトの言語に対応。anthropic、@anthropic-ai/sdk、com.anthropic.* など)。これは、プロジェクトにサポートされている SDK が存在する場合のデフォルトです。
  2. Raw HTTP(curl、requests、fetch、httpx など)— ユーザーが明示的に cURL/REST/raw HTTP を要求した場合、プロジェクトがシェル/cURL プロジェクトの場合、または言語に公式 SDK がない場合にのみ使用します。

この2つを決して混在させないでください。Python や TypeScript プロジェクトで、軽量だからという理由で requests/fetch を使用しないでください。OpenAI 互換のシムにフォールバックしないでください。

SDK の使用法を推測しないでください。 関数名、クラス名、名前空間、メソッドシグネチャ、インポートパスは、このスキルの {lang}/ ファイル、公式 SDK リポジトリ、または shared/live-sources.md にリストされているドキュメントリンクからの明示的なドキュメントに基づく必要があります。必要なバインディングがスキルファイルに明示的に文書化されていない場合は、コードを書く前に shared/live-sources.md から関連する SDK リポジトリを WebFetch してください。cURL の形状や別の言語の SDK から Ruby/Java/Go/PHP/C# の API を推測しないでください。

WebFetch またはリポジトリアクセスが失敗した場合(ネットワーク制限、タイムアウト、クローンのブロック):再試行を続けずに、{lang}/ ファイルのパターンと名前空間/パッケージテーブルからコードを書き、コンパイラまたはインタプリタを実行し、エラー出力に基づいて反復してください。静的型付け SDK(C#、Java、Go)の場合、ローカルエラーに対するコンパイル・修正ループの方が、ブロックされたネットワーク調査よりも早く動作するコードに到達できます。

デフォルト

ユーザーが特に要求しない限り:

Claude モデルバージョンには、Claude Opus 5 を使用してください。正確なモデル文字列 claude-opus-5 でアクセスできます。複雑な処理には、アダプティブ思考(thinking: {type: "adaptive"})をデフォルトで使用してください。また、長い入力、長い出力、高い max_tokens が予想されるリクエストには、デフォルトでストリーミングを使用してください。これにより、リクエストのタイムアウトを防ぐことができます。個々のストリームイベントを処理する必要がない場合は、SDK の .get_final_message() / .finalMessage() ヘルパーを使用して完全なレスポンスを取得してください。

⚠️ API ドリフト — トレーニングデータが古い可能性があります

いくつかの一般的な Claude API の形状は、2025~2026年に変更されました。トレーニングからパターンを覚えている場合は、コードを書く前にこのスキルの {lang}/ ファイルで確認してください。以下の行は、最も頻繁なドリフトポイントです。

領域古い知識現在の API
拡張思考thinking: {type: "enabled", budget_tokens: N}Claude 4.6+ モデル:thinking: {type: "adaptive"}。budget_tokens は Opus 4.6 / Sonnet 4.6 では非推奨であり、Fable 5 / Sonnet 5 / Opus 5 / 4.8 / 4.7 では 400 エラーで拒否されます。4.6 より前のモデルは引き続き budget_tokens を使用します。
Web 検索 / Web フェッチツールのタイプweb_search_20250305、web_fetch_20250910Opus 5/4.8/4.7/4.6、Sonnet 5、Sonnet 4.6 では web_search_20260209、web_fetch_20260209(動的フィルタリング)。古いモデルは基本バリアントを維持します。Vertex AI では基本の web_search_20250305 のみが利用可能で(Web フェッチは Vertex では利用不可)— 以下のサーバーツール QR を参照してください。
PHP パラメータ名スネークケースのワイヤ名を名前付き引数として使用(max_tokens)トップレベルの名前付き引数はキャメルケース(maxTokens)。ネストされた配列キーは機能によって異なります(例:'taskBudget'、'skillID'、'mcp_server_name')— ドキュメントの例から正確なキーをコピーしてください。一括変換しないでください。
Managed Agents の認証情報カスタムツールを介してホスト側でシークレットを保持(Vault が出荷される前の唯一のオプション)Vault environment_variable 認証情報 — Anthropic によって保存され、出力時に置き換えられ、サンドボックス内では決して表示されません(shared/managed-agents-tools.md → Vaults)。ホスト側のカスタムツールは、セルフホスト型サンドボックスのためのフォールバックとして残ります。

このスキルの {lang}/ ファイルは、覚えているパターンよりも優先されます。


サブコマンド

このプロンプトの下部にあるユーザーリクエストが、散文を含まない単なるサブコマンド文字列である場合、このドキュメント内のすべての サブコマンド テーブル(以下に追加されたセクションを含む)を検索し、該当するアクション列に直接従ってください。これにより、ユーザーは /claude-api <サブコマンド> で特定のフローを呼び出すことができます。ドキュメント内のテーブルが一致しない場合は、リクエストを通常の散文として扱ってください。

サブコマンドアクション
migrate既存の Claude API コードを新しいモデルに移行します。すぐに shared/model-migration.md を読み、順番に従ってください:ステップ0(スコープの確認 — 編集前にどのファイル/ディレクトリか尋ねる)、ステップ1(各ファイルを分類)、次にターゲットごとの破壊的変更セクション。ガイドを要約しないでください — 実行してください。ユーザーがターゲットモデルを指定しなかった場合は、スコープの質問と同じターンでどのモデルに移行するか尋ねてください。

言語検出

コード例を読む前に、ユーザーがどの言語で作業しているかを判断します。

  1. プロジェクトファイルを確認して言語を推測します。

    • *.py、requirements.txt、pyproject.toml、setup.py、Pipfile → Python — python/ を読む
    • *.ts、*.tsx、package.json、tsconfig.json → TypeScript — typescript/ を読む
    • *.js、*.jsx(.ts ファイルが存在しない) → TypeScript — JS は同じ SDK を使用するため、typescript/ を読む
    • *.java、pom.xml、build.gradle → Java — java/ を読む
    • *.kt、*.kts、build.gradle.kts → Java — Kotlin は Java SDK を使用するため、java/ を読む
    • *.scala、build.sbt → Java — Scala は Java SDK を使用するため、java/ を読む
    • *.go、go.mod → Go — go/ を読む
    • *.rb、Gemfile → Ruby — ruby/ を読む
    • *.cs、*.csproj → C# — csharp/ を読む
    • *.php、composer.json → PHP — php/ を読む
  2. 複数の言語が検出された場合(例:Python と TypeScript ファイルの両方):

    • ユーザーの現在のファイルや質問がどの言語に関連しているかを確認する
    • それでも曖昧な場合は、尋ねる:「Python と TypeScript の両方のファイルを検出しました。Claude API の統合にどの言語を使用していますか?」
  3. 言語が推測できない場合(空のプロジェクト、ソースファイルがない、またはサポートされていない言語):

    • AskUserQuestion を使用してオプションを提示:Python、TypeScript、Java、Go、Ruby、cURL/raw HTTP、C#、PHP
    • AskUserQuestion が利用できない場合は、Python の例をデフォルトとし、次のように注意書きをする:「Python の例を表示しています。別の言語が必要な場合はお知らせください。」
  4. サポートされていない言語が検出された場合(Rust、Swift、C++、Elixir など):

    • curl/ から cURL/raw HTTP の例を提案し、コミュニティ SDK が存在する可能性があることを伝える
    • 参考実装として Python または TypeScript の例を表示することを提案する
  5. ユーザーが cURL/raw HTTP の例を必要とする場合、curl/ から読み取ります。

言語固有の機能サポート

上記のすべての SDK 言語は、ベータ版の Tool Runner と Managed Agents(ベータ版)の両方をサポートしています。Python(@beta_tool デコレータ)、TypeScript(betaZodTool + Zod)、Java(アノテーション付きクラス)、Go(toolrunner パッケージの BetaToolRunner)、Ruby(BaseTool + tool_runner)、C#(BetaToolRunner + 生の JSON スキーマ)、PHP(BetaRunnableTool + toolRunner())。コードのエントリポイントは、以下のツール使用パターンのクイックリファレンスにあります。cURL は raw HTTP(SDK 機能なし)であり、Managed Agents をサポートしています。

Managed Agents のコード例:以下の「## Managed Agents (Beta)」セクションのリーディングガイドを参照してください。


どのサーフェスを使用すべきか?

シンプルに始めましょう。 ニーズを満たす最もシンプルな階層をデフォルトにしてください。単一の API 呼び出しとワークフローでほとんどのユースケースに対応できます。エージェントは、タスクが本当にオープンエンドでモデル駆動型の探索を必要とする場合にのみ使用してください。「最もシンプル」とは、あなたが所有するコードが最も少ないことを意味します。ホスト型、スケジュール型、メモリバックアップ型のエージェントには、Managed Agents が通常最もシンプルなオプションです(ループコード、状態ファイル、スケジューラが不要)が、より大きなプラットフォームです。

ユースケース階層推奨サーフェス理由
分類、要約、抽出、Q&A単一 LLM 呼び出しClaude API1リクエスト、1レスポンス
バッチ処理または埋め込み単一 LLM 呼び出しClaude API特殊なエンドポイント
コード制御ロジックによるマルチステップパイプラインワークフローClaude API + ツール使用ループをあなたが調整する
独自ツールを使用したカスタムエージェントエージェントClaude API + ツール使用最大の柔軟性
サーバー管理のステートフルエージェント(ワークスペース付き)エージェントManaged AgentsAnthropic がループを実行し、ツール実行サンドボックスをホストする
永続化、バージョン管理されたエージェント設定エージェントManaged Agentsエージェントは保存されたオブジェクト;セッションはバージョンに固定される
ファイルマウント付きの長時間実行マルチターンエージェントエージェントManaged Agentsセッションごとのコンテナ、SSE イベントストリーム、スキル + MCP
スケジュールで実行されるエージェント(cron、「毎晩」)エージェントManaged Agents — スケジュールされたデプロイメントデプロイメントが自律的にセッションを開始;クライアント側のスケジューラは不要

注記: Managed Agents は、Anthropic にエージェントループを実行させ、ツールが実行されるコンテナをホストさせたい場合に適切な選択です。ファイル操作、bash、コード実行はすべてセッションごとのワークスペースで実行されます。コンピュートを自分でホストするか、独自のカスタムツールランタイムを実行したい場合は、Claude API + ツール使用が適切な選択です。ツールランナーをエージェントループに使用してください。そのターンごとのフックは、承認ゲート、ロギング、エラーインターセプト、条件付き実行を提供します(shared/tool-use-concepts.md を参照)。ループ全体を自分で完全に制御したい場合は、手動ループを使用してください。

クラウドプロバイダーアクセス。 AWS 上の Claude Platform は Anthropic が運営し、同日 API パリティを提供します。クライアント設定は shared/claude-platform-on-aws.md を参照してください。AWS 上の Claude Platform、Amazon Bedrock、Google Vertex AI、Microsoft Foundry の機能ごとの可用性については、shared/platform-availability.md を参照してください。このテーブルはこのスキル内の唯一の情報源です。他の場所から可用性を推測しないでください。

エージェントの構築:4つのアプローチ

実際にエージェント(オープンエンドでモデル駆動型のツール使用)が必要だと判断したら、それを構築する4つの明確な方法があります。2つの独立した質問がそれらを区別します:誰がハーネスを提供するか(エージェントループ + コンテキスト管理)と誰がデプロイメントを提供するか(エージェントが実行されるインフラ)。Tool Runner と Claude Agent SDK はどちらも ハーネスのみ を提供します。それらを自分でホストしてデプロイする必要があります。これが、これらを混同しやすい理由です。Managed Agents (CMA) は、ハーネス と 管理されたデプロイメントの 両方 を提供する唯一のオプションです。手動ループはどちらも提供しません。

#アプローチあなたが書くものハーネスとデプロイメント利用可能なツール使用するタイミング
1Claude API — 手動ループwhile stop_reason == "tool_use" ループを自分で書くハーネスを構築;ホストは自分自分で定義したツールのみループ全体を完全に制御したい場合 — ベータ依存を避けたい、または Tool Runner のターンごとのフックに合わない制御フローがある場合
2Claude API — Tool Runner(client.beta.messages.tool_runner + @beta_tool / betaZodTool)ツール関数だけSDK がループを提供する(ハーネスのみ);ホストは自分自分で定義したツールのみ手動でループを書かずにカスタムツールエージェントが必要な場合(ほとんどのケース)。ターンごとのフックは、承認ゲート、エラーインターセプト、結果の変更(例:cache_control)、リトライ、ストリーミング、コンパクションを提供する
3Managed Agents(REST、ベータ版)エージェント設定 + ツール結果Anthropic がハーネス と セッションごとのサンドボックスを提供する(ハーネス + デプロイメント)Anthropic ホストのサンドボックス(bash、ファイル、コード実行)+ スキル/MCP + あなたのツールAnthropic にループを実行 させ、セッションごとのワークスペースをホストさせたい場合;永続化/バージョン管理された設定;長時間実行セッション
4Claude Agent SDK — 別製品(claude-agent-sdk / @anthropic-ai/claude-agent-sdk)プロンプト + オプションSDK が Claude Code のハーネス + 組み込みツールを提供する(ハーネスのみ);ホストは自分組み込みの Read/Write/Edit/Bash/Glob/Grep/WebSearch/WebFetch + MCP + サブエージェント独自のインフラで動作する、バッテリー同梱のコーディング/ファイルシステムエージェントが必要な場合

ハーネス/デプロイメントの分割が重要なメンタルモデルです:オプション1、2、4はすべて デプロイメントをあなたに任せます。オプション3(CMA)だけが管理されたデプロイメントを追加します。オプション1~3はこのスキルが生成するものです。オプション4は別のライブラリで、独自のドキュメントがあります。以下の区別を参照してください。

Tool Runner ≠ Claude Agent SDK。 これらは似たように聞こえますが、異なるパッケージです。

  • Tool Runner は通常の Anthropic API SDK(anthropic / @anthropic-ai/sdk)の一部で、client.beta.messages.tool_runner でアクセスします。

Individual skills in this repo

This repo contains 12 individual skills — each has its own dedicated page.

LiChangZheng10086/doyin_ai_video

Browser automation CLI for AI agents. Use when the user needs to interact with websites, including navigating pages, filling forms, clicking buttons, taking screenshots, extracting data, testing web apps, or automating any browser task. Triggers include requests to "open a website", "fill out a form", "click a button", "take a screenshot", "scrape data from a page", "test this web app", "login to a site", "automate browser actions", or any task requiring programmatic web interaction.

LiChangZheng10086/doyin_ai_video

Use this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation.

LiChangZheng10086/doyin_ai_video

Guidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.

LiChangZheng10086/doyin_ai_video

Grill me about specs for the workflows I want to build, within this workspace.

LiChangZheng10086/doyin_ai_video

Use this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill.

LiChangZheng10086/doyin_ai_video

智能 PPT 生成器。支持 7 种视觉风格(乐高/波普/黏土/黑白/商务/学术/科技),具备根据内容自动推荐风格、生成大纲、绘制配图并组装成片的全自动能力。

LiChangZheng10086/doyin_ai_video

Use this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions \"deck,\" \"slides,\" \"presentation,\" or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill.

LiChangZheng10086/doyin_ai_video

Diagnose and fix React codebase health issues. Use when reviewing React code, fixing performance problems, auditing security, or improving code quality.

LiChangZheng10086/doyin_ai_video

Sentry error monitoring and performance tracing patterns for Next.js applications.

LiChangZheng10086/doyin_ai_video

Simplify and refine recently modified code for clarity and consistency. Use after writing code to improve readability without changing functionality.

LiChangZheng10086/doyin_ai_video

✅ "你知道今天所有大模型能读懂你的话,全靠一个叫Transformer的架构吗?"

LiChangZheng10086/doyin_ai_video

Use this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like \"the xlsx in my downloads\") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.

関連スキル