비개발자가 AI 에이전트로 코딩하는 법: 새로운 기술 계층의 등장

섹션별 상세

CLI 중심의 에이전트 워크플로를 구축하여 개발 효율성을 극대화했다. 웹 인터페이스보다 터미널 환경에서 에이전트의 작업 과정을 직접 모니터링하는 것이 오류 수정과 시스템 이해에 훨씬 유리하다. Droid와 같은 CLI 에이전트를 사용하면 로컬 파일 시스템과 직접 상호작용하며 복잡한 명령을 수행할 수 있다.

코드를 직접 작성하지 않고도 에이전트의 출력을 면밀히 검토하며 시스템 아키텍처를 학습한다. 에이전트가 생성하는 로그와 오류 메시지를 분석하는 과정에서 프로젝트 구조, 데이터 흐름, 실패 지점 등을 파악하게 된다. 저자는 이를 '바이브 코딩'을 넘어선 새로운 형태의 프로그래밍 학습으로 정의한다.

지침 파일인 `agents.md`를 활용해 에이전트의 행동을 정교하게 제어한다. 각 프로젝트 폴더에 깃허브 커밋 방식, 테스트 실행 규칙, 계정 설정 등을 명시한 파일을 두어 에이전트가 일관된 품질의 작업을 수행하도록 유도한다. 타인의 설정 파일을 참고하여 자신의 워크플로를 지속적으로 최적화하는 과정이 포함된다.

실제 운영 가능한 수준의 복잡한 프로젝트들을 다수 구현했다. 개인 사이트 리뉴얼부터 암호화폐 트래커, AI 감독 비디오 데모 시스템, 텔레그램 봇 등 50개 이상의 결과물을 만들어냈다. 특히 VPS와 SyncThing을 연동하여 로컬 작업 내역을 서버와 실시간 동기화함으로써 상시 가동되는 서비스를 구축하는 역량을 확보했다.

효율적인 도구 선택을 위해 MCP 대신 CLI 도구를 직접 활용한다. MCP는 모델의 컨텍스트를 과도하게 점유하는 경향이 있어, Supabase나 Vercel 같은 서비스의 순수 CLI를 에이전트가 실행하도록 하여 성능을 높인다. 필요한 경우 특정 기능을 수행하는 전용 CLI를 직접 제작하여 에이전트의 도구함(Toolbox)을 확장한다.

용어 해설

바이브 코딩(Vibe Coding): — 엄격한 코드 문법이나 논리적 구조를 직접 작성하기보다 AI 에이전트와의 대화와 직관적인 피드백을 통해 소프트웨어를 개발하는 방식이다. 개발자가 코드를 한 줄씩 이해하지 못하더라도 전체적인 시스템의 흐름과 결과물의 작동 여부에 집중하여 결과물을 만들어내는 것이 핵심이다. 비개발자가 복잡한 애플리케이션을 신속하게 구축할 수 있게 하는 새로운 개발 패러다임으로 주목받고 있다.
명령줄 인터페이스(CLI): — 텍스트 터미널을 통해 사용자가 컴퓨터에 명령을 입력하고 결과를 확인하는 인터페이스 방식이다. 그래픽 사용자 인터페이스(GUI)보다 자동화가 용이하고 AI 에이전트가 시스템 자원에 직접 접근하여 명령을 실행하기에 적합한 환경을 제공한다. 숙련된 개발자뿐만 아니라 AI 에이전트를 활용하는 사용자들에게 필수적인 도구로 재조명받고 있다.
가상 사설 서버(VPS): — 물리적 서버를 가상화하여 사용자에게 독립적인 서버 환경을 제공하는 서비스이다. 클라우드 상에서 24시간 가동되므로 암호화폐 트래커나 봇과 같이 중단 없이 실행되어야 하는 프로그램을 호스팅하는 데 사용된다. 로컬 컴퓨터의 한계를 넘어 실제 서비스 환경을 구축하는 데 필수적인 인프라 요소이다.
모델 컨텍스트 프로토콜(MCP): — AI 모델이 외부 도구, 데이터 소스 및 서비스와 상호작용할 수 있도록 정의된 표준 프로토콜이다. 에이전트가 데이터베이스나 API에 접근할 수 있게 돕지만, 많은 컨텍스트 창을 점유할 수 있다는 단점이 있다. 본문에서는 효율성을 위해 MCP 대신 가벼운 CLI 도구를 직접 사용하는 대안적 접근법이 제시된다.
에이전트 지침 파일(agents.md): — 특정 프로젝트 폴더 내에 위치하여 AI 에이전트가 준수해야 할 규칙, 코딩 스타일, 워크플로 등을 명시한 마크다운 파일이다. 에이전트에게 프로젝트의 맥락과 제약 사항을 전달하여 일관된 코드 품질을 유지하고 실수를 방지하는 역할을 한다. 개인화된 개발 환경을 구축하고 에이전트의 성능을 최적화하는 핵심 수단이다.

기술

Droid
Opus 4.5
Bash
VPS
SyncThing
Supabase CLI
Vercel CLI

활용 사례

개인 포트폴리오 사이트 구축
암호화폐 자동 매매 트래커
AI 기반 비디오 제작 자동화 시스템
커스텀 CLI 도구 개발

언급된 리소스

문서Simon Willison's Year in LLMs

GitHubTigma - Terminal Design Tool

GitHubWorktrunk - Git Worktree Manager