インストール

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

すべての経路に共通する 2 つの前提条件: PATH 上のシステム Python 3.10 以降と、そのもとでインポート可能な click および rich パッケージです。 npm シム（チャネル 2）、VS Code 系拡張機能（チャネル 4）、コマンドラインブートストラップ（チャネル 5–7）は、npx を実行するために、さらに Node.js 18 以降を必要とします。 Python 3.10 と Node.js 18 および 20 は上流のサポート終了を過ぎています。引き続きサポートされテストされていますが、より新しいバージョンが推奨されます（前提条件の一覧を参照）。 以下の各チャネル固有の節では、その正確な前提条件、コピーしてすぐ使える 1 つのコマンド、検証ステップを改めて示します。

チャネルを選ぶCopy Anchor Link

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

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

1. Claude Code プラグインCopy Anchor Link

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

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

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

インストール後、Apothem のコマンド一式、同梱の委任ワーカー、スキル、そして 4 つの出力スタイル（/output-style で、または /config から 1 つを選びます）が、すべての Claude Code セッションで利用可能になります。 プラグインは各コマンドをスキルとして出荷します。これは SKILL.md と、それが必要に応じて読み込む詳細を収めた、その隣の references/ フォルダーからなるため、Claude Code はプラグインの接頭辞を付けてそれを呼び出します: /apothem:plan-spec、/apothem:security-audit などです。 2 つの名前は Claude Code 自身が使用しています。/plan はプランモードに入り、/code-review は同梱のレビューを実行するため、Apothem のコマンドには /apothem:plan と /apothem:code-review を入力してください。 プラグインではなく Apothem エンジンが Claude Code へのインストールを行う場合、同じスキルが接頭辞なしで ~/.claude/skills/ に書き込まれ、個人用の code-review スキルが同梱の /code-review を置き換えます（その /review エイリアスは引き続き同梱のものを実行します）。 projectify と workflow の 2 つの名前はネイティブスキルでもあります。プラグインとエンジンのインストールが出荷するのはネイティブスキルであり、コマンドから派生させたスキルではありません。 コマンドがどのように分割されるかは Claude Code を、コマンドの完全なカタログはスラッシュコマンドを参照してください。

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

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

2. npm シム（npx）Copy Anchor Link

前提条件: Node.js 18+（npx 用）と、PATH 上のシステム Python 3.10+。 シムはインタープリターを見つけ、すべての CLI コマンドを同梱のエンジンへ転送します——システムには何も恒久的に配置されません。 python3、python、py -3 の順に試します。APOTHEM_PYTHON にインタープリターのパスを設定すると、そのインタープリターが最初に試されます。これは、Python がインストールされているが PATH 上にない場合や、複数のバージョンがあり特定のものを使いたい場合に必要な設定です。 指定したインタープリターも、Python 3.10+ のチェックに合格する必要があります。合格しない場合、シムは python3、python、py -3 の順にフォールバックします。

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

プロファイルのないマシンでは、この最初の install が ~/.config/apothem/profile.yaml にスタータープロファイルを作成し、その旨を表示します。 そのアイデンティティフィールドはプレースホルダーです。それらを個人設定し（npx @ahmed-g-gad/apothem profile edit）、install の代わりに update を指定してコマンドを再実行し、適用してください。

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

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. ワンショットインストーラーCopy Anchor Link

前提条件: PATH 上のシステム Python 3.10+（インストーラーは click / rich の前提条件を追加することを提案します）。git と gpg は、ソースをクローンして署名済みのリリースタグを検証するネットワークインストールの場合に必要です（Git for Windows には両方が含まれています）。

インストーラースクリプトは、署名済みの最新リリースタグを解決し、その署名を検証し、そのタグの Apothem ソースツリーを ~/.apothem に配置し、プロファイルが存在しない場合はスタータープロファイルを作成し、最初のハーネスをマテリアライズし、結果を検証します。これらすべてを 1 回の実行で行います。 スタータープロファイルにはプレースホルダーのアイデンティティフィールドが含まれています。それを編集してから apothem update --harness <name> を実行し、あなたの値を適用してください。 再実行は冪等です。既存のツリーは解決されたタグへ再チェックアウトされ、ハーネスは再マテリアライズされます。 タグに固定された検証済みインストールが、デフォルトかつ推奨の経路です。

まず一度、メンテナーの署名鍵をインポートしてください。お使いのキーリングに鍵がない場合、インストーラーは停止します。フィンガープリントが 5C89 98F9 F241 7204 45D3 F28B 7039 6FED 9C63 4163 と表示されることを確認してください。この値は SECURITY.md で公開されています。Windows では、git verify-tag は Git for Windows に同梱されている gpg のキーリングを読み取るため、インポートは Git 自身の bash を通して実行します:

curl -fsSL https://github.com/ahmed-g-gad.gpg | gpg --import
gpg --fingerprint 70396FED9C634163

& "$env:ProgramFiles\Git\bin\bash.exe" -c 'curl -fsSL https://github.com/ahmed-g-gad.gpg | gpg --import && gpg --fingerprint 70396FED9C634163'

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

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

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

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

信頼モデルCopy Anchor Link

APOTHEM_REF が設定されていない場合、インストーラーは最も高い vMAJOR.MINOR.PATCH リリースタグを解決し、そのタグをチェックアウトします——動き続ける main ブランチを決してチェックアウトしません。いずれかの設定がマテリアライズされる前に、取得したタグの署名が git verify-tag で検証されます。署名のない、改ざんされた、または検証できないタグは、何かが書き込まれる前にインストールを中止させます。メンテナーの公開鍵がまだローカルのキーリングにない署名済みタグの場合は、代わりに鍵のインポートの案内を表示して中止します。上に示したとおりに鍵をインポートし、そのフィンガープリントを SECURITY.md に公開されている値と照合してから、再実行してください。特定のリリースに固定するには、APOTHEM_REF を使います:

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

vMAJOR.MINOR.PATCH をリリースページのタグに置き換えてください。 最も古いリリースタグは、それ自体の署名を持たない軽量タグであるため、そのコミットが署名されていても、タグのチェックはそのタグで中止します。それ以降のすべてのリリースタグは注釈付きで署名されています。 SECURITY.md のリリース署名のセクションに、各タグとその検証方法が記載されています。

明示的なオーバーライドは、既定の動作を緩めます。APOTHEM_ALLOW_UNVERIFIED=1 は、検証の失敗を警告に格下げして続行します。エアギャップ環境またはローカル環境での利用、あるいはタグ署名より前のリリースをインストールする場合を想定しています。APOTHEM_REF=main は、APOTHEM_ALLOW_UNVERIFIED=1 と組み合わせた場合にのみ、検証なしで移動するブランチをチェックアウトします。APOTHEM_REF=main だけを指定すると、インストーラーは main を APOTHEM_HOME に取得したうえで、ブランチは署名付きリリースタグではないため、設定がマテリアライズされる前に中止します。APOTHEM_SOURCE によるローカルチェックアウトは何も取得せず、検証もスキップします。

APOTHEM_VERIFY=checksum は、メンテナーの公開鍵をまだ保持していないホスト向けの中間の経路です。 インストーラーはクローンする代わりに、リリースのプラットフォームアーカイブとその SHA256SUMS をダウンロードし、何かを展開する前にダイジェストの不一致があれば中止し、一致するダイジェストが証明するのは、そのアーカイブがリリースに記載されたものであることであって、誰が公開したかではないと警告します。

その後、エンジンは配置されたツリーから直接実行されます。 click と rich を除くすべてのサードパーティ依存関係はソースツリー内にベンダリングされており、エントリーポイントがそのベンダーディレクトリを自ら sys.path に追加します。

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

両方のスクリプトは同じ設定用環境変数（APOTHEM_HOME、APOTHEM_REPO、APOTHEM_REF、APOTHEM_ALLOW_UNVERIFIED、APOTHEM_VERIFY、APOTHEM_RELEASE_BASE、APOTHEM_SOURCE、APOTHEM_HARNESS、APOTHEM_PROFILE、APOTHEM_SKIP_VERIFY、APOTHEM_AUTO_INSTALL_DEPS、APOTHEM_BIN_DIR）を読み取ります。 完全な表はインストーラーの環境変数を、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 系拡張機能Copy Anchor Link

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

Apothem for VS Code 拡張機能は Visual Studio Marketplace に ahmed-g-gad.apothem-vscode として公開されています。拡張機能ビューから、または code --install-extension ahmed-g-gad.apothem-vscode でインストールできます。 apothem.vsix パッケージからもインストールできます: code --install-extension apothem.vsix、またはエディターの Install from VSIX… コマンドを使います。 リリースワークフローがパッケージに署名し、各 GitHub Release に添付します。 ワークフローが拡張機能をパッケージ化するようになる前に公開されたリリースには、.vsix は含まれていません。最新のリリースにそれがない場合は、tools/vsce/ にロックされた vsce リリース（その vsce リリースには Node.js 22 以降が必要です）を使って、チェックアウトからパッケージをビルドしてください。 npm ci --prefix tools/vsce --ignore-scripts を実行し、続いて cd vscode-extension && ../tools/vsce/node_modules/.bin/vsce package --no-dependencies --out apothem.vsix を実行します。 以前の apothem.vsix からインストールしたコピーは、識別子 ahmed-g-gad.apothem を持ちます。両方のコピーが同じコマンドを登録しないように、code --uninstall-extension ahmed-g-gad.apothem で削除してください。 1 つの拡張機能で、VS Code 系のエディターをカバーします。 そのパレットコマンド（Apothem: Install、Verify、Update、Uninstall、Doctor）は、設定されたランナーを通して同じエンジンを実行します（デフォルトは npx @ahmed-g-gad/apothem@<extension version> で、拡張機能は自身とともに出荷されたバージョンのエンジンを実行します。ソースから実行するには、ユーザー設定 apothem.runner をローカルチェックアウトに向けます）。 Install、Verify、Update、Uninstall はどのハーネスを対象にするかを尋ね、エディター自身のハーネスを最初に提示します。all は選択肢の 1 つであり、決してデフォルトにはなりません。 apothem.runner 設定はマシンスコープであるため、ワークスペースから変更することはできません。また、拡張機能は信頼されたワークスペースでのみ動作します。

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

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

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

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

Apothem をリポジトリから直接、拡張機能としてインストールします——コマンドには正確なホストとハーネスのスラッグが含まれています。

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 ホスト）Copy Anchor Link

前提条件: そのホストのコマンドラインツール、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. コマンドラインブートストラップ（プラグインホスト）Copy Anchor Link

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

リポジトリをプラグインマーケットプレイスとして追加してから、プラグインをインストールします——コマンドには正確なホストとハーネスのスラッグが含まれています。

codex plugin marketplace add ahmed-g-gad/apothem --sparse .agents/plugins --sparse plugins/apothem
codex plugin add apothem@apothem

2 つの --sparse パスは、リポジトリ全体ではなく、マーケットプレイスの一覧とプラグインだけを取得します。完全なクローンは、WSL 配下の Windows ドライブのような低速なディスクでは、ホストの 30 秒のクローン制限を超えることがあります。

チャネル 5 とチャネル 6 の拡張機能と同様に、これはエンジンへシェルアウトするブートストラップです。 プラグインは 1 つのエントリースキルを同梱します。そのマニフェストはルートの plugin.json であり、プラグインホストのハーネスページでは、そのレイアウトと、プラグインがエンジンに任せる部分を説明しています。 それを通してインストールを実行し、完全なハーネスをマテリアライズしてください。

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

検証:

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

8. 直接エンジン（python -m apothem）Copy Anchor Link

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

クローンからエンジンを直接実行します。 エントリーポイントがベンダリングされた依存関係（src/apothem/_vendor）を sys.path に追加するため、click と rich がインポート可能であれば、セットアップは PYTHONPATH=src だけで完了します。

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

npm シムと同様に、プロファイルのないマシンでの最初の install は ~/.config/apothem/profile.yaml にスタータープロファイルを作成し、処理を続行します。

検証:

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

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

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

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

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

ハーネス名は、インストールしたアダプターに置き換えてください。サポートされているすべての名前はハーネス一覧を参照してください。 インストール済みのすべてのアダプター（その検証とフックコマンド）を一度にチェックするには、verify --harness NAME の代わりに doctor を、上で使用した形式のまま実行します。 形式は apothem doctor、PYTHONPATH="$HOME/.apothem/src" python -m apothem doctor、npx @ahmed-g-gad/apothem doctor のいずれかです。 プラグイン経路の場合は、Claude Code 内で /plugin を実行し、apothem がインストール済みとして一覧に表示されることを確認してください。

前提条件の一覧Copy Anchor Link

• Python 3.10 以降 —— Python を見つける経路は名前で見つけます。その名前は経路によって異なります。 npm シムは python3、python、py -3 の順に試します。 インストーラーは python3、python、およびバージョン付きの名前 python3.14 から python3.10 まで順に試します。
• そのインタープリターで click と rich がインポート可能であること —— エンジンがベンダリングしない、ターミナル向けの 2 つの依存関係です。 インストーラーは両方をチェックし、欠けているものを示し、あなたの代わりにインストールすることを提案します——あなたの確認を得て、または --yes（PowerShell では -Yes）か APOTHEM_AUTO_INSTALL_DEPS=1 によって自動的に。 その他のすべてのチャネルでは、パッケージが欠けているとエンジンはエラー（終了コード 1）で停止します。このエラーは、見つかったインタープリター用の正確なコマンドを、Apothem がテストされているバージョン制約とともに示します（<interpreter> -m pip install "click==…" "rich>=…"）。 --json を指定すると、同じエラーがコード runtime.dependency_missing を持つ JSON エンベロープとして届きます。
• Node.js 18 以降 —— npx を実行する経路のみ: npm シム（2）、VS Code 系拡張機能（4）、コマンドラインブートストラップ（5–7）。
• サポート終了したランタイム。 Python 3.10 は 2026-10-01 に、Node.js 18 と 20 はそれぞれ 2025-04-30 と 2026-04-30 に、上流のサポート終了を迎えました。 Apothem は宣言された下限としてこれらを引き続きサポートし、CI でそれぞれをテストしていますが、これらはもう上流のセキュリティ修正を受け取らないため、Python 3.11 以降と Node.js 22 以降を優先して使用してください。 下限の引き上げ方はランタイム下限ポリシーで説明しています。
• Git —— インストーラー経路のみ、それもネットワーク形式の場合のみです（スクリプトがソースをクローンします。ローカルチェックアウトにはクローンは不要です）。
• Claude Code —— プラグイン経路のみ。VS Code と、各コマンドラインブートストラップ自身のホストツールは、それぞれのチャネル（4–7）でのみ必要です。

次のガイドCopy Anchor Link