CLI エージェントは Preview 機能です。
これは ACP の逆方向です。あちらのページは、外部ツールが CTOR の組み込みエージェントに接続する仕組みを扱います。CLI エージェントは CTOR 自身を ACP クライアントにし、Claude Code、Codex、Pi、Cursor Agent を個別の CLI ツールとして駆動します。この 2 つは連結できません — 両方の ACP 機能を併用するを参照してください。
エンジンを選ぶ
新しい空のチャットでは、モデルセレクターの隣にエンジンピルが表示されます。クリックしてバックエンドを選びます：- 組み込みエージェント — CTOR 自身のエージェントで、別途選ばない限りすべてのチャットのデフォルトです
- CLI エンジンごとに 1 つの項目 — Claude Code、Codex、Pi、Cursor Agent — が CLI エージェント (Preview) の見出しの下に並び、それぞれ検出されたバージョンを表示します
CLI エンジン
Claude Code と Codex はそのまま使えます — CTOR がコネクタと CLI 本体の両方をバンドルしているため、インストールするものはありません。Pi と Cursor Agent はそうではありません：CTOR は Pi のコネクタをバンドルしていますが、
pi と cursor-agent のバイナリ自体は自分でインストールする必要があるため、どちらも自分でインストールして初めて選択肢に表示されます（Cursor Agent はさらに 2026 以降のビルドである必要があります — それより古いビルドは ACP に対応していません）。
CLI エージェントがログインしていない場合、CTOR は通知を表示します — 「 は未ログインです。ターミナルで以下のコマンドを実行してから、もう一度送信してください。」 — ログインコマンド用の コピー ボタンとともに。実行してから、もう一度メッセージを送信してください。
有効化と設定
設定 > エージェント > CLI エージェント (Preview) を開きます：- CLI エージェント トグル — 機能のオン・オフを切り替えます。デフォルトで有効。
- 各エンジン用のパスオーバーライド（
claude、codex、pi、cursor-agent） — 自動検出されるバイナリの代わりに、CTOR に特定のバイナリを指定します。空欄のままにすると自動検出されます。自分でインストールしたものを指定すれば、CTOR がバンドルするバージョンに頼らず、自身のプラグインやスキルを使いながら自分で最新の状態に保てます（claude update/codex update）。
トグルをオフにしても、新しいチャットからエンジンピッカーが消えるわけではありません — CLI エージェントで動作するチャットでメッセージを送ろうとしたときにブロックされるだけです。CLI エンジンでチャットを開始する前にオフにしてください。後からでは効果がありません。
モデル、モード、推論強度
CLI エージェントで動作するチャットのモデル、モード、（対応している場合は）推論強度セレクターは、その CLI から直接取得されます — CTOR がリストを選別したり追加したりすることはありません。利用できる内容はエンジンによって異なります：- Claude Code — モデルとモードは、あなた自身の Claude Code の設定とサブスクリプションから取得されるため、正確なリストはユーザーごとに異なります。対応しているモデルには推論強度セレクターが表示されます。
- Codex — 推論強度がモデル自体に組み込まれているため、個別の強度セレクターはありません。モードは読み取り専用からフルの書き込みアクセスまで幅があります。対応バージョンでは、代わりに Normal / Fast の速度トグルが Codex セッションに表示されます。
- Pi — モデルはあなた自身の Pi の設定から取得されます。Pi はセッションモードと推論強度を同じ 1 つの設定として扱うため、CTOR は強度セレクターのみを表示します — 個別のモードセレクターはありません。段階は Claude Code より多く、Max まであります。
- Cursor Agent — モデルとモードは、あなたの Cursor Agent のインストールから取得されます。強度セレクターはありません。
CLI エンジン自身の「Plan」モードは、提供されている場合、CTOR 自身のプランモード機能よりも軽量な仕組みです。CTOR のプランモードは CLI エージェントで動作するチャットでは利用できません — 利用できるのは CLI 自身のモードオプションだけです。
ツール承認
CLI エージェントが、まだ許可されていないコマンドの実行やツールの使用を求めると、CTOR はそのアクションと、CLI が提供する具体的な応答オプションを含む承認カードを表示します — これらはエンジンによって多少異なりますが、常に 1 回だけの許可・常に許可・拒否のいずれかの形を含みます。「常に許可」の選択は CLI 自身が記憶し、CTOR の外ですでに設定されている信頼設定がそのまま使われます。エージェントがプロジェクトでできること
プロジェクトチャットを動かす CLI エージェントは、アプリを操作するために組み込みエージェントが持つのと同じ 2 つの機能を得ます：- 実行中のシミュレーターを駆動する — 開いて、実行中のアプリを操作し、チャットにインラインで表示されるスクリーンショットを撮影します。
- エディターを通じて構造化された編集を行う — 設定ファイルを直接手作業で編集する代わりに。
.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と/compact— CLI は自身のコンテキストを管理するため、どちらのコマンドも提供されません。- ターン実行中のステアリング — CLI が作業中に送信されたメッセージはキューに入れられ、即座にリダイレクトされる代わりに、現在のターンが終わり次第フォローアップとして届けられます。
- カスタムフックは、CLI 自身のツール呼び出しに対しては発火しません。
メインチャットからの CLI エージェント
メインチャットが新しいプロジェクトセッションを生成すると、デフォルトではメインチャット自身が動作しているのと同じ CLI エンジンが使われます。そのセッションを組み込みエージェントで動作させたい場合は、エージェントにそう依頼してください。両方の ACP 機能を併用する
CLI エンジンで動作するチャットは、外部の ACP クライアント（ACPを参照）から駆動することはできません — そのクライアントのセッション一覧には表示され続けますが、CTOR の外部から読み込み・再開・再設定・プロンプト送信を試みても、エラーにはならず失敗するだけです。CLI エージェントで動作するセッションには、CTOR 自身のチャット UI を使用してください。次のステップ
ACP
外部ツールを CTOR の組み込みエージェントに接続します。
サンドボックス
CLI エージェントのセッションがその外側で動作するサンドボックスについて理解します。