# FleetCode: 여러 AI 코딩 에이전트를 동시에 실행할 수 있는 환경을 제공하는 CLI 도구 **URL:** \ **Category:** 읽을거리&정보공유\ **Tags:** code-agent, fleetcode\ **Created:** [10월 16, 2025, 3:30오전 UTC](https://discuss.pytorch.kr/t/fleetcode-ai-cli/7965 "2025-10-16T03:30:57Z")\ **Posts on this page:** 1\ **Page:** 1
**Author:** ![9bow](https://discuss.pytorch.kr/user_avatar/discuss.pytorch.kr/9bow/32/16301_2.png) [@9bow](https://discuss.pytorch.kr/u/9bow)\ **Post date:** [10월 16, 2025, 3:30오전 UTC](https://discuss.pytorch.kr/t/fleetcode-ai-cli/7965/1 "2025-10-16T03:30:57Z")
![FleetCode: 여러 AI 코딩 에이전트를 동시에 실행할 수 있는 환경을 제공하는 CLI 도구](https://discuss.pytorch.kr/uploads/default/original/2X/4/47fed33fc40b2b70129faded04763b20f4421e20.jpeg) ## 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 내에서 다음 두 가지 방식을 설정할 수 있습니다. - **터미널 설정 및 테마** : FleetCode는 개발자의 취향에 맞춰 터미널 인터페이스를 세밀하게 커스터마이징할 수 있습니다. 기어 아이콘(⚙)을 통해 접근 가능한 설정 패널에서 다음 항목을 조정할 수 있습니다. - **세션 관리 및 자동 복원** : FleetCode는 사용자가 실행한 모든 세션을 지속적으로 저장하고, 앱 재실행 시 자동으로 복원합니다. 새로운 세션을 생성할 때는 `--session-id ` 옵션을, 기존 세션을 재개할 때는 `--resume ` 옵션을 사용할 수 있습니다. - **macOS 사용자 이슈 해결** : macOS에서 FleetCode 앱 실행 시 “인증되지 않은 개발자” 경고가 발생할 경우, 다음 명령어를 통해 해결할 수 있습니다. ## FleetCode 설치 및 실행 FleetCode를 설치 및 실행하기 위해서는 Node.js 16 이상과 Git이 설치된 환경이 필요합니다. 또한, Caude Code 또는 Codex가 필요합니다. FleetCode를 설치하고 실행하는 과정은 간단합니다. GitHub에서 저장소를 복제(clone)한 뒤, 프로젝트 디렉토리로 이동하여 설치 및 실행하면 됩니다: ```auto # 저장소 복제 git clone https://github.com/built-by-as/FleetCode cd FleetCode # 설치 npm install # 개발 모드 실행 npm run dev # 상용 모드를 위한 빌드 및 실행 npm run build npm start ``` ## :github: FleetCode 프로젝트 GitHub 저장소 [https://github.com/built-by-as/FleetCode](https://github.com/built-by-as/FleetCode) * * * _이 글은 GPT 모델로 정리한 글을 바탕으로 한 것으로, 원문의 내용 또는 의도와 다르게 정리된 내용이 있을 수 있습니다. 관심있는 내용이시라면 원문도 함께 참고해주세요! 읽으시면서 어색하거나 잘못된 내용을 발견하시면 덧글로 알려주시기를 부탁드립니다._ 🤗 [:pytorch:파이토치 한국 사용자 모임🇰🇷](https://pytorch.kr/)이 정리한 이 글이 유용하셨나요? [회원으로 가입](https://discuss.pytorch.kr/signup)하시면 주요 글들을 이메일💌로 보내드립니다! (기본은 Weekly지만 [Daily로 변경도 가능](https://discuss.pytorch.kr/my/preferences/emails)합니다.) 🎁 아래↘쪽에 좋아요👍를 눌러주시면 새로운 소식들을 정리하고 공유하는데 힘이 됩니다~ 🤩