> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bricks.tools/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI エージェント

> Claude Code、Codex、Pi、Cursor Agent といったローカル CLI コーディングエージェントで、ACP 経由でチャットを動かす

チャットセッションは、CTOR 自身の組み込みエージェントの代わりに、ローカルの CLI コーディングエージェントで動かせます。CTOR は CLI を生成し、[ACP（Agent Client Protocol）](/ja/ctor/reference/acp) でそれと対話します。これにより、CTOR は自身のエージェントを駆動するのと同じ方法で CLI エージェントを駆動できます — プロンプトの送信、ツール呼び出しの表示、チャットへのレスポンスの描画を行います。

<Info>
  CLI エージェントは **Preview** 機能です。
</Info>

<Note>
  これは [ACP](/ja/ctor/reference/acp) の逆方向です。あちらのページは、*外部*ツールが CTOR の組み込みエージェントに接続する仕組みを扱います。CLI エージェントは CTOR 自身を ACP クライアントにし、Claude Code、Codex、Pi、Cursor Agent を個別の CLI ツールとして駆動します。この 2 つは連結できません — [両方の ACP 機能を併用する](#両方の-acp-機能を併用する)を参照してください。
</Note>

## エンジンを選ぶ

新しい空のチャットでは、モデルセレクターの隣に**エンジン**ピルが表示されます。クリックしてバックエンドを選びます：

* **組み込みエージェント** — CTOR 自身のエージェントで、別途選ばない限りすべてのチャットのデフォルトです
* CLI エンジンごとに 1 つの項目 — **Claude Code**、**Codex**、**Pi**、**Cursor Agent** — が **CLI エージェント (Preview)** の見出しの下に並び、それぞれ検出されたバージョンを表示します

利用できないエンジンも表示されますが無効化されており、**未インストール** または **更新が必要 — このバージョンは ACP 非対応です** というラベルが付きます。

<Warning>
  エンジンの選択は、チャットに最初のメッセージが送られた瞬間にロックされます。後からチャットのエンジンを切り替える方法はありません — 別のエンジンを使うには新しいチャットを開始してください。
</Warning>

セッションのエンジンは、サイドバーのタイトルの隣に小さなアイコンとしても表示されます。

## CLI エンジン

| エンジン             | インストール                                                                                 | 最小バージョン                    | 認証                                 |
| ---------------- | -------------------------------------------------------------------------------------- | -------------------------- | ---------------------------------- |
| **Claude Code**  | CTOR にバンドル済み — インストール不要。システムインストールが見つかった場合はそちらが優先されます。                                 | 2.1.0（システムインストールのみ）        | 既存の Claude Code ログイン               |
| **Codex**        | CTOR にバンドル済み — インストール不要。システムインストールが見つかった場合はそちらが優先されます。                                 | 0.144.0（システムインストールのみ）      | 既存の Codex ログイン（ChatGPT または API キー） |
| **Pi**           | コネクタは CTOR にバンドル済み。`PATH` 上に別途 [`pi`](https://github.com/earendil-works/pi) のインストールが必要 | 強制なし — 検出されたバージョンであれば動作します | ターミナルで `pi` を実行してログインし、プロバイダーを設定   |
| **Cursor Agent** | `PATH` 上に別途 [`cursor-agent`](https://cursor.com/docs/cli) のインストールが必要                   | 2026.01                    | 既存の Cursor Agent ログイン              |

Claude Code と Codex はそのまま使えます — CTOR がコネクタと CLI 本体の両方をバンドルしているため、インストールするものはありません。Pi と Cursor Agent はそうではありません：CTOR は Pi のコネクタをバンドルしていますが、`pi` と `cursor-agent` のバイナリ自体は自分でインストールする必要があるため、どちらも自分でインストールして初めて選択肢に表示されます（Cursor Agent はさらに 2026 以降のビルドである必要があります — それより古いビルドは ACP に対応していません）。

CLI エージェントがログインしていない場合、CTOR は通知を表示します — *「{engine} は未ログインです。ターミナルで以下のコマンドを実行してから、もう一度送信してください。」* — ログインコマンド用の **コピー** ボタンとともに。実行してから、もう一度メッセージを送信してください。

## 有効化と設定

**設定 > エージェント > CLI エージェント (Preview)** を開きます：

* **CLI エージェント** トグル — 機能のオン・オフを切り替えます。デフォルトで有効。
* 各エンジン用のパスオーバーライド（`claude`、`codex`、`pi`、`cursor-agent`） — 自動検出されるバイナリの代わりに、CTOR に特定のバイナリを指定します。空欄のままにすると自動検出されます。自分でインストールしたものを指定すれば、CTOR がバンドルするバージョンに頼らず、自身のプラグインやスキルを使いながら自分で最新の状態に保てます（`claude update` / `codex update`）。

各行には、検出されたバージョンと、それがシステムインストールか CTOR にバンドルされたものかも表示されます。

<Note>
  トグルをオフにしても、新しいチャットからエンジンピッカーが消えるわけではありません — CLI エージェントで動作するチャットでメッセージを送ろうとしたときにブロックされるだけです。CLI エンジンでチャットを開始する前にオフにしてください。後からでは効果がありません。
</Note>

## モデル、モード、推論強度

CLI エージェントで動作するチャットのモデル、モード、（対応している場合は）推論強度セレクターは、その CLI から直接取得されます — CTOR がリストを選別したり追加したりすることはありません。利用できる内容はエンジンによって異なります：

* **Claude Code** — モデルとモードは、あなた自身の Claude Code の設定とサブスクリプションから取得されるため、正確なリストはユーザーごとに異なります。対応しているモデルには推論強度セレクターが表示されます。
* **Codex** — 推論強度がモデル自体に組み込まれているため、個別の強度セレクターはありません。モードは読み取り専用からフルの書き込みアクセスまで幅があります。対応バージョンでは、代わりに **Normal / Fast** の速度トグルが Codex セッションに表示されます。
* **Pi** — モデルはあなた自身の Pi の設定から取得されます。Pi はセッションモードと推論強度を同じ 1 つの設定として扱うため、CTOR は強度セレクターのみを表示します — 個別のモードセレクターはありません。段階は Claude Code より多く、**Max** まであります。
* **Cursor Agent** — モデルとモードは、あなたの Cursor Agent のインストールから取得されます。強度セレクターはありません。

<Note>
  CLI エンジン自身の「Plan」モードは、提供されている場合、CTOR 自身の[プランモード](/ja/ctor/reference/plan-mode)機能よりも軽量な仕組みです。CTOR のプランモードは CLI エージェントで動作するチャットでは利用できません — 利用できるのは CLI 自身のモードオプションだけです。
</Note>

## ツール承認

CLI エージェントが、まだ許可されていないコマンドの実行やツールの使用を求めると、CTOR はそのアクションと、CLI が提供する具体的な応答オプションを含む承認カードを表示します — これらはエンジンによって多少異なりますが、常に 1 回だけの許可・常に許可・拒否のいずれかの形を含みます。「常に許可」の選択は CLI 自身が記憶し、CTOR の外ですでに設定されている信頼設定がそのまま使われます。

<Warning>
  Pi は例外です：自身のツールであっても、CTOR のブリッジ経由で提供される MCP ツールであっても、Pi は CTOR に承認リクエストを送信しません。Pi のすべてのツール呼び出し — ファイル編集やシェルコマンドを含む — は、あなたの OS ユーザー権限のもとで即座に実行され、それを制御する CTOR の承認カードはありません。
</Warning>

<Warning>
  CLI エージェントのセッションは、BRICKS の[サンドボックス](/ja/ctor/reference/sandbox)の外で完全に動作します。CLI は、ターミナルで実行する場合と同じファイルアクセスとシェルアクセスを持ち、その CLI 自身の権限システムのみに従います — BRICKS のサンドボックス設定、ネットワーク承認、危険なコマンド検出には従いません。
</Warning>

## エージェントがプロジェクトでできること

プロジェクトチャットを動かす CLI エージェントは、アプリを操作するために組み込みエージェントが持つのと同じ 2 つの機能を得ます：

* **実行中の[シミュレーター](/ja/ctor/reference/simulator)を駆動する** — 開いて、実行中のアプリを操作し、チャットにインラインで表示されるスクリーンショットを撮影します。
* **[エディター](/ja/ctor/reference/editor)を通じて構造化された編集を行う** — 設定ファイルを直接手作業で編集する代わりに。

[メインチャット](/ja/ctor/guide/main-chat)セッションの場合は、代わりに同等のオーケストレーション機能を得ます — 他のセッションの作成、一覧表示、管理です。

エージェントが確認の質問をする必要がある場合、組み込みエージェントの確認の質問と同様に、入力バーの近くにカードとして表示されます。

[グローバルスキルとプロジェクトスキル](/ja/ctor/reference/skills)も引き続き機能します — CTOR が CLI エージェントにそれぞれの場所を伝え、タスクに必要なときは他のファイルと同じように指示を読み込みます。

プロジェクト自身の [MCP サーバー](/ja/ctor/reference/mcp)は、エンジンごとに異なる方法で利用可能になります。Claude Code はプロジェクトの `.mcp.json` を自身で読み取ります。Cursor Agent は CTOR からプロジェクトのサーバーと継承されたサーバーを受け取り、それぞれに独自の承認プロンプトが表示されます。Pi はネイティブに MCP サーバーを受け取れないため、CTOR は自身のデスクトップツールと同じブリッジ経由でそれらをプロキシし、通常のツールとして Pi に公開します。個別の承認ステップはありません（上記の警告を参照）。Codex セッションは現時点でプロジェクトに設定された MCP サーバーにアクセスできません。

## セッションの挙動

CTOR のセッション機能の大半は、CLI エージェントで動作するチャットでも同じように動作します — フォーク、メッセージの編集と再送信、`/undo` はすべて機能します。CLI 自身の会話は直接編集できないため、これらの操作はその CLI との新しい会話を開始し、コンテキストを持たせるために履歴のサマリーを種として与えます。CTOR 上に表示されているチャット履歴が影響を受けることは一切ありません。非常に長い会話では、そのサマリーは CLI 自身のネイティブなメモリほど完全ではない場合があります。

CLI エージェントで動作するチャットを再度開くと、再接続の必要なく、すぐに全履歴が表示されます。CTOR がバックグラウンドで CLI 自身のセッションを再開できない場合（長期間開いていなかった場合や CLI の更新後など）、1 回限りの通知が表示されます — *「CLI エージェントのセッションを再起動しました — それまでのコンテキストはエージェント向けに要約されました。上記の全履歴は保持されています。」* — その後、会話は通常どおり続行されます。

組み込みエージェントの機能のうち、いくつかは CLI エージェントで動作するチャットでは利用できません：

* [`/goal`](/ja/ctor/reference/commands#goal) と [`/compact`](/ja/ctor/reference/commands#compact) — CLI は自身のコンテキストを管理するため、どちらのコマンドも提供されません。
* ターン実行中のステアリング — CLI が作業中に送信されたメッセージはキューに入れられ、即座にリダイレクトされる代わりに、現在のターンが終わり次第フォローアップとして届けられます。
* カスタム[フック](/ja/ctor/reference/hooks)は、CLI 自身のツール呼び出しに対しては発火しません。

コンテキストウィンドウインジケーターは Claude Code と Codex のセッションには表示されます（Codex はコスト見積もりも表示します）が、どちらも使用状況を報告しない Pi と Cursor Agent には表示されません。

## メインチャットからの CLI エージェント

[メインチャット](/ja/ctor/guide/main-chat)が新しいプロジェクトセッションを生成すると、デフォルトではメインチャット自身が動作しているのと同じ CLI エンジンが使われます。そのセッションを組み込みエージェントで動作させたい場合は、エージェントにそう依頼してください。

## 両方の ACP 機能を併用する

CLI エンジンで動作するチャットは、外部の ACP クライアント（[ACP](/ja/ctor/reference/acp)を参照）から駆動することはできません — そのクライアントのセッション一覧には表示され続けますが、CTOR の外部から読み込み・再開・再設定・プロンプト送信を試みても、エラーにはならず失敗するだけです。CLI エージェントで動作するセッションには、CTOR 自身のチャット UI を使用してください。

## 次のステップ

<CardGroup cols={2}>
  <Card title="ACP" icon="plug" href="/ja/ctor/reference/acp">
    外部ツールを CTOR の組み込みエージェントに接続します。
  </Card>

  <Card title="サンドボックス" icon="shield-halved" href="/ja/ctor/reference/sandbox">
    CLI エージェントのセッションがその外側で動作するサンドボックスについて理解します。
  </Card>
</CardGroup>