Claude CodeでPythonを完全攻略【2026年最新】：Python開発・Agent SDK・スクリプト実行まで徹底解説

Claude CodeでPythonを完全攻略【2026年最新】：Python開発・Agent SDK・スクリプト実行まで徹底解説

Claude Codeの基本：PythonファイルはそのままAIに書かせる

cd /path/to/your-python-project
claude

Pythonスクリプトを実行させる方法

Python環境の設定（仮想環境・パッケージ管理）

## 開発環境
- Python 3.12（venv使用）
- 仮想環境の有効化: source venv/bin/activate
- パッケージ管理: pip（requirements.txt）
- テスト: pytest

PythonプロジェクトでのCLAUDE.md活用法

Claude CodeでPythonを使った実践的な開発フロー

よく使うPython開発コマンドパターン

# デバッグ
このスクリプトを実行してエラーが出たら修正してください: python3 src/process.py

# テスト追加
src/utils.pyのすべての関数にpytestテストを書いてください

# リファクタリング
src/legacy.pyをPEP 8に準拠するようにリファクタリングしてください

# ドキュメント
src/api.pyのすべての関数にdocstringを追加してください

# 型ヒント
src/models.pyに型ヒント（type hints）を追加してください

Claude Agent SDK（Python）でエージェントを作る

Claude Agent SDK（Python）のインストールと環境構築

# pip の場合
pip install claude-agent-sdk

# uv の場合
uv pip install claude-agent-sdk

export ANTHROPIC_API_KEY=your-api-key

最初のエージェント：バグを自動で見つけて修正する

import asyncio
from claude_agent_sdk import query, ClaudeAgentOptions, AssistantMessage, ResultMessage

async def main():
    # エージェントループを非同期でストリーミング実行
    async for message in query(
        prompt="utils.pyのバグを見つけて修正してください",
        options=ClaudeAgentOptions(
            allowed_tools=["Read", "Edit", "Glob"],  # 使えるツールを指定
            permission_mode="acceptEdits",  # ファイル編集を自動承認
        ),
    ):
        # メッセージをリアルタイムで受け取る
        if isinstance(message, AssistantMessage):
            for block in message.content:
                if hasattr(block, "text"):
                    print(block.text)  # Claudeの推論過程
                elif hasattr(block, "name"):
                    print(f"ツール実行: {block.name}")
        elif isinstance(message, ResultMessage):
            print(f"完了: {message.subtype}")

asyncio.run(main())

エージェントで使えるツール一覧

権限モードの設定

Claude Agent SDKの実践例：コードレビューを自動化する

import asyncio
import subprocess
from claude_agent_sdk import query, ClaudeAgentOptions, ResultMessage

async def review_pr():
    # 変更ファイルのリストを取得
    result = subprocess.run(
        ["git", "diff", "--name-only", "main...HEAD"],
        capture_output=True, text=True
    )
    changed_files = result.stdout.strip()
    
    if not changed_files:
        print("変更ファイルなし")
        return
    
    prompt = f"""
以下のファイルがPRで変更されました:
{changed_files}

各ファイルをレビューして以下を確認してください:
1. バグの可能性
2. パフォーマンスの問題
3. セキュリティリスク
4. コードスタイル（PEP 8）
レビュー結果をMarkdown形式で出力してください。
"""
    
    final_result = None
    async for message in query(
        prompt=prompt,
        options=ClaudeAgentOptions(
            allowed_tools=["Read", "Glob", "Grep"],
            permission_mode="dontAsk",  # 読み取り専用
        ),
    ):
        if isinstance(message, ResultMessage):
            final_result = message
    
    if final_result:
        print(final_result.result)

asyncio.run(review_pr())

Claude APIのPython SDKとの違い

# anthropic（Client SDK）の場合
# ツールループを自分で書く必要がある
import anthropic
client = anthropic.Anthropic()
response = client.messages.create(
    model="claude-sonnet-4-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "utils.pyのバグを修正して"}]
)
# この後、tool_useがあれば自分でファイルを読んで、修正して、
# 結果をまたAPIに送って...というループを自分で実装する必要がある

# claude-agent-sdk（Agent SDK）の場合
# ループは全て自動
from claude_agent_sdk import query, ClaudeAgentOptions
async for message in query(
    prompt="utils.pyのバグを修正してください",
    options=ClaudeAgentOptions(allowed_tools=["Read", "Edit"])
):
    print(message)
# ファイルを読む→バグを見つける→修正する→確認する
# というループをSDKが自動でやってくれる

Claude CodeでPythonプロジェクトを開発するベストプラクティス

プロジェクト構成を最初に設計させる

テスト駆動開発（TDD）との組み合わせ

1. 「この関数の仕様に基づいてpytestテストを書いてください」
2. 「このテストをパスするように実装してください」
3. 「テストを実行して失敗したら修正してください」

という3ステップです。Step 3でClaude Codeが自律的にテスト→修正→テストを繰り返します。

デバッグはエラーメッセージをそのまま渡す

よくある質問（FAQ）

Q. Claude CodeはPython以外の言語も使えますか？

Q. Claude Agent SDKは無料で使えますか？

Q. AWS BedrockやGoogle VertexからもClaude Agent SDKは使えますか？

• AWS Bedrock: CLAUDE_CODE_USE_BEDROCK=1 を設定してAWSの認証情報を用意
• Google Vertex AI: CLAUDE_CODE_USE_VERTEX=1 を設定してGCPの認証情報を用意

Q. Pythonの仮想環境でClaude Agent SDKを使うには？

python3 -m venv venv
source venv/bin/activate  # macOS/Linux
pip install claude-agent-sdk

まとめ：Claude Code × Pythonの使い分けポイント

出典

• Claude Agent SDK 公式ドキュメント（Anthropic）
• claude-agent-sdk PyPI パッケージ（Anthropic）
• Claude Code 公式ドキュメント（Anthropic）