jcode로 다중 코딩 에이전트 다루기

개요

여러 코딩 에이전트를 같은 저장소에 동시에 띄우면, 세션 관리와 컨텍스트 공유가 복잡해집니다. jcode는 여기를 겨냥한 터미널용 Coding Agent Harness입니다. 공식 GitHub 저장소와 v0.52.0 릴리스 노트를 읽고 묶었습니다. 직접 오래 운영해보지는 않았습니다.

Claude Code나 Codex CLI가 한 에이전트를 바로 실행하는 도구라면, jcode는 여러 세션과 에이전트 협업을 묶어 다루는 쪽입니다. 모델은 Claude, OpenAI, Gemini, Copilot OAuth와 OpenRouter, Ollama, vLLM 같은 OpenAI 호환 서버를 고를 수 있습니다. 관련 Docker 기본 작업은 https://windowshyun.tistory.com/48 글 흐름과 같이 보시면 됩니다.

시스템 아키텍처

• 클라이언트: TUI, 단발 run, 백그라운드 serve와 connect.
• Provider: 구독 OAuth 또는 OpenAI 호환 API endpoint.
• Memory: 대화 턴을 임베딩으로 보관하고 관련 기록을 조회.
• Swarm: 같은 저장소의 여러 에이전트에 파일 변경과 메시지를 전달.

저라면 Codex CLI나 Claude Code를 한 개만 띄우는 작업보다, 저장소를 나눠 병렬 조사·수정·검증을 해야 할 때 먼저 봅니다. README의 메모리 수치는 제작자가 Linux 환경에서 측정한 값입니다. 내 환경의 값으로 보면 안 됩니다.

1. 쓸 만한 이유

공식 README는 로컬 임베딩을 끈 활성 세션 하나의 PSS를 27.8MB, 세션 추가분을 약 9.9MB로 적고 있습니다. 이 수치는 jcode가 실행한 벤치마크일 뿐이고, Claude Code나 Codex CLI와 같은 조건의 독립 비교는 아닙니다.

그래도 다중 세션 작업에서는 비교 기준이 또렷합니다. 메모리 자동 조회가 필요한지, 에이전트끼리 변경 사실을 공유해야 하는지, OAuth 구독과 자체 API 서버를 한 도구에서 바꿔야 하는지 보시면 됩니다.

사전 준비 사항

• Linux 또는 macOS에서는 curl과 bash를 준비합니다.
• Windows는 PowerShell 5.1 이상을 준비합니다.
• 사용할 provider 계정 또는 OpenAI 호환 endpoint를 정합니다.

설치 절차

macOS와 Linux 설치 명령은 아래와 같습니다.

curl -fsSL https://jcode.sh/install | bash

Windows PowerShell에서는 아래 명령을 쓰면 됩니다.

irm https://jcode.sh/install.ps1 | iex

설치 뒤에는 provider를 연결해주시면 됩니다. Claude 구독은 jcode login --provider claude, 로컬 Ollama는 jcode login --provider ollama로 시작합니다. 자체 호환 서버는 jcode provider add <프로필명> --base-url https://llm.example.com/v1 --model <MODEL_ID> --api-key-stdin --set-default 형식으로 등록합니다.

1. 실행 방식

• 인터랙티브 TUI: jcode
• 단발 호출: jcode run "say hello"
• 기존 세션 재개: jcode --resume <세션이름>
• 서버와 추가 클라이언트: jcode serve 다음 jcode connect

README에는 Codex, Claude Code, OpenCode, pi 세션 재개도 적혀 있습니다. 현재 지원 범위와 인증 흐름은 공식 문서를 확인하시는 편이 안전합니다.

적용 대상

여러 에이전트가 같은 코드베이스를 나눠 볼 때, 구독 모델과 로컬 모델을 함께 쓸 때, 터미널 세션을 길게 유지할 때 맞습니다. 반대로 단일 파일 수정이나 짧은 질문만 처리한다면 기존 Codex CLI 또는 Claude Code가 더 짧습니다. 자동 메모리와 스웜이 필요 없는 작업에 복잡한 실행 계층을 더하지 않는 편이 낫습니다.

확인

설치 뒤 jcode --version을 실행합니다.

jcode --version

jcode v0.52.0처럼 버전이 출력되면 PATH 등록까지 끝난 상태입니다.