준비: 공식 플러그인과 스킬

왜 미리 갖추는가

4단계 구현에서 프로세스 플러그인이 어디서 개입하는지 관찰하고, 매 단계 끝에 계측값을 읽어야 합니다. 둘 다 미리 깔려 있어야 합니다.

이 단계에서 하는 것

번들 스킬이 무엇인지 확인하고, 프로세스 게이트 플러그인과 계측 도구를 설치하고, 안 쓸 것을 끕니다. 프로세스 플러그인이 대신해 주는 것은 판단의 타이밍입니다. 그 점은 Plugins가 설명합니다.

따라하기

/skills를 쳐서 번들 스킬을 봅니다.

/skills

본 실습과 관계있는 번들 스킬만 한 줄씩 짚어 둡니다.

/code-review는 8단계(코드 리뷰)의 대안입니다.
/debug는 10단계(버그픽스)의 대안입니다.
/verify와 /run은 앱을 띄워 확인할 때 씁니다.

/security-review는 번들 스킬이 아니라 내장 커맨드입니다. 11단계에서 아티팩트를 공개하기 전에 씁니다.

프로세스 게이트 플러그인을 설치합니다.

/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

설치 후 /skills에 superpowers:brainstorming, superpowers:writing-plans, superpowers:test-driven-development 같은 항목이 보이면 됩니다. 각각이 개입하는 단계는 다음과 같습니다. brainstorming은 1단계 인터뷰와 겹치고, writing-plans는 2단계, test-driven-development는 4단계, verification-before-completion은 매 단계 완료 선언 직전입니다.

계측값을 읽을 수단을 갖춥니다. 기록표에 필요한 값은 컨텍스트 사용률과 세션 누적 비용 둘이고, 둘 다 Claude Code가 상태줄에 직접 줍니다. 상태줄 설정은 활용 팁에 있습니다. 상태줄에 두 값이 보이면 이 항목에서 더 설치할 것은 없습니다. /cost로 읽어도 됩니다.

아래 두 도구는 선택입니다.

5시간·7일 한도는 Pro·Max 구독이면 상태줄 JSON의 rate_limits로도 직접 받을 수 있습니다(활용 팁의 필드 표). OpenUsage는 Claude 외에 Codex, Cursor, Copilot 같은 여러 도구의 한도를 한 곳에서 볼 때 씁니다. 이름이 같은 두 프로젝트가 있고 명령 이름도 둘 다 openusage입니다. 하나만 고릅니다.

메뉴바 앱 robinebers/openusage(openusage.ai)는 macOS 15 이상용 무료 오픈소스 앱입니다. 각 도구의 한도 사용률과 초기화 시각을 메뉴바에 표시하고, 같은 값을 127.0.0.1:6736의 로컬 HTTP API와 openusage 명령으로 내보내 상태줄이나 스크립트에서 읽을 수 있게 합니다. 계정이 필요 없고 자격 증명은 루프백 밖으로 나가지 않습니다.

brew install --cask openusage
openusage

터미널 대시보드 janekbaraniewski/openusage는 macOS·Linux 공통이고 openusage statusline install로 Claude Code 상태줄에 바로 얹을 수 있습니다.

brew install janekbaraniewski/tap/openusage
openusage

Homebrew가 없는 환경은 배포 스크립트를 씁니다. 내려받은 스크립트는 실행 전에 한 번 열어 봅니다.

curl -fsSL https://github.com/janekbaraniewski/openusage/releases/latest/download/install.sh | bash
openusage

둘 중 무엇을 써도 기록표에는 영향이 없습니다. 한도 값은 기록표에 적지 않습니다.

세션별 토큰·비용 표가 필요하면 ccusage를 씁니다.

npx ccusage@latest session

Total Tokens와 Cost (USD) 열이 세션마다 한 줄씩 나옵니다. 상태줄이 보여주는 값과 무엇이 다른지는 각자 화면에서 확인합니다.

교차 벤더 리뷰(선택). 8단계의 선택 경로는 Codex CLI의 codex exec review를 터미널에서 직접 실행합니다. Codex 구독이 있으면 Codex CLI를 설치하고 로그인합니다.

npm install -g @openai/codex
codex login

Claude Code 안에서 Codex를 부르는 플러그인은 8단계에 필요하지 않습니다. 쓰려면 마켓플레이스 등록 뒤 설치까지 두 명령이 필요합니다.

/plugin marketplace add openai/codex-plugin-cc
/plugin install codex@openai-codex

없어도 완주할 수 있습니다.

안 쓸 것을 끕니다. 스킬 목록 자체가 컨텍스트를 차지하므로, 이 튜토리얼에 없는 스킬은 ~/.claude/settings.json에서 내립니다.

{
  "skillOverrides": {
    "<플러그인>:<스킬>": "user-invocable-only"
  }
}

네 값의 의미는 Skills에 있습니다.

완료 확인

/plugin에 superpowers가 보이고, 상태줄 또는 /context·/cost에서 이 세션의 컨텍스트 사용률과 누적 비용을 읽을 수 있으면 됩니다.

계측 기록

기록표의 시작·끝 비용과 컨텍스트 사용률은 상태줄 또는 /cost·/context로 읽습니다. ccusage를 설치했다면 session 출력의 Total Tokens와 Cost (USD) 열로 세션 간 비교를 보충합니다.

어긋났을 때

설치했는데 스킬이 안 걸리면 skillOverrides부터 확인합니다. 네 값의 의미는 Skills에 있습니다.
플러그인 사용 기록이 이상하면 pluginUsage.lastUsedAt이 설치 시점에 채워진다는 점을 확인합니다. 자세한 동작은 Plugins에 있습니다.