インストール

Apothem は 2 分以内にインストールでき、既存のハーネス構成と並んで動作します。 どの経路も同じ自己完結型エンジンを実行します——ソースツリーはベンダリングした 依存関係を携え、システムの Python 3.10 以降上でチェックアウトから実行されます （自己完結型ランタイムを参照）。

すべての経路が共有する 2 つの前提条件： PATH 上のシステム Python 3.10 以降 と、 そのもとでインポート可能な click および rich パッケージです。npm シムとツール プラグインの経路は、npx を実行するために追加で Node.js 18 以降 を必要とします。 以下の各チャネルの節では、その正確な前提条件、コピーしてすぐ使える 1 つのコマンド、 そして検証ステップを繰り返し示します。

チャネルを選ぶ

8 つのインストールチャネルが利用できます。すでにあなたが使っている方法に合わせて選んでください。

どの経路も冪等です。再実行は安全で、同じ状態へ収束します。

1. Claude Code プラグイン

前提条件： Claude Code、および PATH 上のシステム Python 3.10+。

プラグイン経路は完全に Claude Code の内部で動作します。Apothem のエンジンを、 そのスラッシュコマンド、委任ワーカー、スキル、ルール、フックとともにパッケージ化し、 すべてプラグインの自己完結型ツリーから実行できます。

/plugin marketplace add ahmed-g-gad/apothem
/plugin install apothem@apothem

インストール後、Apothem のコマンド一式（/plan-spec、/code-review、 /security-audit など）、同梱の委任ワーカー、そしてスキルが、すべての Claude Code セッションで利用可能になります。コマンドの完全なカタログは スラッシュコマンドを参照してください。

検証： Claude Code 内で /plugin を実行し、apothem がインストール済みとして 一覧に表示されることを確認するか、ターミナルからドリフトレポートを確認します。

npx @ahmed-g-gad/apothem verify --harness claude-code

2. npm シム (npx)

前提条件： Node.js 18+（npx 用）と PATH 上のシステム Python 3.10+。 シムはインタープリターを見つけ、すべての CLI コマンドを同梱のエンジンへ転送します ——システムに恒久的に何も配置しません。

npx @ahmed-g-gad/apothem install --harness claude-code

リポジトリから直接実行することもできます。

npx github:ahmed-g-gad/apothem install --harness claude-code

CLI リファレンスのすべてのコマンドがこの形式で動作します。 apothem を npx @ahmed-g-gad/apothem に置き換えてください。これは OpenCode を はじめ、独立したプラグインや拡張機能のレジストリを公開しないその他すべてのツールの インストール経路でもあります——Apothem はそれらをネイティブな設定ディレクトリへ 直接同期します（npx @ahmed-g-gad/apothem install --harness opencode）。

検証：

npx @ahmed-g-gad/apothem --version
npx @ahmed-g-gad/apothem verify --harness claude-code

3. ワンショットインストーラー

前提条件： PATH 上のシステム Python 3.10+（インストーラーは click / rich の 前提条件をあなたのために追加することを提案します）。git は、ソースをクローンする ネットワークインストールの場合にのみ必要です。

インストーラースクリプトは、署名された最新のリリースタグを解決し、その署名を検証し、 Apothem のソースツリーをそのタグで ~/.apothem に配置し、プロファイルが存在しない 場合はスタータープロファイルを作成し、最初のハーネスをマテリアライズして結果を検証します。 再実行は冪等です——既存のツリーは解決されたタグへ再チェックアウトされ、ハーネスは 再マテリアライズされます。タグ固定の検証済みインストールがデフォルトかつ推奨の経路です。

curl -fsSL https://apothem.ahmedgad.com/install.sh | bash

irm https://apothem.ahmedgad.com/install.ps1 | iex

同じスクリプトはチェックアウトの scripts/installer/ 配下にも同梱されています ——install、uninstall、update の .sh、.ps1、.bat 形式で——ので、 クローン後に直接実行できます。

APOTHEM_HARNESS=claude-code sh scripts/installer/install.sh                                 # POSIX
$env:APOTHEM_HARNESS = 'claude-code'; pwsh -NoProfile -File scripts/installer/install.ps1   # Windows

トラストモデル

APOTHEM_REF を設定しない場合、インストーラーは最も高い vMAJOR.MINOR.PATCH リリースタグを解決し、それをチェックアウトします——動き続ける main ブランチでは 決してありません。どの設定もマテリアライズする前に、フェッチされたタグの署名が git verify-tag で検証されます。署名のない、改ざんされた、または検証不能なタグは、 何も書き込む前にインストールを中止します。特定のリリースに固定するには APOTHEM_REF を使います。

APOTHEM_REF=vMAJOR.MINOR.PATCH sh -c "$(curl -fsSL https://apothem.ahmedgad.com/install.sh)"

vMAJOR.MINOR.PATCH を リリースページのタグに 置き換えてください。

2 つの明示的なオーバーライドがデフォルトを緩めます。APOTHEM_REF=main は 動き続けるブランチを（検証せずに）チェックアウトし、APOTHEM_ALLOW_UNVERIFIED=1 は 検証の失敗を警告へ格下げして続行します——エアギャップ、ローカル、または事前署名済み リリースでの使用向けです。APOTHEM_SOURCE によるローカルチェックアウトは何も フェッチせず、検証をスキップします。

エンジンはその後、配置されたツリーから直接、自己完結型ランタイムとして実行されます ——サードパーティ依存関係はソースツリーの内部にベンダリングされているため、 パッケージレジストリは一切関与しません。

PYTHONPATH="$HOME/.apothem/src" python -m apothem <command>

両方のスクリプトは同じ設定用環境変数（APOTHEM_HOME、APOTHEM_REPO、 APOTHEM_REF、APOTHEM_ALLOW_UNVERIFIED、APOTHEM_SOURCE、APOTHEM_HARNESS、 APOTHEM_PROFILE、APOTHEM_SKIP_VERIFY、APOTHEM_AUTO_INSTALL_DEPS）を読み取ります。 完全な表は インストーラーの環境変数を、 python -m の呼び出しモデルの仕組みは 自己完結型ランタイムを参照してください。

apothem コマンド。 インストールが成功すると、インストーラーは同梱のエンジンへ 転送する apothem シムを書き込みます——POSIX では $HOME/.local/bin へ、Windows では %LOCALAPPDATA%\Microsoft\WindowsApps（デフォルトの Windows PATH にすでにある ユーザーディレクトリ）へ。インストーラーはあなたの PATH を編集しません。そのディレクトリが PATH 上にあれば、手動の PYTHONPATH なしで apothem <command> を直接実行できます。

検証：

apothem verify --harness claude-code

# or, before the shim is on PATH, from the bundled source:
PYTHONPATH="$HOME/.apothem/src" python -m apothem verify --harness claude-code

4. VS Code 系拡張機能

前提条件： VS Code、Node.js 18+、および PATH 上のシステム Python 3.10+。

Apothem 拡張機能は Visual Studio Marketplace からインストールできます——1 つの拡張機能で VS Code とそのエディター内コンパニオン アシスタント面をカバーします。そのパレットコマンド（Apothem: Install、Verify、 Update、Uninstall、Doctor）は、設定されたランナー（デフォルトでは npx @ahmed-g-gad/apothem。apothem.runner 設定をローカルチェックアウトに向ければ ソースから実行できます）を通して同じエンジンを実行します。

検証： エディターのコマンドパレットから Apothem: Verify コマンドを実行するか、 ターミナルから実行します。

npx @ahmed-g-gad/apothem verify --harness claude-code

5. コマンドラインブートストラップ（拡張機能ホスト）

前提条件： そのホストのコマンドラインツール、Node.js 18+、および PATH 上の システム Python 3.10+。

Apothem をリポジトリから直接、拡張機能としてインストールします——コマンドは正確な ホストとハーネスの slug を携えます。

gemini extensions install https://github.com/ahmed-g-gad/apothem

この拡張機能は、それ自体が完全なインストールではなくブートストラップです：Apothem のコンテキストファイルを読み込み、エンジン（npx @ahmed-g-gad/apothem）へシェルアウト する /apothem コマンドを追加します。それを通してインストールを実行し、完全なハーネスを マテリアライズしてください。

npx @ahmed-g-gad/apothem install --harness gemini-cli --project .

検証：

npx @ahmed-g-gad/apothem verify --harness gemini-cli --project .

6. コマンドラインブートストラップ（qwen-code ホスト）

前提条件： そのホストのコマンドラインツール、Node.js 18+、および PATH 上の システム Python 3.10+。

Apothem をリポジトリから直接、--harness qwen-code 拡張機能としてインストールします。

qwen extensions install ahmed-g-gad/apothem

チャネル 5 の拡張機能と同様、これはブートストラップです：Apothem のコンテキスト ファイルを読み込み、エンジンへシェルアウトします。それを通してインストールを実行し、 完全なハーネスをマテリアライズしてください。

npx @ahmed-g-gad/apothem install --harness qwen-code

検証：

npx @ahmed-g-gad/apothem verify --harness qwen-code

7. コマンドラインブートストラップ（プラグインホスト）

前提条件： そのホストのコマンドラインツール、Node.js 18+、および PATH 上の システム Python 3.10+。

リポジトリをプラグインマーケットプレイスとして追加し、次にプラグインをインストール します——コマンドは正確なホストとハーネスの slug を携えます。

codex plugin marketplace add ahmed-g-gad/apothem
codex plugin add apothem@apothem

チャネル 5 とチャネル 6 の拡張機能と同様、これはエンジンへシェルアウトする ブートストラップです。それを通してインストールを実行し、完全なハーネスを マテリアライズしてください。

npx @ahmed-g-gad/apothem install --harness codex

検証：

npx @ahmed-g-gad/apothem verify --harness codex

8. 直接エンジン (python -m apothem)

前提条件： click と rich パッケージがインポート可能なシステム Python 3.10+、 加えてリポジトリのチェックアウト。Node.js は不要です。

自己完結型エンジンをクローンから直接実行します——ソースツリーはベンダリングした 依存関係を携えているため、PYTHONPATH=src がセットアップのすべてです。

git clone https://github.com/ahmed-g-gad/apothem
cd apothem
PYTHONPATH=src python -m apothem install --harness claude-code

検証：

PYTHONPATH=src python -m apothem verify --harness claude-code

任意のインストールを検証する

上記の各チャネルは、それぞれ独自の検証コマンドを示しています。2 つの汎用形式は 次のとおりです。

PYTHONPATH="$HOME/.apothem/src" python -m apothem verify --harness claude-code

npx @ahmed-g-gad/apothem verify --harness claude-code

ハーネス名をインストールしたアダプターに置き換えてください。対応するすべての名前は ハーネス一覧を参照してください。登録済みの各アダプターを一目で 確認するには、同じ形式で apothem doctor（または npx @ahmed-g-gad/apothem doctor） を実行します。プラグイン経路の場合は、Claude Code 内で /plugin を実行し、 apothem がインストール済みとして一覧に表示されることを確認してください。

前提条件の一覧

• Python 3.10 以降 —— エンジンを実行する各経路がこれを探します （python3、python、バージョン付きの名前、Windows では py -3）。
• そのインタープリターで click と rich がインポート可能であること —— エンジンがベンダリングしていない 2 つのターミナル向け依存関係です。インストーラーは 両方をチェックし、欠けているものを示し、あなたの代わりにインストールすることを 提案します——あなたの確認を得て、または --yes（PowerShell では -Yes）あるいは APOTHEM_AUTO_INSTALL_DEPS=1 で自動的に。
• Node.js 18 以降 —— npm シムとツールプラグインの経路のみ。
• Git —— インストーラー経路のみ。ネットワーク形式の場合のみ必要です （スクリプトがソースをクローンします。ローカルチェックアウトにはクローンは不要です）。
• Claude Code —— プラグイン経路のみ。VS Code と各コマンドラインブートストラップ 自身のホストツールは、それぞれのチャネル (4–7) の場合にのみ必要です。

次のガイド