터미널 기반 Agentic AI, Claude Code로 구현한 자동화 코딩 경험

Context

기존 AI 채팅 인터페이스는 사용자가 직접 코드를 복사하고 전달해야 하는 수동적 구조. 프로젝트 전체 파일 구조와 컨텍스트를 실시간으로 파악하지 못하는 한계 존재.

Technical Solution

• 터미널 환경에서 직접 실행되며 파일 시스템 읽기·쓰기 및 쉘 명령어를 수행하는 Agentic 워크플로우 설계
• CLAUDE.md 파일을 통한 프로젝트 기술 스택, 코딩 컨벤션, 아키텍처 결정 사항의 영속적 메모리 관리
• @ 참조 시스템을 활용하여 특정 파일이나 폴더의 내용을 컨텍스트로 즉시 주입하는 효율적 정보 추출 방식
• /model 및 /config 명령어를 통해 작업 복잡도에 따라 Claude Haiku 등 최적의 모델을 선택하는 비용 최적화 전략
• Default 모드 설정을 통해 AI가 제안한 코드 변경 사항을 개발자가 최종 승인하는 인간 중심의 제어 루프 구축

Impact

• 초기 포트폴리오 웹사이트 구축 비용 $0.01 발생
• 전체 프로젝트 구축 총 비용 $0.10 미만으로 유지
• 입력 토큰 약 390개, 출력 토큰 약 5.8k개 사용
• 세션당 API 처리 시간 34초 소요

Key Takeaway

AI 도구를 단순한 코드 생성기가 아닌 프로젝트 전체 컨텍스트를 공유하는 협업자로 정의하고, 명시적인 가이드라인 파일(CLAUDE.md)을 통해 AI의 추론 정확도를 높이는 설계 원칙의 중요성.