ACPクライアントの使用

ACP Client 拡張機能を使用すると、コードベースを理解し、ファイルの編集、コマンドの実行、ビルドの開始など、ユーザーに代わって操作を実行できるAIエージェントとチャットすることができます。

このトピックでは、ACP Client拡張機能の有効化からエージェントとの生産的なチャットセッションの実現に至るまで、設定と使用方法について順を追って説明します。

前提条件

• Extensions モードで「ACP Client 」拡張機能を有効にしてください。拡張機能の詳細については、「拡張機能の有効化」を参照してください。
• 推奨：エージェントにプロジェクトのビルドや実行などのQt Creator アクションを実行させたい場合は、「MCP Server 」拡張機能を有効にして設定してください。詳細については、「Qt Creator MCPサーバーの設定」を参照してください。

エージェントの設定

チャットを開始する前に、Preferences でエージェントを選択してください。あらかじめ設定済みのエージェントから選択するか、カスタムエージェントを定義することができます。

事前設定済みのエージェント

事前設定済みのエージェントを設定するには：

1. Preferences > [AI ] > [ACP Servers] に移動します。
2. 「Add 」を選択します。
3. 「Template 」で、既定の設定のまま使用する既定のエージェントを選択します。
4. 「Apply 」を選択して保存します。

カスタムエージェント

カスタムエージェントを設定するには：

1. コンピュータまたはネットワークに AI エージェントをインストールし、接続を確認します。
2. Preferences > [AI ] > [ACP Servers] に移動します。
3. 「Add 」を選択します。
4. 「Template 」で、「Custom 」を選択します。
5. 「Name 」で、エージェント構成の名前を指定します。
6. 「Executable 」で、ACP サーバープロセスを起動するための実行ファイルを指定します。
7. Arguments で、ACP サーバープロセスの起動時に渡すコマンドライン引数を指定します。
8. 「Environment Changes 」で、「Change 」を選択し、エージェントプロセスに必要な環境変数の変更を追加します。
9. 「Apply 」を選択して保存します。

エージェントへの接続

ACP レジストリの内容によって、特定のエージェントへの接続方法が決定されます。

• binary パッケージは、依存関係なしに直接使用されます。
• npx Node.js パッケージを使用するには、Node.js をインストールする必要があります。
• uvx Python パッケージを使用するには、uvパッケージマネージャーと Python をインストールする必要があります。

npx

Node.js がインストールされていることを確認するには、コマンドラインで「node --version 」と入力してください。

フォルダが PATH に含まれているにもかかわらず、AI エージェントが Claude エージェントの実行に使用するnpx バイナリを見つけられない場合は、Preferences >Environment >System で、npx ディレクトリをパスに追加してください。Environment で、Change を選択し、PATH+=<full-path-to-folder ）を追加してください。

Claude CLI

一部のエージェントを使用するには、追加の依存関係をインストールする必要がある場合があります。たとえば、Claude への認証を行うには、Claude Code CLI もインストールする必要があります。インストールされているかどうかを確認するには、コマンドラインで `claude --version ` と入力してください。

ACPチャットウィンドウを開く

Edit モードでは、以下の方法でACPチャットウィンドウを開くことができます：

• 「Tools 」＞「ACP Client 」＞「Show Agentic AI Chat in Side Panel 」の順に選択します。
• ファイルを開いている状態で、エディタのツールバーから「 (Show Agentic AI Chat in Side Panel)」を選択します。

ACPサーバーへの接続

プロジェクトのチャットウィンドウを開いたら、ACPサーバーに接続します。

ACP サーバーに接続するには：

1. 設定済みのエージェントを選択します。
2. 「Connect 」を選択します。

「Choose AI Agent 」にエージェントが一覧表示されていない場合は、「Manage Agents 」を選択して追加してください。

Qt Creator これにより、エージェントプロセスが起動し、ACP接続が確立されます。

新しいセッションを開始するには、[ ] → [Add Chat ] を選択し、サーバーに接続します。

ACP 通信の確認

ACP クライアント拡張機能は、ACP サーバーにメッセージ（リクエスト）を送信し、サーバーがリクエストを処理できる場合は、要求された情報を含む応答を受け取ります。拡張機能と ACP サーバー間の通信を確認するには、Tools >ACP Client >Inspect ACP Client に移動します。

ACP Client で、ACP サーバーを選択すると、イベントの一覧が表示されます。イベントを選択すると、Client Message でクライアントのリクエストを、Server Message でサーバーの応答を確認できます。

古いエントリを削除するには、Clear を選択します。

メッセージをファイルとして保存するには、[Save] を選択します。

チャットウィンドウのツールバー

接続すると、チャットウィンドウ下部のツールバーに、セッション中にいつでも調整できるコントロールが表示されます。

ツールバーの各設定オプションは、選択したエージェントによって異なります。オプションの詳細を確認するには、そのオプションにカーソルを合わせるとツールチップが表示されます。

エージェントとのチャット

チャットウィンドウの下部にある入力フィールドにメッセージを入力し、「Send 」または「Enter」キーを選択します。

メッセージにコマンドを挿入するには、/ を選択し、リストからコマンドを選択してください。

メッセージ内のコンテキスト

Qt Creator は、現在のエディタのコンテキストをすべてのメッセージに自動的に添付するため、次のような自然な参照を使用できます:

• 現在のコードを説明してください。
• 選択したブロックをリファクタリングして、範囲指定の for ループを使用するようにしてください。
• なぜビルドが失敗するのですか？修正してください。

  注：これには 、エージェントがビルドシステムを呼び出し、コンパイラの出力を読み取れるようにするための MCP サーバー拡張機能が必要です。

• カーソル位置にある関数に対して、単体テストを追加してください。
• 表示されているコードを確認し、改善案を提案してください。

メッセージに手動でコンテキストを追加するには、Context で「 」>「Add file 」または「Add remote file 」を選択してください。

エージェントの応答

エージェントの返信はチャットウィンドウに表示されます。

エージェントがファイルの編集を提案した場合は、チャットウィンドウで内容を確認できます。選択した「Mode 」によっては、エージェントが編集を適用できるように許可する必要がある場合があります。

代表的なワークフロー

ACP Client は、幅広いタスクに使用できます。ここでは、導入の参考となるワークフローの例をいくつか紹介します。

説明と探索

1. 任意のソースファイルを開きます。
2. 誤って編集してしまうのを防ぐため、Mode をPlan Mode に設定します。
3. 「このクラスが何を実行するのかを詳しく説明し、潜在的な問題を特定してください」と尋ねます。
4. チャット履歴でエージェントの分析結果を確認します。

レビューを伴うリファクタリング

1. 変更したいコードを選択します。
2. Mode をDefault に設定します。
3. 質問：「選択したコードを、processInput という名前の別の関数に抽出してください。」
4. 提案された変更内容を確認します。

ビルドと修正

1. 「ACP Client 」と「MCP Server 」の両方の拡張機能が有効になっていることを確認してください。
2. Mode をAccept Edits に設定します。
3. 「プロジェクトをビルドし、コンパイラエラーを修正してください」と指示します。
4. エージェントは MCP サーバーを介してビルドをトリガーし、出力を読み取り、修正を適用します。チャット履歴で進行状況を確認してください。