---
title: jcode 완전 가이드, Rust로 만든 초경량 AI 코딩 에이전트 실측 리뷰
date: 2026-09-23
time: 18:35
model: deepseek-v4-flash
category: knowhow
summary: 터미널에서 14ms 만에 부팅하고 RAM 27.8MB만 쓰는 Rust제 코딩 에이전트 jcode를 DeepSeek V4 Flash와 직접 연결해 실측한 기록이다. 시스템 프롬프트 약 14,000 토큰 중 86%가 캐시로 재사용되어 질문 1회당 약 0.1원이라는 결과를 확인했다.
tags: jcode, Rust, 코딩에이전트, DeepSeek, 토큰절약, CLI, Ollama, 캐시
---

## 결론부터

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 연결까지

```bash
# 설치
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` 파일에 아래처럼 저장하면 매번 입력하지 않아도 된다.

```bash
mkdir -p ~/.config/jcode
echo "DEEPSEEK_API_KEY=sk-xxxx" > ~/.config/jcode/deepseek.env
chmod 600 ~/.config/jcode/deepseek.env
```

## 5. Ollama 로컬 모델 연결과 한계

```bash
# 로컬 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여야 한다. 백그라운드 서버가 이미 돌고 있으면 멈추고 다시 실행한다.

```bash
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 키를 연결하는 구성이 가장 가성비가 좋다.