Zerostack – 순수 Rust로 쓴 Unix 철학 코딩 에이전트

Zerostack – 순수 Rust로 쓴 Unix 철학 코딩 에이전트

Claude Code가 메모리를 수 GB씩 잡아먹는 시대에, 8MB면 충분한 코딩 에이전트가 등장했다. Zerostack은 순수 Rust로 작성된 초경량 코딩 에이전트로, Unix의 '작은 도구, 큰 협력' 철학을 AI 개발영역에 그대로 가져왔다.

왜 Zerostack인가

현재 대표적인 코딩 에이전트인 Claude Code는 메모리를 수 GB씩 사용한다. RAM 8GB짜리 노트북에서는 여러 도구를 동시에 돌리기만 해도 느려진다. Zerostack은 이 문제를 근본적으로 해결한다.

구분	Zerostack	일반 JS 기반 에이전트
RAM (빈 세션)	8MB	~300MB
RAM (작업 중)	12MB	~300MB+
CPU (유휴)	0.0%	~2%
바이너리 크기	8.9MB	수백 MB
코드 규모	~7,000 LoC	수십만 줄

Intel i5 7세대 기준, Zerostack은 유휴 상태에서 CPU 0.0%, 작업 중에도 약 1.5%에 불과하다. 같은 환경에서 opencode는 유휴 약 2%, 작업 중 약 20%를 사용한다.

핵심 기능

다중 제공자 지원

Zerostack은 기본 제공자로 OpenRouter를 사용한다. 동시에 다음 제공자도 지원한다:

• OpenAI (GPT 계열)

• Anthropic (Claude 계열)

• Gemini

• Ollama (로컬 모델)

• 사용자 정의 (임의 base URL + API 키)

환경 변수만 설정하면 된다:

export OPENROUTER_API_KEY="[api_key]"# 또는 커스텀 제공자zerostack --provider openai --model gpt-4o

내장 도구 세트

Zerostack이 제공하는 내장 도구:

• 파일 읽기·쓰기·편집 — 프로젝트 파일 직접 조작

• grep / 파일 찾기 — 코드베이스 탐색

• 디렉터리 목록 — 파일 구조 파악

• Bash 실행 — 권한 게이트가 적용된 터미널 명령

• MCP 서버 연결 — Model Context Protocol 확장

• Exa 웹 도구 — WebFetch / WebSearch

권한 시스템은 4단계로 나뉜다:

모드	동작
restrictive (-R)	모든 도구 동작에 명시적 승인 필요
standard (기본값)	ls, cd, git log 등은 자동 승인, 쓰기·파괴적 작업은 확인
accept-all	작업 디렉터리 내 모든 작업을 자동 승인
yolo	프롬프트 없이 모든 작업을 자동 승인

glob 패턴으로 도구별 권한을 세밀하게 조정할 수 있다:

# .rs 파일 쓰기는 자동 승인, 나머지는 확인write .rs  → 자동 허용write .*   → 항상 확인

프롬프트 시스템

Zerostack은 에이전트의 동작을 바꾸는 9가지 내장 프롬프트를 제공한다:

프롬프트	용도
code	기본 코딩 모드 (TDD 워크플로 포함)
plan	코드 작성 없이 탐색 후 계획만 수립
review	정확성, 설계, 테스트, 영향 검토
debug	근본 원인을 찾은 후 수정안 제시
ask	읽기 전용 모드 (read·grep·glob만 허용)
brainstorm	아이디어 탐색 및 설계 제안
frontend-design	프로덕션 수준 UI 디자인 모드
review-security	악용 가능한 취약점 탐지
simplify	동작 변경 없이 코드 명확성 향상

사용자 지정 프롬프트도 지원한다. $XDG_CONFIG_HOME/zerostack/prompts/에 Markdown 파일을 두면 이름으로 참조할 수 있다.

반복 루프 (Loop Mode)

장기 작업용 반복 코딩 루프가 내장되어 있다:

zerostack --loop --loop-prompt "Implement the user authentication system" --loop-max 10 --loop-run "cargo test"

에이전트는 각 반복마다 작업을 읽고, 계획에서 항목을 고르고, 작업을 수행하고, 테스트를 실행하고, 계획을 갱신한다. 반복 제한에 도달하면 자동으로 중지한다.

Git Worktrees 통합

채팅 UI 안에서 직접 Git worktree를 만들고, 그 안에서 작업하고, 병합할 수 있다:

/worktree feature-x    # 새 브랜치 + worktree 생성 후 이동# ... 작업 수행 .../wt-merge              # 병합 + push + 정리 후 메인 저장소로 복귀/wt-exit               # 병합 없이 즉시 복귀

설치 방법

Cargo와 git이 필요하다:

cargo install zerostack

sandbox 격리 (Bash 명령 분리 환경)가 필요하면 bubblewrap도 설치한다:

# Debian/Ubuntuapt install bubblewrap# Fedoradnf install bubblewrap# Archpacman -S bubblewrap

세션 관리

세션은 $XDG_DATA_HOME/zerostack/sessions/에 저장된다:

zerostack -c          # 가장 최근 세션 재개zerostack -r          # 세션 목록에서 선택zerostack --session   # 특정 세션 로드

slash 명령으로 모델 전환, 사고 수준 설정, 대화 초기화, 권한 모드 변경 등을 그때그때 할 수 있다.

확장 포인트

Zerostack은 컴파일 시 기능 플래그로 에이전트를 무겁게 만들 수 있는 기능을 끌 수 있다. 코드 규모가 약 7,000줄에 불과해서, 필요하면 zerostack 소스 자체를 수정해 커스텀 포크를 만드는 것도 가능하다.

프로젝트 루트 또는 상위 디렉터리의 AGENTS.md, CLAUDE.md 파일을 자동으로 읽어 시스템 프롬프트에 삽입한다. 팀 공통 프롬프트를 저장소에 두면 에이전트가 항상 일관된 방식으로 동작한다.

마치며

Zerostack은 "작은 것이 아름답다"는 Unix 철학을 코딩 에이전트에 적용한 도구다. 8MB RAM으로 동작하고, 7,000줄 코드 규모라는 심플함 속에서 다중 제공자, 세분화된 권한 시스템, 반복 루프, Git worktree 통합이라는 실용적인 기능들을 담았다.

클라우드의 작은 인스턴스에서 돌리든, 오래된 노트북에서 돌리든, Zerostack은 개발 환경에 부담을 주지 않는 코딩 파트너가 되어준다.

---

📚 출처

• Zerostack - GeekNews

• Zerostack crates.io

---

📚 출처

• https://news.hada.io/topic?id=29584