Install and what it turns on (한국어)
사전 준비: Node.js ≥ 18 (node -v로 확인 · macOS brew install node · Windows winget install OpenJS.NodeJS.LTS · Linux/WSL은 nvm 권장)
시작하기
사전 준비: Node.js ≥ 18 (node -v로 확인 · macOS brew install node · Windows winget install OpenJS.NodeJS.LTS · Linux/WSL은 nvm 권장)
npm i -g sprag-cli설치하면 Claude Code 화면 하단에 statusline이 곧바로 나타납니다. --ignore-scripts 옵션이나 sudo 사용 등으로 자동 등록이 되지 않았다면 sprag install을 실행해 직접 등록하십시오.
설치 한 번으로 statusline과 Skill, SessionStart 훅, 🅷 Harness(5원칙), 최초 route-scan이 모두 준비됩니다. Harness와 한국어 문체 지침은 무엇이 추가되는지 보여 준 뒤 켤지 물어봅니다. Harness는 ~/.claude/CLAUDE.md에 표시가 붙은 블록으로 추가되며, 기존에 작성해 둔 내용은 백업한 뒤 그대로 보존합니다. 이미 설정되어 있는 경우에는 아무것도 바꾸지 않습니다.
터미널이 아닌 환경(npm의 postinstall, CI, 파이프 입력)에서는 질문을 건너뛰고 기존 기본값을 적용합니다. 질문 없이 진행하려면 --yes나 --no-input, 아예 건너뛰려면 CTS_NO_HARNESS=1 npm i -g sprag-cli를 쓰십시오. 이미 적용한 설정을 되돌리려면 sprag harness uninit --global을 실행하십시오.
⚠️ sudo로 글로벌 설치를 하면 Skill이 사용자 계정이 아니라 root의
~/.claude에 등록되는 함정이 있습니다. nvm이나 fnm, Volta를 사용해 사용자 영역에 설치하기를 권장합니다.
설치하면 켜지는 기능과 직접 켜야 하는 기능
설치 시점에 비용이 들지 않는 기능은 전부 자동으로 켜집니다. 수동으로 남겨 둔 항목은 Claude Code 자체의 설정을 바꾸거나, 적용 범위를 사람이 정해 주어야 하는 것들뿐입니다.
| 기능 | 설치 직후 상태 | 끄는 방법 |
|---|---|---|
| statusline (진단 칩·절감 원장) | 켜짐 | sprag uninstall |
/claude-token-saver Skill | 켜짐 | 위와 같습니다 |
| SessionStart 훅 (route-scan 재분석) | 켜짐 | 위와 같습니다 |
| UserPromptSubmit 훅 (brief 주입) | 켜짐 | 위와 같습니다 |
| 최초 route-scan (최근 14일 로그 분석) | 설치 중 즉시 1회 실행 | 해당 없습니다 |
🅷 Harness 5원칙 (~/.claude/CLAUDE.md) | 켜짐 (터미널에서는 내용을 보여 주고 한 번 묻습니다) | harness uninit --global · CTS_NO_HARNESS=1 |
| doc2md 훅 (Read·Edit·Write·프롬프트) | 켜짐 | doc2md off · CTS_NO_DOC2MD=1 |
| doc2md 변환기(markitdown venv) | 터미널에서 설치 여부를 묻고, 비대화형 설치에서는 명령만 안내합니다 | doc2md install-converter 로 나중에 설치 |
| 한국어 문체 지침 | 시스템 로케일이 한국어면 켜짐 (터미널에서는 묻습니다) | korean off · CTS_NO_KOREAN=1 |
| compact-window 경고 칩 | 켜짐 | compact-window off |
| 업데이트 안내 칩 | 켜짐 | CTS_NO_UPDATE_CHECK=1 |
compact-window 값 고정 (autoCompactWindow 500k) | 꺼짐 — 직접 실행해야 합니다 | compact-window set --global 또는 --project |
모델 피팅 룰 승인 (ratchet-model.md 위임 룰) | 후보만 제안합니다 | route-scan rules 로 확인하고 승인·삭제 |
handoff (한도 임박 시 작업 백업) | 필요할 때 직접 실행하는 명령입니다 | 해당 없습니다 |
compact-window set 은 Claude Code 의 settings.json 에 값을 적고, 전역과 프로젝트 중 어디에 적을지는 사람이 정해야 하므로 자동으로 실행하지 않습니다. 모델 피팅 룰도 같은 이유로 승인 단계를 남겨 두었습니다. 어떤 작업을 더 싼 티어에 맡길지는 사용자의 판단이 필요합니다.