AI 코딩 에이전트 아키텍처 해부 — 내부 동작 원리와 설계 패턴

ReAct 루프 — 에이전트의 핵심 동작 원리

ReAct 루프 — Python 의사 코드 구현
from anthropic import Anthropic

client = Anthropic()
tools = [read_file_tool, write_file_tool, run_bash_tool, search_tool]

def run_agent(task: str, max_steps: int = 20) -> str:
    messages = [{"role": "user", "content": task}]

    for step in range(max_steps):
        # LLM에게 현재 상태를 넘기고 다음 행동 결정
        response = client.messages.create(
            model="claude-opus-4-5",
            max_tokens=4096,
            tools=tools,
            messages=messages,
        )

        # 도구 호출이 없으면 최종 답변 반환
        if response.stop_reason == "end_turn":
            return response.content[0].text

        # 도구 호출이 있으면 실행하고 결과를 컨텍스트에 추가
        if response.stop_reason == "tool_use":
            messages.append({"role": "assistant", "content": response.content})

            tool_results = []
            for block in response.content:
                if block.type == "tool_use":
                    result = execute_tool(block.name, block.input)
                    tool_results.append({
                        "type": "tool_result",
                        "tool_use_id": block.id,
                        "content": str(result),
                    })

            messages.append({"role": "user", "content": tool_results})

    return "Max steps reached without completing the task"

도구 호출 설계 — 에이전트가 쓰는 도구의 종류와 설계 원칙

Anthropic Tool Use API — 도구 정의 예시
tools = [
    {
        "name": "read_file",
        "description": "Read the contents of a file at the given path. Returns the file content as a string.",
        "input_schema": {
            "type": "object",
            "properties": {
                "path": {
                    "type": "string",
                    "description": "Absolute or relative path to the file"
                }
            },
            "required": ["path"]
        }
    },
    {
        "name": "run_bash",
        "description": "Execute a bash command and return stdout/stderr. Use for running tests, installing packages, or checking system state.",
        "input_schema": {
            "type": "object",
            "properties": {
                "command": {
                    "type": "string",
                    "description": "The bash command to execute"
                },
                "timeout": {
                    "type": "number",
                    "description": "Timeout in seconds (default: 30)"
                }
            },
            "required": ["command"]
        }
    }
]

컨텍스트 관리 — 에이전트가 얼마나 기억할 수 있나

에러 복구 — 에이전트가 스스로 고치는 원리

Claude Code / Cursor / Devin — 아키텍처 비교