FleetCode 소개
FleetCode는 여러 개의 CLI(명령줄 인터페이스) 기반 AI 코딩 에이전트를 동시에 실행할 수 있도록 설계된 데스크탑 터미널 애플리케이션입니다. 각 세션은 독립적인 Git 워크트리(git worktree) 안에서 실행되어 서로의 코드 변경이 겹치지 않도록 격리된 환경을 제공합니다. 이 앱은 Anthropic의 Claude나 OpenAI의 Codex 같은 AI 코딩 모델과 함께 사용할 수 있으며, 프로젝트 단위로 분리된 환경에서 여러 작업을 병렬로 수행할 수 있도록 지원합니다.
FleetCode의 가장 큰 특징은 세션의 지속성(persistence) 과 워크트리 기반 격리 환경입니다. 사용자는 프로젝트별로 독립적인 세션을 생성할 수 있으며, 애플리케이션을 종료해도 세션 정보가 유지되어 다시 실행 시 자동으로 이어집니다. 이를 통해 복잡한 멀티 프로젝트 개발 환경에서도 일관된 작업 흐름을 유지할 수 있습니다.
또한, Model Context Protocol (MCP) 서버 관리 기능을 제공하여, AI 모델이 더 풍부한 컨텍스트 정보를 활용할 수 있도록 설정할 수 있습니다. 예를 들어 stdio나 SSE 방식으로 서버와의 직접 통신을 설정할 수 있어, AI의 개발 보조 능력을 한층 확장할 수 있습니다.
FleetCode는 Node.js 환경에서 실행되며, 기본적으로 Git 기반 프로젝트를 대상으로 작동합니다. 따라서 기존 개발 환경에 손쉽게 통합할 수 있으며, 명령줄 기반의 AI 코딩 도구를 효율적으로 활용하고자 하는 개발자들에게 특히 유용합니다.
Codex 및 Claude CLI와의 비교
FleetCode는 단일 CLI 기반 에이전트보다 더 진보된 멀티 세션 운영 체계를 제공합니다. 예를 들어, Claude CLI 또는 Codex CLI는 각각 독립적으로 실행되어 특정 프로젝트 내에서만 동작하지만, FleetCode는 이들을 하나의 통합 UI에서 동시에 실행할 수 있도록 설계되었습니다.
즉, 여러 개의 AI 코딩 에이전트를 서로 다른 Git 워크트리에서 구동하며, 각 세션 간의 코드 변경이나 파일 충돌을 방지할 수 있습니다. 이러한 구조는 대규모 코드베이스를 다루는 팀 개발 환경이나 여러 실험적 기능을 동시에 테스트해야 하는 개인 개발자에게 적합합니다.
또한, FleetCode는 단순히 명령줄 인터페이스를 제공하는 것이 아니라 테마, 폰트, 세션 관리 UI 등을 지원하여 시각적으로 직관적인 환경에서 작업할 수 있도록 합니다.
FleetCode의 주요 기능
-
다중 세션 관리: FleetCode의 핵심은 여러 개의 코딩 에이전트 세션을 병렬로 실행할 수 있다는 점입니다. 각 세션은 고유한 Git 워크트리를 생성하며, 서로 다른 브랜치에서 독립적으로 코드를 수정하고 테스트할 수 있습니다. 사용자는 Claude, Codex 중 하나를 선택하여 세션을 시작할 수 있으며, 이후 앱을 재시작해도 세션은 자동으로 복원됩니다.
이러한 구조는 “작업 공간 격리” 개념을 실현하여, 하나의 코드 실험이 다른 프로젝트에 영향을 주지 않도록 보장합니다. -
Git Worktree 기반 격리 환경: FleetCode는 세션을 생성할 때 자동으로 새로운 Git 워크트리를 만듭니다. 이를 통해 각 AI 세션은 동일한 리포지토리 기반이지만 완전히 분리된 디렉터리 내에서 실행됩니다. 즉, 한 세션이 다른 세션의 코드나 설정을 건드리지 않으므로, 안전하고 독립적인 실험 환경을 제공합니다.
-
MCP 서버 관리: FleetCode는 Model Context Protocol (MCP) 서버 구성을 지원합니다. MCP 서버는 AI 모델이 외부 데이터나 도구에 접근하도록 하는 인터페이스로, FleetCode 내에서 다음 두 가지 방식을 설정할 수 있습니다.
- stdio: 표준 입출력을 통한 직접 통신 방식
- SSE: HTTP 기반의 서버-전송 이벤트(Server-Sent Events)
이 기능을 통해 AI가 보다 풍부한 맥락 정보를 활용하거나, 외부 툴과 연동하여 더 복잡한 작업을 수행할 수 있습니다.
-
터미널 설정 및 테마: FleetCode는 개발자의 취향에 맞춰 터미널 인터페이스를 세밀하게 커스터마이징할 수 있습니다. 기어 아이콘(
)을 통해 접근 가능한 설정 패널에서 다음 항목을 조정할 수 있습니다.- 폰트 패밀리 및 크기
- 커서 블링크 여부
- 색상 테마 (macOS Light/Dark, Solarized Dark, Dracula, One Dark, GitHub Dark 등)
-
세션 관리 및 자동 복원: FleetCode는 사용자가 실행한 모든 세션을 지속적으로 저장하고, 앱 재실행 시 자동으로 복원합니다. 새로운 세션을 생성할 때는
--session-id <uuid>옵션을, 기존 세션을 재개할 때는--resume <uuid>옵션을 사용할 수 있습니다. -
macOS 사용자 이슈 해결: macOS에서 FleetCode 앱 실행 시 “인증되지 않은 개발자” 경고가 발생할 경우, 다음 명령어를 통해 해결할 수 있습니다.
xattr -cr /path/to/FleetCode.app위 명령은 macOS의 보안 속성(Quarantine)을 해제하여 앱이 정상적으로 실행되도록 합니다.
FleetCode 설치 및 실행
FleetCode를 설치 및 실행하기 위해서는 Node.js 16 이상과 Git이 설치된 환경이 필요합니다. 또한, Caude Code 또는 Codex가 필요합니다.
FleetCode를 설치하고 실행하는 과정은 간단합니다. GitHub에서 저장소를 복제(clone)한 뒤, 프로젝트 디렉토리로 이동하여 설치 및 실행하면 됩니다:
# 저장소 복제
git clone https://github.com/built-by-as/FleetCode
cd FleetCode
# 설치
npm install
# 개발 모드 실행
npm run dev
# 상용 모드를 위한 빌드 및 실행
npm run build
npm start
FleetCode 프로젝트 GitHub 저장소
이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다. 
파이토치 한국 사용자 모임
이 정리한 이 글이 유용하셨나요? 회원으로 가입하시면 주요 글들을 이메일
로 보내드립니다! (기본은 Weekly지만 Daily로 변경도 가능합니다.)
아래
쪽에 좋아요
를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 