Claude Code API完全ガイド【2026年最新】：Claude Agent SDKのインストール・使い方・/claude-apiスキルまで徹底解説

Claude Code APIとは？Claude Agent SDKの全貌【2026年最新】

Claude Code APIとClaude Agent SDKの関係

Claude Agent SDK（旧Claude Code SDK）のインストールと設定

pip install claude-agent-sdk

TypeScriptの場合はnpmで。

npm install @anthropic-ai/claude-agent-sdk

export ANTHROPIC_API_KEY=your-api-key

# Amazon Bedrockを使う場合
export CLAUDE_CODE_USE_BEDROCK=1

# Google Vertex AIを使う場合
export CLAUDE_CODE_USE_VERTEX=1

# Microsoft Azureを使う場合
export CLAUDE_CODE_USE_FOUNDRY=1

Pythonでエージェントを動かす：最小コードから実践まで

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions


async def main():
    async for message in query(
        prompt="What files are in this directory?",
        options=ClaudeAgentOptions(allowed_tools=["Bash", "Glob"]),
    ):
        if hasattr(message, "result"):
            print(message.result)


asyncio.run(main())

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions


async def main():
    async for message in query(
        prompt="Find and fix the bug in auth.py",
        options=ClaudeAgentOptions(
            allowed_tools=["Read", "Edit", "Glob"],
            permission_mode="acceptEdits"
        ),
    ):
        print(message)


asyncio.run(main())

TypeScriptでの実装

import Anthropic from "@anthropic-ai/claude-agent-sdk";

const client = new Anthropic();

async function main() {
  for await (const message of client.beta.claude_agent.query({
    prompt: "Find and fix the bug in auth.ts",
    options: {
      allowedTools: ["Read", "Edit", "Glob"],
      permissionMode: "acceptEdits",
    },
  })) {
    if ("result" in message) {
      console.log(message.result);
    }
  }
}

main();

/claude-apiスキル：Claude CodeにAnthropicのドキュメントを読ませる

Claude Agent SDKのオプション設定：systemPrompt・permissionMode・MCP連携

APIキーの認証と課金の仕組み

ストリーミングとシングルターンモードの違い

Claude Agent SDKのスキル・プラグインとの連携

よくある質問とトラブルシューティング

まとめ：Claude Code APIを使いこなすためのポイント

• Claude Code SDKはClaude Agent SDKに改名されました。パッケージ名はclaude-agent-sdk（Python）と@anthropic-ai/claude-agent-sdk（TypeScript）
• APIキーはANTHROPIC_API_KEY環境変数で設定。Consoleページ（https://console.anthropic.com）から取得
• query()関数がエントリーポイント。非同期イテレータで動く
• **allowed_tools**でツールを制限し、permission_mode="acceptEdits"で自動承認
• APIキー認証は従量課金。Proプランの定額とは別カウント
• /claude-apiスキルでAnthropicのドキュメントをコンテキストに自動ロード可能

出典

• Claude Agent SDK Overview - Anthropic公式ドキュメント
• Claude Agent SDK Quickstart - Anthropic公式ドキュメント
• Claude Code Skills - Bundled skills - /claude-apiスキルの仕様