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

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

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

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

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

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

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

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

# 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())

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())

# 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が自動でやってくれる

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