Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

インストール

クイックインストール (Linux / macOS)

curl -fsSL https://peria.ai/install.sh | bash

これはお使いのプラットフォーム用の最新リリースバイナリをダウンロードし、SHA256チェックサムを検証して ~/.local/bin/ に配置します。

インストール後、PRECCを初期化します：

precc init

precc init はPreToolUseフックをClaude Codeに登録し、データディレクトリを作成し、スキルデータベースを初期化します。

インストールオプション

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-ctxCLAUDE.mdおよびプロンプトファイルのコンテキスト圧縮
nushell高度なパイプライン用の構造化シェル
cocoindex-codeより高速なコンテキスト解決のためのコードインデックス

Windows (PowerShell)

irm https://peria.ai/install.ps1 | iex

次に初期化します：

precc init

手動インストール

  1. お使いのプラットフォーム用のリリースバイナリを GitHub Releases からダウンロードします。
  2. リリースの .sha256 ファイルに対してSHA256チェックサムを検証します。
  3. バイナリを PATH 上のディレクトリ（例：~/.local/bin/）に配置します。
  4. 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 に含まれていることを確認してください。