쓸모 쓸모연구소 · 실전 노트
제 825 호이번 주 새 글 49 편2026 · 11 · 14
클로드 코드
Claude · GitHub · Agency Agents

클로드 코드 추천 도구 4가지, 코드 지도⁠·전문 에이전트⁠·영상 제작 설치 전 확인

클로드 코드를 기본 상태 그대로 쓰지 않고 도구를 붙여 쓰는 사람들이 자주 고르는 깃허브 오픈소스 네 가지를 정리했습니다. 코드 찾는 토큰을 줄이는 도구 둘, 분야별 전문 에이전트 모음, 영상 제작 도구입니다. 각각의 역할과 설치 명령, 설치 전에 알아 둘 주의점을 2026년 11월 저장소 안내 기준으로 적었습니다.

클로드 코드 추천 도구 4가지, 코드 지도·전문 에이전트·영상 제작 설치 전 확인 삽화
삽화 · 쓸모연구소

네 가지 도구가 하는 일

  • Trail-code(예전 이름 Graft): 내 컴퓨터에서 코드의 함수 호출 관계를 미리 분석해 두고, 질문마다 관련 파일 위치를 붙여 줍니다. 코드를 고치면 영향받는 곳도 알려 줍니다.
  • Agency Agents: 개발, 디자인, 마케팅 같은 분야별 전문 에이전트 모음입니다. 저장소 README에 230개 이상으로 적혀 있고, 에이전트마다 일하는 순서와 결과물 기준이 정해져 있습니다.
  • Codebase Memory MCP: 코드 전체를 누가 누구를 부르는지 그래프로 저장해 두고 필요한 부분만 꺼내 찾습니다.
  • OpenMontage: 클로드 코드가 조사, 대본, 나레이션, 자막, 편집까지 영상 제작을 맡는 도구입니다.

Trail-code와 Codebase Memory MCP는 역할이 비슷합니다. 하나를 먼저 써 보고 부족할 때 다른 것을 고르는 편이 좋습니다. 둘을 동시에 붙이면 프로젝트 지도를 두 벌 관리하게 됩니다.

1. Trail-code: 코드 지도와 영향 범위

예전 이름은 Graft이고 지금은 Trail-code로 바뀌었습니다. 코드 지도는 여전히 "graft map"이라 부르고, 기존 graft 명령도 계속 동작합니다. Graft로 설정해 둔 저장소는 클로드 코드를 처음 열 때 자동으로 옮겨집니다. 라이선스는 MIT입니다.

  1. Node.js 22.3 이상(20.16도 가능)이 있는지 확인합니다. 확인: 터미널에서 node --version을 실행하면 버전이 나옵니다.
  2. 아래 두 줄을 실행합니다. 두 번째 줄은 클로드 코드를 쓰는 프로젝트 폴더 안에서 실행합니다. 확인: trail init이 어떤 에이전트에 연결할지 묻고, 코드 지도를 만든 뒤 .trail/ 폴더를 만듭니다.
명령어
npm install -g @trailhq/trail-code
trail init
  1. 바뀌는 내용을 먼저 보고 싶다면 trail init --dry-run을 쓰고, 클로드 코드만 연결하려면 trail init --agents claude를 씁니다.
  2. 클로드 코드를 열고 질문합니다. 확인: 상태 줄에 코드 지도 크기가 보이고, 질문마다 관련 코드 위치가 따라붙습니다. 파일을 고친 뒤에는 그 파일에 기대는 다른 파일이 표시됩니다.

주의할 점이 두 가지 있습니다. trail init은 이 저장소의 지난 클로드 코드 대화에서 내가 쓴 메시지를 읽어 반복된 지침을 모으는데, 이 읽기에 약 1분이 걸리고 내 클로드 사용량이 차감됩니다. 또 제작사가 밝힌 효과(SWE-bench 50개 문제에서 지도가 있을 때 33개, 없을 때 27개 해결, 토큰 23% 감소)는 제작사 자체 측정이고 표본이 작아 내 프로젝트에서도 그렇다는 보장은 없습니다.

지우기: trail uninstall은 지울 목록만 보여 주고, trail uninstall -y는 만든 파일과 설정을 모두 지웁니다.

2. Agency Agents: 분야별 전문 에이전트

저장소 README 기준 18개 분야에 230개 이상의 전문 에이전트가 있고 라이선스는 MIT입니다. 클로드 코드에서는 ~/.claude/agents/ 폴더에 에이전트 파일이 들어갑니다.

  1. 먼저 이미 쓰는 에이전트가 있다면 폴더를 백업합니다. 확인: ~/.claude/agents.backup 폴더가 생깁니다.
명령어
cp -r ~/.claude/agents ~/.claude/agents.backup
  1. 저장소를 받아 설치합니다. 확인: 설치가 오류 없이 끝납니다.
명령어
git clone https://github.com/msitarzewski/agency-agents.git
cd agency-agents
./scripts/install.sh --tool claude-code
  1. 전부 말고 한 분야만 넣고 싶다면 3번째 줄 대신 아래를 씁니다. 개발 분야 예시입니다.
명령어
cp engineering/*.md ~/.claude/agents/
  1. 클로드 코드를 다시 열고 /agents를 입력합니다. 확인: 새 에이전트 목록이 보입니다. 에이전트 이름을 불러 일을 맡기거나, 클로드가 알맞은 에이전트를 고르게 해도 됩니다.

명령으로 설치하면 같은 이름의 파일이 있을 때 경고 없이 덮어쓸 수 있습니다. README는 기존 파일을 어떻게 처리하는지 따로 안내하지 않으니 위의 백업을 먼저 해 두세요. 명령이 어렵다면 맥에서는 README에 안내된 데스크톱 앱(Homebrew 설치)을 쓰는 방법도 있습니다.

3. Codebase Memory MCP: 코드 전체를 그래프로 저장

코드, 문서, 설정 파일을 내 컴퓨터에서 분석해 호출 관계 그래프로 저장하는 MCP 서버(클로드가 외부 도구를 쓰게 해 주는 연결 규격)입니다. 라이선스는 MIT이고, 분석과 저장은 내 컴퓨터 안에서만 일어나 API 키가 필요 없습니다. 저장 위치는 ~/.cache/codebase-memory-mcp/입니다.

  1. 플러그인으로 설치합니다. 터미널에서 아래 두 줄을 실행합니다. 확인: 오류 없이 끝납니다.
명령어
claude plugin marketplace add DeusData/codebase-memory-mcp
claude plugin install codebase-memory@codebase-memory
  1. 클로드 코드를 다시 시작하고 /mcp를 입력합니다. 확인: 목록에 codebase-memory 서버가 보입니다.
  2. 프로젝트 폴더에서 클로드 코드에게 한마디 합니다. 확인: 클로드가 인덱싱을 실행하고 그래프를 만듭니다.
프롬프트
Index this project.
  1. 이후 질문에서 클로드가 그래프에서 바로 찾아 파일 전체를 읽는 양이 줄어듭니다. 함수를 고치면 어디까지 영향이 가는지, 안 쓰는 함수 후보도 물어볼 수 있습니다. 내부 도구 이름으로 search_graph, trace_path, detect_changes 등이 있습니다.

README는 설치 스크립트(install.sh)와 "이 MCP 서버를 설치해 줘"라고 클로드에게 맡기는 방법도 안내합니다. 어느 쪽이든 저장소 README를 읽어 보고 진행합니다. 플러그인은 서버만 등록하고 훅은 넣지 않습니다. 그래프는 코드를 정적으로 분석한 것이라 실제로 실행된 경로가 아니라 가능한 관계를 보여 준다는 점을 알아 둡니다. 윈도우도 지원하지만 PowerShell 설치에서 보안 경고가 뜰 수 있습니다.

지우기: claude plugin uninstall codebase-memory@codebase-memory. 인덱스 데이터까지 지우려면 저장 폴더를 삭제합니다.

4. OpenMontage: 영상 제작을 맡기는 도구

조사부터 대본, 나레이션, 자막, 편집, 최종 합성까지 클로드 코드가 단계별로 진행하는 영상 제작 시스템입니다. 라이선스는 AGPL-3.0이고 Python 3.10 이상, FFmpeg, Node.js 18 이상이 필요합니다.

  1. 저장소를 받아 설치합니다. 확인: 오류 없이 끝나고 폴더 안에 CLAUDE.md 같은 안내 파일이 있습니다.
명령어
git clone https://github.com/calesthio/OpenMontage.git
cd OpenMontage
make setup
  1. 그 폴더에서 클로드 코드를 열고, 마음에 드는 릴스나 쇼츠 주소를 주며 비슷한 영상을 만들고 싶다고 말합니다. 확인: 곧바로 제작하지 않고 레퍼런스의 구성을 분석한 뒤 새 기획안을 먼저 보여 줍니다.
  2. 제안, 대본, 장면 계획 같은 결정 지점마다 승인합니다. 확인: 내가 승인해야 다음 단계로 넘어갑니다.
  3. 돈이 드는 기능을 쓰기 전에 나오는 예상 비용을 확인합니다. README가 기본값으로 안내한 수치는 총예산 한도 10달러, 한 번에 0.5달러를 넘는 작업은 승인을 따로 받는 방식입니다. 처음에는 기본값 그대로 두고 쓰는 편이 안전합니다.

API 키가 없어도 오프라인 음성(Piper), 무료 영상 자료, 리모션(Remotion) 합성은 쓸 수 있습니다. 유료 이미지와 음성 서비스는 해당 키를 넣어야 열립니다.

설치 전에 확인할 것

  • 네 가지를 한꺼번에 깔지 않습니다. 코드를 찾는 데 시간이 드는 프로젝트라면 1번 또는 3번, 반복 업무에 역할 분담이 필요하면 2번, 영상 작업이 있다면 4번 순으로 필요한 것만 고릅니다.
  • 설치 스크립트와 플러그인은 내 컴퓨터에서 명령과 훅을 실행할 수 있습니다. 공식 저장소 주소인지 확인하고 README를 먼저 읽습니다.
  • 설정 폴더(~/.claude)는 설치 전에 백업해 둡니다.
  • 도구마다 내세우는 절감 수치는 제작사 자체 측정입니다. 내 프로젝트에서 사용량이 실제로 줄었는지는 /usage로 직접 비교합니다.

자주 묻는 질문

클로드 코드 추천 도구 중 무엇부터 설치하면 되나요?

프로젝트 파일이 많아 클로드가 파일을 하나씩 여느라 시간과 사용량을 쓴다면 Trail-code나 Codebase Memory MCP부터 시작합니다. 역할별로 일을 나누고 싶다면 Agency Agents, 영상 제작이 목적이라면 OpenMontage입니다. 한 번에 하나씩 설치하고 효과를 확인한 뒤 다음을 붙이는 편이 안전합니다.

Graft와 Trail-code는 다른 도구인가요?

같은 프로젝트입니다. Graft가 Trail-code로 이름이 바뀌었고, 새 명령은 trail이며 기존 graft 명령과 패키지도 계속 동작합니다. 코드 지도는 예전 이름 그대로 graft map으로 부릅니다.

이 도구들은 무료인가요?

네 가지 모두 오픈소스 라이선스(MIT 또는 AGPL-3.0)로 공개돼 있어 도구 자체는 무료입니다. 다만 클로드 코드 사용량은 그대로 들고, OpenMontage에서 유료 이미지⁠·음성 서비스를 연결하면 그 서비스 요금이 따로 나옵니다.

Agency Agents를 설치하면 기존 에이전트가 사라지나요?

같은 이름의 파일이 있으면 덮어써질 수 있습니다. 설치 전에 ~/.claude/agents 폴더를 통째로 복사해 두면 문제가 생겨도 되돌릴 수 있습니다. 한 분야만 필요하다면 해당 폴더의 파일만 복사하는 방법이 더 안전합니다.

이 글의 본문은 아래 원본 유튜브 영상의 내용을 바탕으로 쓸모연구소가 다시 정리해 쓴 것입니다. 세부 내용과 최신 정보는 원본 영상과 공식 안내에서 확인해 주세요.

원본 영상 보러가기 ↗