스펙부터 짜고 코딩하게 만드는 GitHub Spec Kit, 토큰·비용을 보여주는 ccusage, 저장소를 통째로 AI에 먹이는 Repomix MCP
오늘은 '코딩 전후'를 받쳐주는 세 가지를 골랐습니다. 바로 코드를 짜는 게 아니라 스펙을 먼저 세우고(Spec Kit), 내가 얼마나 토큰을 썼는지 들여다보고(ccusage), 저장소 전체를 한 덩어리로 AI에 넘기는(Repomix) 도구들입니다.
■ GitHub Spec Kit — 'Vibe 코딩'을 스펙 주도 개발로
repo: github/spec-kit (https://github.com/github/spec-kit)
무엇을: 곧장 코드부터 만들지 말고 '무엇을 만들지'를 명세 → 계획 → 작업 → 구현 단계로 강제하는 GitHub 공식 툴킷입니다. 30종 넘는 AI 코딩 에이전트를 지원하고 Claude Code도 포함됩니다.
사용법:
1) Specify CLI 설치(uv 필요):
uv tool install specify-cli --from git+https://github.com/github/spec-kit.git
2) 프로젝트 초기화(Claude Code 연동):
specify init my-project --ai claude
(현재 폴더에 깔려면 specify init . --ai claude. 플래그명이 버전마다 바뀌니 specify init --help로 확인 권장)
3) Claude Code 안에서 슬래시 커맨드로 진행:
/speckit.constitution 프로젝트 원칙 정의
/speckit.specify 요구사항·유저스토리 작성
/speckit.plan 기술 스택·구현 계획
/speckit.tasks 실행 가능한 작업 목록 생성
/speckit.implement 계획대로 구현
팁: 처음부터 거대하게 잡지 말고 /speckit.specify에서 기능을 잘게 쪼개면, 뒤의 plan·tasks 단계 산출물이 훨씬 깔끔해집니다.
■ ccusage — Claude Code 토큰·비용을 숫자로
repo: ryoppippi/ccusage (https://github.com/ryoppippi/ccusage)
무엇을: Claude Code가 로컬에 쌓아두는 JSONL 기록을 읽어 일/주/월/세션별 토큰 사용량과 비용을 표로 보여줍니다. 설치 없이 npx로 바로 실행됩니다.
사용법:
1) 일별 리포트: npx ccusage@latest daily
2) 주별/월별/세션별: ccusage weekly | ccusage monthly | ccusage session
3) 5시간 과금 구간 보기: ccusage blocks
4) 캐시 토큰(생성/읽기)도 따로 집계하고, --offline로 네트워크 없이 동작합니다.
팁: ccusage는 MCP 서버 모드도 제공해, Claude Desktop 같은 도구 안에서 "이번 달 비용 얼마야?"처럼 직접 물어볼 수 있습니다. 비용이 슬금슬금 오를 때 blocks로 현재 과금 구간 잔량을 확인하면 페이스 조절에 좋습니다.
■ Repomix MCP — 저장소를 'AI 친화적 한 파일'로
repo: yamadashy/repomix (https://github.com/yamadashy/repomix)
무엇을: 저장소 전체(또는 원격 repo)를 LLM이 먹기 좋은 단일 파일로 묶어줍니다. MCP로 붙이면 에이전트가 수동 파일 준비 없이 코드베이스를 통째로 분석할 수 있습니다.
사용법:
1) Claude Code에 MCP로 등록:
claude mcp add --transport stdio repomix uvx repomix
(uv가 없다면 npx 방식도 됩니다)
2) 등록 후 "이 저장소를 패킹해서 구조를 요약해줘"처럼 자연어로 호출하면, 로컬·원격 저장소를 묶어 분석 대상으로 넘겨줍니다.
3) CLI로도 쓸 수 있어 npx repomix 한 줄이면 현재 폴더를 한 파일로 출력합니다.
팁: 토큰이 아까울 땐 무작정 전부 넘기지 말고 패킹 시 포함/제외 패턴으로 범위를 좁히세요. 코드 리뷰·온보딩처럼 '전체 맥락'이 필요한 작업에 특히 잘 맞습니다.
세 도구 모두 설치 플래그·명령이 버전에 따라 바뀔 수 있으니, 막히면 각 저장소의 공식 README를 먼저 확인하길 권합니다.
댓글 (0)
아직 댓글이 없습니다.
댓글을 쓰려면 입장하세요.
← 목록