plandex
무엇인가
Plandex는 터미널에서 동작하는 AI 코딩 에이전트로, 여러 단계에 걸쳐 수십 개 파일을 건드리는 작업을 계획(plan)과 실행(execute)으로 나눠 처리한다. 인라인 자동완성형 어시스턴트가 아니라, 하나의 작업을 상태를 가진 plan 단위로 관리하는 실행기에 속한다. 대형 저장소와 큰 파일에서 다른 도구가 한계에 부딪히는 지점을 겨냥한다.
어떻게 동작하나
프로젝트 맵은 tree-sitter로 소스를 파싱해 만들며 30개 이상 언어를 다룬다. 20M 토큰 이상 규모의 디렉터리도 인덱싱하고, 각 단계마다 필요한 파일만 컨텍스트에 로드한다. 기본 모델 팩 기준 유효 컨텍스트는 2M 토큰, 파일당 약 100k 토큰이다. OpenAI·Anthropic·Google 모델 전반에 컨텍스트 캐싱을 적용해 비용과 지연을 줄인다. AI가 만든 편집은 누적 diff 샌드박스에 쌓여 적용 전까지 프로젝트 파일과 분리되고, 명령 실행도 통제되어 롤백과 디버깅이 가능하다. plan의 모든 업데이트는 버전 관리되며 브랜치로 여러 경로를 탐색하거나 모델을 비교할 수 있다. 파일 편집은 구문과 로직을 검증하고 문제가 생기면 여러 단계의 폴백을 거친다.
무엇과 다른가
IDE 인라인 어시스턴트는 편집을 즉시 파일에 반영하고 컨텍스트를 편집 지점 주변으로 한정한다. Plandex는 변경을 샌드박스에 누적하고 plan 단위로 이력을 남기며, 컨텍스트를 단계별로 다시 고른다. 단일 모델에 고정하는 대신 Anthropic·OpenAI·Google·오픈소스 제공자를 모델 팩으로 조합한다. 자율성 수준을 설정할 수 있어 전체 자동 모드와 단계별 검토 사이를 오간다.
어떻게 쓰나
작업할 프로젝트 디렉터리로 이동한 뒤 `plandex`를 실행하면 REPL이 열린다. 명령과 파일 로딩에 퍼지 자동완성이 붙는다. CLI로 스크립팅하거나 데이터를 파이프로 컨텍스트에 넣을 수도 있다. 첫 실행 시 Claude Pro/Max 구독 연결 여부를 묻고, 그 외에는 모델 제공자 키를 설정한다. 서버는 클라우드 호스팅과 Docker 기반 로컬 셀프호스팅 중에서 고른다. git 저장소와 연동하면 커밋 메시지 생성과 선택적 자동 커밋을 쓴다.
전제와 한계
Windows는 WSL 셸에서만 정상 동작하며 CMD 프롬프트와 PowerShell에서는 동작하지 않는다. 모델 호출에는 제공자 API 키나 Claude Pro/Max 구독이 필요하다. 브라우저 애플리케이션 자동 디버깅은 Chrome이 설치된 경우에만 쓸 수 있다. 자동 디버깅 대상은 빌드·린터·테스트·배포·스크립트 같은 터미널 명령이다. 프로젝트가 git 저장소일 필요는 없다.
유사 도구
- opencode터미널에서 동작하는 오픈소스 AI 코딩 에이전트다. build와 plan 두 에이전트를 Tab 키로 전환하며 코드 편집과 탐색을 나눠 수행한다.
- qwen-code터미널에서 동작하는 오픈소스 AI 코딩 에이전트다. OpenAI·Anthropic·Gemini·Qwen API와 로컬 모델을 런타임에 전환하며 MCP와 서브에이전트를 쓴다.
- Fuxi터미널에서 코드를 읽고 고치고 명령을 실행하는 AI 코딩 에이전트다. 단일 정적 바이너리로 배포되고 LLM 제공자를 가리지 않는다.
- Codewhale터미널에서 프로젝트를 읽고 파일을 고치고 명령을 실행하는 Rust 기반 코딩 에이전트다. 호스티드·로컬 모델을 골라 붙인다.
- gemini-cliGemini 모델을 터미널에서 직접 쓰는 TypeScript 기반 오픈소스 AI 에이전트다. 파일·셸·검색 도구와 MCP 서버를 붙여 코드 작업을 실행한다.
- hermes-agent세션을 넘어 기억과 스킬을 축적하는 자기 개선형 AI 에이전트다. 터미널 TUI와 메시징 게이트웨이로 어느 모델, 어느 인프라에서든 상주 실행한다.