jcode 완전 가이드, Rust로 만든 초경량 AI 코딩 에이전트 실측 리뷰
결론부터
jcode는 잘만 쓰면 해자다. 터미널에서 14ms 만에 켜지고, RAM은 27.8MB만 먹는다. DeepSeek V4 Flash와 연결해 실제로 측정해 보니 시스템 프롬프트 약 14,000 토큰 중 86%가 캐시로 재사용되어 질문 1회당 비용이 약 0.1원에 불과했다. 운영자 환경 측정 기준이다.
1. jcode란 무엇인가
jcode는 미국 개발자 Jeremy Huang이 2026년 2월에 처음 공개한 오픈소스 AI 코딩 에이전트 하니스다. MIT 라이선스로 완전 무료다.
| 항목 | 내용 | |
|---|---|---|
| 공식 사이트 | jcode.sh | |
| GitHub | 1jehuang/jcode | |
| 언어 | Rust | |
| 라이선스 | MIT | |
| 최신 버전 | v0.87.1 (운영자 환경 측정 기준) | |
| GitHub 스타 | 약 17,000개 (2026년 8월 기준) | |
| 설치 | curl -fsSL https://jcode.sh/install \ | bash |
하니스란 AI 모델(Claude, GPT, Gemini, DeepSeek 등)을 터미널 안에 불러들여 코드 읽기, 편집, 명령어 실행을 시키는 조종석이다. jcode 자체가 모델이 아니라 모델을 연결하는 껍데기라는 뜻이다.
2. 왜 가벼운가, 수치로 비교
RAM 사용량
| 항목 | jcode | Claude Code |
|---|---|---|
| 세션 1개 | 27.8MB | 386.6MB |
| 세션 10개 | 117MB | 2,300MB |
| 비율 | 1배 | 약 14~20배 |
Claude Code나 Copilot CLI가 Electron과 Node.js 런타임을 통째로 올리는 데 비해, jcode는 Rust 네이티브 바이너리라 오버헤드가 거의 없다. 8GB 노트북에서도 에이전트 10~20개를 동시에 띄울 수 있다는 게 공식 설명이다.
부팅 속도
| 항목 | jcode | Claude Code | Codex |
|---|---|---|---|
| 부팅 시간 | 14ms | 약 3.4초 | 약 14초 |
| 배율 | 1배 | 약 245배 느림 | 약 63배 느림 |
운영자 환경 측정 기준, 설치 후 jcode --version은 즉시 응답한다.
3. 핵심 기능 4가지
시맨틱 메모리 그래프
벡터 기반 메모리가 관련 컨텍스트를 자동으로 떠올린다. 같은 프로젝트에서 반복 작업할 때 이전 대화와 파일 구조를 기억해 다시 설명할 필요가 없다.
에이전트 스웜
여러 AI 에이전트를 병렬로 실행한다. 기획자, 코더, 리뷰어를 동시에 돌리는 CrewAI식 협업을 터미널 안에서 처리한다.
30개 이상 프로바이더 지원
Claude, OpenAI, Gemini, DeepSeek, OpenRouter, Ollama, LM Studio, Copilot, xiaomi-mimo 등을 --provider 옵션 하나로 갈아낄 수 있다. 대화 중에도 /model 명령으로 전환된다.
MCP와 브라우저 자동화
MCP 서버 연결, 브라우저 자동화, Mermaid 다이어그램 렌더링, 사이드 패널 UI를 기본 제공한다.
4. 설치부터 DeepSeek 연결까지
# 설치
curl -fsSL https://jcode.sh/install | bash
# 버전 확인
jcode --version
# jcode v0.87.1 (운영자 환경 측정 기준)
# DeepSeek 연결 (API 키 필요)
jcode --provider deepseek
# 특정 모델 지정
jcode --provider deepseek --model deepseek-v4-flash
# 질문 1회만 하고 종료
jcode --provider deepseek run "1+1은? 한줄로"
# REPL 모드 (TUI 없이 대화)
jcode --provider deepseek repl
API 키는 ~/.config/jcode/deepseek.env 파일에 아래처럼 저장하면 매번 입력하지 않아도 된다.
mkdir -p ~/.config/jcode
echo "DEEPSEEK_API_KEY=sk-xxxx" > ~/.config/jcode/deepseek.env
chmod 600 ~/.config/jcode/deepseek.env
5. Ollama 로컬 모델 연결과 한계
# 로컬 Ollama 연결 (도구 호출 없이)
jcode --provider ollama --model qwen3.8-9b-distill:latest --tool-profile none
주의할 점이 있다. Ollama 로컬 모델은 jcode의 도구 호출용 문법(grammar)을 파싱하지 못해 에러가 난다.
Failed to initialize samplers: failed to parse grammar
그래서 --tool-profile none을 붙여야 동작한다. 이 모드에서는 파일 읽기, 쓰기, 명령어 실행 같은 에이전트 기능이 꺼지고 단순 대화만 된다. 본격적인 코딩 에이전트로 쓰려면 DeepSeek, Claude, GPT 같은 API 모델을 연결해야 한다.
| 모델 유형 | 연결 | 도구 호출 | 비고 |
|---|---|---|---|
| DeepSeek API | 가능 | 가능 | 실측 완료 |
| Claude API | 가능 | 가능 | 공식 지원 |
| OpenAI API | 가능 | 가능 | 공식 지원 |
| Gemini API | 가능 | 가능 | 공식 지원 |
| Ollama 로컬 | 가능 | 불가 | tool-profile none 필수 |
6. 답변 나오기 전 주입 토큰 실측
--trace 옵션으로 실제 토큰 사용량을 측정했다. 운영자 환경 측정 기준이다.
프로파일별 입력 토큰
| 프로파일 | 입력 토큰 | 시스템 프롬프트 추정 | 설명 |
|---|---|---|---|
| none | 약 800 | 약 750 | 도구 없음, 단순 채팅 |
| minimal | 약 3,000 | 약 2,900 | 기본 도구 10개와 규칙 |
| full (DeepSeek) | 약 14,000 | 약 13,500 | 전체 도구와 상세 규칙 |
minimal에 들어가는 도구 목록 (실측)
read, write, edit, multiedit, apply_patch, patch, bash, ls, agentgrep에 스킬 도구(/ollama, /tavily-search 등)가 추가되어 총 15개가 주입된다.
날씨 질문 1회 실측 로그
"오늘 날씨는?"이라고 물었을 때의 실제 흐름이다.
| 단계 | 입력 토큰 | 출력 토큰 | 캐시 히트 | 동작 |
|---|---|---|---|---|
| 1차 요청 | 14,281 | 267 | 13,824 | 질문 접수, bash 도구 호출 |
| 2차 요청 | 14,608 | 91 | 14,464 | 날씨 검색 후 재요청 |
| 3차 요청 | 15,401 | 265 | 14,592 | 웹페이지 읽기 후 답변 생성 |
| 최종 답변 | 18,091 | 151 | 15,616 | 최종 답변 출력 |
총 입력 약 18,000 토큰, 총 출력 약 774 토큰, 캐시 재사용 약 15,600 토큰(86%)이다.
7. 캐시 적중률이 해자인 이유
DeepSeek API는 컨텍스트 캐싱 할인이 업계 표준(10배 할인)보다 큰 약 50배 수준으로 알려져 있다. 시스템 프롬프트처럼 매번 반복되는 부분은 캐시 히트로 처리되어 비용이 급감한다.
위 실측을 DeepSeek V4 Flash 요금(입력 약 $0.14/1M, 캐시 히트 약 $0.014/1M, 출력 약 $0.28/1M 기준)으로 환산하면 다음과 같다.
| 항목 | 토큰 | 단가 | 비용 |
|---|---|---|---|
| 입력 (캐시 미스) | 약 2,400 | $0.14/1M | 약 $0.0003 |
| 입력 (캐시 히트) | 약 15,600 | $0.014/1M | 약 $0.0002 |
| 출력 | 774 | $0.28/1M | 약 $0.0002 |
| 합계 | 약 $0.0007 (약 0.1원) |
질문 1회에 약 0.1원이다. 잔액 $11.59 기준으로 약 16,500회 질문이 가능하다는 계산이 나온다. 운영자 환경 측정 기준이며 요금은 변동될 수 있다.
8. 누구에게 맞는가
| 유형 | 적합도 | 이유 |
|---|---|---|
| 터미널 파워 유저 | 높음 | GUI 없이 키보드로 전부 처리 |
| 저사양 환경 (8GB RAM) | 높음 | 27.8MB라 여러 세션 가능 |
| API 비용 민감 사용자 | 높음 | DeepSeek 캐시와 궁합이 좋음 |
| GUI 에디터 선호 | 낮음 | TUI와 CLI 위주라 Cursor가 나음 |
| 베타 불안감 민감 | 보통 | 일부 기능이 아직 베타 단계 |
9. 자주 막히는 지점 3가지
TUI가 안 뜬다
jcode는 대화형 화면(TUI)이라 stdin과 stdout이 TTY여야 한다. 백그라운드 서버가 이미 돌고 있으면 멈추고 다시 실행한다.
jcode server stop
jcode --provider deepseek
DEEPSEEK_API_KEY not found
~/.config/jcode/deepseek.env 파일을 만들고 권한을 600으로 설정한다. 터미널을 재시작하거나 source ~/.zshenv로 환경변수를 다시 읽는다.
Ollama에서 grammar 에러
도구 호출 스키마를 로컬 모델이 파싱하지 못하는 문제다. --tool-profile none을 붙여 단순 대화용으로 쓰거나 API 모델로 전환한다.
10. 한 줄 결론
무겁고 비싼 에이전트 하니스에 지쳤다면 jcode와 DeepSeek 조합이 현실적인 대안이다. 가볍고, 빠르고, 질문당 약 0.1원이라 부담 없이 돌릴 수 있다. 로컬 Ollama로는 대화용으로만 쓰고, 진짜 코딩 에이전트가 필요하면 DeepSeek API 키를 연결하는 구성이 가장 가성비가 좋다.