CCPM (Claude Code Project Mgmt) (Claude Skill) — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

GitHub Issues를 작업 대기열로 활용
이슈별 Git worktree — 진정한 병렬 에이전트 작업
/start /ship /abandon 슬래시 명령
이슈에 연결된 자동 PR 생성
병합/포기 시 정리
gh가 설치된 모든 GitHub 저장소에서 작동

라이브 데모

실제 사용 모습

준비됨

설치

클라이언트 선택

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

Cursor는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "Edit Configuration" 선택.

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "ccpm-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ],
      "_inferred": true
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "ccpm-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/automazeio/ccpm",
        "~/.claude/skills/ccpm"
      ]
    }
  ]
}

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

{
  "context_servers": {
    "ccpm-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/automazeio/ccpm",
          "~/.claude/skills/ccpm"
        ]
      }
    }
  }
}

context_servers에 추가. 저장 시 Zed가 핫 리로드.

claude mcp add ccpm-skill -- git clone https://github.com/automazeio/ccpm ~/.claude/skills/ccpm

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: CCPM (Claude Code Project Mgmt)

한 번에 3개의 Claude 세션을 3개의 다른 이슈에서 실행

👤 솔로 창업자, 인디 개발자 ⏱ ~60 min intermediate

언제 쓸까: 5개의 작은 이슈가 있을 때; 순차적으로 하는 것은 느리지만 브랜치 전환이 상태를 깨트릴 때.

사전 조건

gh CLI 인증 — gh auth login — gh repo view로 확인
스킬 설치 — git clone https://github.com/automazeio/ccpm ~/.claude/skills/ccpm

흐름

이슈 선택

Use ccpm. List open issues; recommend 3 small ones I can do in parallel today.✓ 복사됨

→ 대략적인 예상치와 서로 차단이 없는 3개의 이슈
시작

Start issue #42, #43, #45 each in its own worktree. Open 3 Claude Code sessions ready.✓ 복사됨

→ ../wt-42 등에 3개의 worktree 생성됨; 각 세션이 어떤 이슈를 가지고 있는지 앎
제출

(In each session) When done — /ship — push branch and open PR linked to the issue.✓ 복사됨

→ PR 생성됨, 이슈에 링크됨, CI 시작됨

결과: 브랜치 전환 고통 없이 하루 안에 세 개의 이슈 종료.

함정

이슈들이 겹치는 파일을 건드려 병합 충돌 — 스킬이 선택한 이슈에 파일 중복이 있으면 경고합니다; 병렬 작업을 위해 겹치지 않는 것을 선택하세요

함께 쓰기: github

일상적인 아이디어를 제대로 범위가 정해진 이슈로 변환

👤 아이디어가 넘치는 모든 사람 ⏱ ~5 min beginner

언제 쓸까: 채팅에 '아, 그리고 우리는 또...'를 계속 입력할 때. 적절한 이슈로 캡처하세요.

흐름

캡처

Use ccpm. I want to add JSON export to the dashboard. Create an issue with rationale, acceptance criteria, and a rough plan.✓ 복사됨

→ GitHub에 잘 형성된 이슈 생성됨
링크

Link to related issues if any.✓ 복사됨

→ 링크 추가됨

결과: 나중에 실제로 트리아지할 수 있는 이슈가 되는 아이디어.

함정

이슈가 너무 장황해짐 — 스킬이 본문에 200자 상한을 적용합니다

함께 쓰기: github

썩어가는 브랜치를 남기지 않고 시작된 이슈 깔끔하게 포기

👤 무언가를 시도했다가 재고한 모든 사람 ⏱ ~2 min beginner

언제 쓸까: 이슈를 시작한 지 30분 만에 접근이 잘못됐다는 것을 깨달았을 때; 깔끔하게 빠져나오고 싶을 때.

흐름

포기

/abandon. Remove the worktree, delete the branch, close the issue with a comment explaining why.✓ 복사됨

→ Worktree 삭제됨, 브랜치 삭제됨, 이슈가 설명과 함께 닫힘

결과: 저장소에 고아 브랜치 없음.

함정

실제로 일부 작업을 유지하고 싶었던 경우 — 스킬이 삭제 전 /tmp/ccpm-stashes에 패치를 저장합니다 — 약 7일간 복구 가능

함께 쓰기: github

조합

다른 MCP와 조합해 10배 효율

ccpm-skill + github

CCPM과 GitHub MCP가 이슈 상태에 동의하는지 확인

ccpm-skill + memorix-mcp

worktree 전체에 컨텍스트 전달

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
list	filters	작업 찾기
start	issue_number	이슈 작업 시작
ship	issue_number?	완료; PR 준비됨
abandon	issue_number, reason	깔끔하게 포기

비용 및 제한

운영 비용

API 쿼터: GitHub API 제한에 따라 결정 (인증 시 5000회/시간)
호출당 토큰: 가벼움 — 대부분의 작업은 git + gh CLI
금액: 무료
팁: 과도하게 이슈를 만들지 마세요 — 스킬이 생각을 캡처하도록 권장하지만 모든 미세한 생각은 아닙니다

보안

권한, 시크릿, 파급범위

최소 스코프: repo (이슈 + PR 쓰기용)

자격 증명 저장: gh auth를 통해

데이터 외부 송신: GitHub API

절대 부여 금지: admin:org

/abandon이 브랜치를 삭제합니다 — 공유 저장소에는 확인 플래그가 필요합니다

문제 해결

자주 발생하는 오류와 해결

git worktree add 실패: 이미 사용됨

이전 worktree가 여전히 존재합니다; git worktree prune으로 정리하세요

확인: `git worktree list`

gh PR create가 '커밋 없음' 오류

/ship 전에 worktree 브랜치에 최소 하나의 커밋을 만드세요

두 세션이 같은 이슈를 클레임

스킬이 이슈별 잠금 파일을 씁니다 — 두 번째 시작이 명확한 메시지와 함께 실패합니다

대안

CCPM (Claude Code Project Mgmt) 다른 것과 비교

대안	언제 쓰나	단점/장점
Linear MCP	GitHub Issues가 아닌 Linear를 사용할 때	CCPM은 GitHub 전용이지만 Linear MCP는 자체 생태계입니다
일반 `git worktree` + 체크리스트	한 번에 하나의 에이전트만 실행할 때	수동이지만 CCPM이 라이프사이클을 자동화합니다

CCPM (Claude Code Project Mgmt)

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

설치

클라이언트 선택

사용 사례

실전 활용법: CCPM (Claude Code Project Mgmt)

한 번에 3개의 Claude 세션을 3개의 다른 이슈에서 실행

사전 조건

흐름

함정

일상적인 아이디어를 제대로 범위가 정해진 이슈로 변환

흐름

함정

썩어가는 브랜치를 남기지 않고 시작된 이슈 깔끔하게 포기

흐름

함정

조합

다른 MCP와 조합해 10배 효율

도구

이 MCP가 노출하는 것

비용 및 제한

운영 비용

보안

권한, 시크릿, 파급범위

문제 해결

자주 발생하는 오류와 해결

대안

CCPM (Claude Code Project Mgmt) 다른 것과 비교

더 보기

리소스