Claude Code가 SSE 스트리밍 기반 에이전트 루프와 5단계 권한 검증을 결합하여 실시간 협업 코딩을 가능하게 하는 구조

Context

기존 AI 코딩 어시스턴트는 채팅 인터페이스에 코드 플러그인을 붙인 형태로, 각 도구 호출마다 별도 API 요청이 필요했다. 긴 응답 완료 후에만 결과를 확인할 수 있어 복잡한 다단계 작업에서 지연을 경험했다.

Technical Solution

• Claude 응답 처리 → Server-Sent Events로 실시간 스트리밍하며, 응답 완료 전 도구 호출을 감지하고 실행 파이프라인 트리거
• 단일 API 호출 → 복수의 tool_use 블록 반환 및 순차 실행으로 Glob, Grep, Read 등 동시 수행
• 도구 시스템 → 26개 내장 도구 인터페이스(Zod 입력 검증, permission check, 실행 로직, 터미널 렌더러)
• Task 서브에이전트 → 자식 컨텍스트 생성하여 코드bases 일부 조사와 동시 편집 병렬화
• 5단계 권한 검증 → tool check, settings allowlist, sandbox policy, permission mode, hook override 순차 통과
• 5개 권한 모드 → default, acceptEdits, plan, bypassPermissions, auto
• 설정 계층 → Defaults → ~/.claude/settings.json → .claude/settings.json → .claude/settings.local.json → CLI flags → 환경 변수 순서 병합
• MCP 서버 → 런타임에 커스텀 도구 동적 추가

Impact

복잡한 다단계 작업 중에도 와 도구 호출이 실시간으로 표시되어 지연 인식 최소화. 서브에이전트 병렬화로 순차 처리 대비 작업 시간 단축.

Key Takeaway

모든 주요 액션에 pre/post hook 포인트를 제공하고 스트리밍 우선 설계로 복잡성을 감수하더라도 응답성을 우선시한 설계 철학.