Cursor와 함께 PRECC 사용하기

PRECC는 Claude Code용 PreToolUse 훅으로 만들어졌지만, 기반이 되는 스킬 라이브러리 — cargo-wrong-dir, git-wrong-dir, npm-wrong-dir, jj-translate 등 — 는 에디터에 종속되지 않습니다. 짧은 셸 스니펫만으로 Cursor의 통합 터미널에 입력되는 모든 명령을 precc-hook을 통해 라우팅할 수 있으며, Claude Code에서 토큰을 절약하던 동일한 재작성 규칙이 Cursor에서도 그대로 적용됩니다.

Requires precc ≥ 0.3.45. Earlier versions don’t plant the integration scripts under <data_dir>/integrations/cursor/. Run precc update to upgrade if you have an older release.

지원 범위

이 통합은 사용자가 Cursor의 터미널에 직접 입력하는 명령을 포착합니다. zsh에서는 Enter 키를 누르기 전에 명령줄을 자동으로 재작성하지만, bash에서는 경고만 가능합니다(DEBUG 트랩이 명령이 확정된 이후에 발동되기 때문입니다). Cursor의 에이전트가 bash -c 서브프로세스로 실행하는 명령은 대화형 셸 초기화 스크립트를 로드하지 않으므로 훅이 이를 감지하지 못합니다. 이 공백을 메우려면 PATH 심(shim)이 필요하지만, 아직 이 디렉터리에는 포함되어 있지 않습니다. Cursor의 셸이 아닌 도구 호출(파일 편집, 코드 검색)도 적용 대상이 아닙니다.

설치

zsh (자동 재작성)

source ~/.local/share/precc/integrations/cursor/precc-preexec.zsh

precc init를 한 번 실행하면 위 경로에 스크립트가 설치됩니다 (precc의 저장소에서 <data_dir>를 사용하므로 CLAUDE_CONFIG_DIR 및 기타 프로파일 격리가 준수됩니다). 그런 다음 source 라인을 ~/.zshrc에 추가하십시오. precc-hook과 jq가 PATH에 있어야 하며, 둘 중 하나라도 없으면 스크립트는 깔끔하게 동작하지 않습니다.

bash (경고 전용)

source ~/.local/share/precc/integrations/cursor/precc-preexec.bash

precc init를 한 번 실행하면 위 경로에 스크립트가 설치됩니다. 그런 다음 source 라인을 ~/.bashrc에 추가하십시오. DEBUG 트랩은 제안된 재작성 결과를 적용하지 않고 stderr에 출력하므로, 제안 사항을 수동으로 복사할 수 있습니다.

검증

Cursor의 터미널에서 cd /tmp (또는 Rust 프로젝트 밖의 아무 위치)로 이동한 뒤 Rust 빌드 명령을 입력하고 Enter를 누르세요. zsh에서는 버퍼가 PRECC가 재작성한 형태(보통 cd PATH && … 스타일의 접두 형식)로 그 자리에서 바뀌어야 합니다. bash에서는 stderr에 [precc] suggested rewrite: … 한 줄이 표시되어야 합니다.

주의 사항

• 키 입력마다 precc-hook 지연이 추가됩니다. 훅은 p50 기준 <5 ms를 목표로 하지만 콜드 캐시 상태에서는 p99가 더 높습니다. 이 책의 훅 지연 관련 항목을 참고하세요.
• 이 경로에서는 텔레메트리가 수집되지 않습니다. 훅은 감지된 agent_class로 보고하는데, 이는 claude-code가 아니므로 Cursor에서의 절약분은 공개 통계 페이지에 표시되지 않습니다.
• 재작성 사유는 한 번의 키 입력 동안 zle -M으로 잠깐 표시됩니다. 모달이 아닌 조용한 알림입니다.
• 에이전트까지 지원하려면 PATH 심(~/.precc/bin/cargo, ~/.precc/bin/git, … 위치의 래퍼)이 다음 단계로 계획되어 있습니다.