설치
빠른 설치 (Linux / macOS)
curl -fsSL https://peria.ai/install.sh | bash
이 명령은 플랫폼에 맞는 최신 릴리스 바이너리를 다운로드하고, SHA256 체크섬을 확인한 후, ~/.local/bin/에 배치합니다.
설치 후 PRECC를 초기화하세요:
precc init
precc init은 Claude Code에 PreToolUse 훅을 등록하고, 데이터 디렉토리를 생성하며, 스킬 데이터베이스를 초기화합니다.
설치 옵션
SHA256 검증
기본적으로 설치 프로그램은 게시된 SHA256 합계와 바이너리 체크섬을 검증합니다. 검증을 건너뛰려면(권장하지 않음):
curl -fsSL https://peria.ai/install.sh | bash -s -- --no-verify
사용자 지정 설치 경로
사용자 지정 위치에 설치:
curl -fsSL https://peria.ai/install.sh | bash -s -- --prefix /opt/precc
OpenCLI (–opencli) — WebFetch token savings
PRECC can also install OpenCLI, a third-party Node.js tool that turns ~148 websites (HackerNews, Reddit, arxiv, bilibili, zhihu, x.com, …) into structured-output commands. When installed, PRECC’s two built-in webfetch-opencli-* skills auto-rewrite raw curl/wget calls into the corresponding opencli <site> command for 5–50× smaller output.
precc init --opencli
This runs npm install -g @jackwener/opencli (requires Node.js 20+) and prints the URL for OpenCLI’s optional Chrome extension. The extension is only needed to reuse logged-in cookies on private pages; public sources work without it.
Skipping --opencli keeps PRECC fully self-contained — the auto-rewrite skill inlines a command -v opencli check that falls back to the original command when OpenCLI isn’t installed, so the skill is safe to ship default-on.
The Chrome extension requests broad permissions (debugger, <all_urls>, cookies). Operators should review them before installing it; --opencli only handles the npm package, not the extension.
동반 도구 (–extras)
PRECC에는 선택적 동반 도구가 포함되어 있습니다. --extras로 설치하세요:
curl -fsSL https://peria.ai/install.sh | bash -s -- --extras
다음을 설치합니다:
| 도구 | 용도 |
|---|---|
| RTK | 명령어 재작성 도구 모음 |
| lean-ctx | CLAUDE.md 및 프롬프트 파일용 컨텍스트 압축 |
| nushell | 고급 파이프라인을 위한 구조화된 셸 |
| cocoindex-code | 더 빠른 컨텍스트 해결을 위한 코드 인덱싱 |
Windows (PowerShell)
irm https://peria.ai/install.ps1 | iex
그런 다음 초기화하세요:
precc init
수동 설치
- 플랫폼에 맞는 릴리스 바이너리를 GitHub Releases에서 다운로드하세요.
- 릴리스의
.sha256파일과 SHA256 체크섬을 확인하세요. - 바이너리를
PATH에 있는 디렉토리(예:~/.local/bin/)에 배치하세요. precc init을 실행하세요.
업데이트
precc update
특정 버전으로 강제 업데이트:
precc update --force --version 0.3.0
자동 업데이트 활성화:
precc update --auto
OpenClaw / ClawHub에서 설치
PRECC는 plugins/openclaw/openclaw.plugin.json 경로에 플러그인 매니페스트(id precc-token-saver)를 함께 제공합니다. 공개 릴리스가 게시되면 GitHub Actions 워크플로 clawhub-publish.yml이 스킬 번들을 ClawHub 레지스트리로 푸시하므로, 최종 사용자는 curl 설치 스크립트 대신 ClawHub CLI를 통해 PRECC를 설치할 수 있습니다:
# ClawHub CLI
clawhub install precc
# Or pin the plugin manifest (id: precc-token-saver) via OpenClaw's
# plugin marketplace UI or its CLI equivalent.
OpenClaw에서 절감 효과가 표시되는 방식
Claude Code에서 동작하는 모든 PRECC 보고 화면은 OpenClaw에서도 동작합니다 — precc savings, precc savings --all, 현지화된 상태 줄(PRECC_LANG=zh로 설정하면 해당 언어로 표시됨), 로컬 재작성 감사 로그 모두 사용자 컴퓨터의 동일한 SQLCipher 데이터베이스에서 읽어옵니다. docs/symposium-plan/openclaw-savings-reporting.md의 별도 사양은 모든 후크 응답에 구조화된 preccSavings 필드를 추가하고 기본 임계값 $0.05에서 한 줄짜리 세션 종료 알림을 보내는 향후 기능을 설명하지만, 이 부분은 아직 출시되지 않았습니다.
설치 확인
$ precc --version
precc 0.3.0
$ precc savings
Session savings: 0 tokens (no commands intercepted yet)
precc를 찾을 수 없는 경우 ~/.local/bin이 PATH에 포함되어 있는지 확인하세요.