Démarrage rapide

1. Configurer un projet avec le SDK Agent
2. Créer un fichier avec du code contenant des bugs
3. Exécuter un agent qui trouve et corrige les bugs automatiquement

​

Prérequis

• Node.js 18+ ou Python 3.10+
• Un compte Anthropic (s’inscrire ici)

​

Configuration

mkdir my-agent && cd my-agent

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

uv init && uv add claude-agent-sdk

python3 -m venv .venv && source .venv/bin/activate
pip3 install claude-agent-sdk

ANTHROPIC_API_KEY=your-api-key

​

Créer un fichier avec des bugs

def calculate_average(numbers):
    total = 0
    for num in numbers:
        total += num
    return total / len(numbers)


def get_user_name(user):
    return user["name"].upper()

1. calculate_average([]) plante avec une division par zéro
2. get_user_name(None) plante avec une TypeError

​

Créer un agent qui trouve et corrige les bugs

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


async def main():
    # Agentic loop: streams messages as Claude works
    async for message in query(
        prompt="Review utils.py for bugs that would cause crashes. Fix any issues you find.",
        options=ClaudeAgentOptions(
            allowed_tools=["Read", "Edit", "Glob"],  # Tools Claude can use
            permission_mode="acceptEdits",  # Auto-approve file edits
        ),
    ):
        # Print human-readable output
        if isinstance(message, AssistantMessage):
            for block in message.content:
                if hasattr(block, "text"):
                    print(block.text)  # Claude's reasoning
                elif hasattr(block, "name"):
                    print(f"Tool: {block.name}")  # Tool being called
        elif isinstance(message, ResultMessage):
            print(f"Done: {message.subtype}")  # Final result


asyncio.run(main())

1. query : le point d’entrée principal qui crée la boucle agentique. Il retourne un itérateur asynchrone, vous utilisez donc async for pour diffuser les messages au fur et à mesure que Claude travaille. Consultez l’API complète dans la référence du SDK Python ou TypeScript.
2. prompt : ce que vous voulez que Claude fasse. Claude détermine les outils à utiliser en fonction de la tâche.
3. options : configuration de l’agent. Cet exemple utilise allowedTools pour pré-approuver Read, Edit et Glob, et permissionMode: "acceptEdits" pour approuver automatiquement les modifications de fichiers. Les autres options incluent systemPrompt, mcpServers et bien d’autres. Consultez toutes les options pour Python ou TypeScript.

​

Exécuter votre agent

python3 agent.py

npx tsx agent.ts

1. Lu utils.py pour comprendre le code
2. Analysé la logique et identifié les cas limites qui causeraient un plantage
3. Modifié le fichier pour ajouter une gestion d’erreur appropriée

​

Essayer d’autres invites

• "Add docstrings to all functions in utils.py"
• "Add type hints to all functions in utils.py"
• "Create a README.md documenting the functions in utils.py"

​

Personnaliser votre agent

options = ClaudeAgentOptions(
    allowed_tools=["Read", "Edit", "Glob", "WebSearch"], permission_mode="acceptEdits"
)

options = ClaudeAgentOptions(
    allowed_tools=["Read", "Edit", "Glob"],
    permission_mode="acceptEdits",
    system_prompt="You are a senior Python developer. Always follow PEP 8 style guidelines.",
)

options = ClaudeAgentOptions(
    allowed_tools=["Read", "Edit", "Glob", "Bash"], permission_mode="acceptEdits"
)

​

Concepts clés

​

Dépannage

​

Erreur API thinking.type.enabled n’est pas pris en charge pour ce modèle

API Error: 400 {"type":"invalid_request_error","message":"\"thinking.type.enabled\" is not supported for this model. Use \"thinking.type.adaptive\" and \"output_config.effort\" to control thinking behavior."}

​

Étapes suivantes

• Permissions : contrôlez ce que votre agent peut faire et quand il a besoin d’approbation
• Hooks : exécutez du code personnalisé avant ou après les appels d’outils
• Sessions : créez des agents multi-tours qui maintiennent le contexte
• Serveurs MCP : connectez-vous à des bases de données, des navigateurs, des API et d’autres systèmes externes
• Hébergement : déployez des agents sur Docker, le cloud et CI/CD
• Agents d’exemple : consultez des exemples complets : assistant e-mail, agent de recherche et bien d’autres