# エージェンティックデバッグ

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

CLion は、統合 MCP サーバーを通じて外部 AI エージェントにデバッガーを Exposed します。 デバッガーツールが接続されていると、Claude、Codex、Junie などのエージェントが CLion のデバッグセッションを自律的に操作できます。開始・停止、ブレークポイント管理、ステップ実行、スレッドや変数の検査、式の評価が可能です。

コードを自分でステップ実行する代わりに、問題内容を自然言語で記述し、エージェントにランタイム証拠を収集させます。 実行時の値、ブランチの判断、呼び出し順序、スレッドコンテキスト、プログラムが特定の行を実行することがあるかどうかなど、ソースコードやログからは確実に把握できない事実が必要な場合に役立ちます。

> **Note:**
> [デバッガーツール](mcp-server.html#debugger-toolset)は CLion 2026.1.3 以降で使用できます。 [ルーターモード](#router-mode)は CLion 2026.2 以降で使用できます。

Procedure: Debugger MCP ツールセットプラグインを有効化する

この機能は、Debugger MCP ツールセットプラグインに依存しており、CLion ではデフォルトでバンドルおよび有効化されています。 関連機能が利用できない場合は、プラグインを無効化していないことを確認してください。

1. `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) を押して設定を開き、  `プラグイン`  を選択します。

2. デバッガー MCP ツールセット  プラグインを見つけて、   有効化   をクリックします。

## デバッガーがエージェントに到達する方法

CLion はエージェントにデバッガー関数を2つの方法で提供します：

共有 MCP サーバー
: デバッガーツールは、MCP サーバー上で解析、フォーマット、他の IDE ツールとともに提供されます。 その説明は、デバッグしていないときも常にエージェントコンテキストの一部です。 デバッガーツールには  `xdebug_` が接頭辞として付きます。 このオプションは CLion 2026.1.3 以降で利用できます。

ルーターモード
: MCP サーバーは、  `execute_tool` という汎用ツールと  `clion-debugger` スキルを Exposed します。 コマンド、パラメーター、デバッグシナリオはスキルにあり、エージェントはデバッガーが必要になったときだけそれらをロードします。 デバッガーの説明はそれまでエージェントコンテキスト外にあるため、ルーターモードはトークン消費を抑えます。 ルーターモードは GDB、LLDB、DAP ベースのデバッガーと連携し、Claude Code や Codex などのエージェントで利用されます。 このオプションは CLion 2026.2 以降で利用できます。

## エージェントをデバッガーに接続する

デバッガーツールは CLion MCP サーバー上で提供されているため、サーバーが有効化されるとクライアントはすぐアクセスできます。

Procedure:

1. MCP サーバーを有効化し、 [MCP サーバー](mcp-server.html)に記載されている通りにクライアントをセットアップしてください。

2. クライアントを再起動すると、CLion ツール、とくに  `xdebug_` が接頭辞のデバッガーツールを使用できるようになります。

[MCP サーバー](mcp-server.html)設定で Exposed ツールを確認し、個別のツールをオンまたはオフにできます。

## ルーターモードを有効にする

ルーターモードでは、CLion はデバッガーコマンド説明をエージェントが必要とするまでエージェントコンテキスト外に保持します。 MCP サーバーは  `execute_tool` という汎用ツールを Exposed し、エージェントは必要な時に  `clion-debugger` スキルをロードします。 ルーターモードは、常に有効なツール説明が、エージェントがタスクに使えるコンテキストを占有してしまう長いセッションに適しています。

Procedure:

1. メインメニューで  `設定 | AI | MCP サーバー | Exposed ツール`  へ移動します。

2. ルーター専用モードを有効にする   チェックボックスを選択します。 デバッガーツールは  `execute_tool` 経由で引き続き利用でき、  `clion-debugger` スキルが使用タイミングをエージェントに伝えます。 ルーターモードをオフにするには、チェックボックスをオフにします。

![CLion の MCP サーバー Exposed Tools 設定で、デバッガーツールの「有効」と「ルーターのみ」チェックボックスが選択されている様子。](https://resources.jetbrains.com/help/img/idea/2026.3/cl_agentic_debugging_tools.png)

## デバッガースキルをインストールする。 

外部クライアントが IDE のデバッガーツールを使う方法を改善するために、そのクライアント向けの特定のスキルをインストールできます。 このスキルは IDE にバンドルされており、デバッガーツールをいつ適用するかを外部クライアントに案内します。

外部クライアント用にスキルをインストールするには:

Procedure:

1. `設定 | AI | スキル`  に進みます。

2. バンドルされたスキル   セクションに移動し、  `clion-debugger`  スキルを見つけます。 デフォルトで有効になっていますが、IDE 内のエージェントでのみ使用できます。

![clion-debugger スキル](https://resources.jetbrains.com/help/img/idea/2026.3/cl_bundled_skills_debugger.png)

3. IDE 外の Claude Code または Codex でこのスキルを使用するには、それらのクライアント用に明示的にインストールする必要があります。 これを行うには、 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.chevronDownLarge.svg) をクリックし、使用するクライアントに応じて   Claude Agent (グローバル)   または   Codex (グローバル)   を選択します。

![外部クライアント用に clion-debugger スキルをインストールする](https://resources.jetbrains.com/help/img/idea/2026.3/cl_installing_debugger_skill.png)

選択したターゲットに応じて、スキルは次のフォルダーにインストールされます:

* Claude Code : Windows: `%USERPROFILE%\.claude\skills\clion-debugger\` macOS: `~/.claude/skills/clion-debugger/` Linux: `~/.claude/skills/clion-debugger/`

* Codex : Windows: `%USERPROFILE%\.codex\skills\clion-debugger\` macOS: `~/.codex/skills/clion-debugger/` Linux: `~/.codex/skills/clion-debugger/`

外部クライアントでスキルを呼び出すには、  `/clion-debugger`  を使用するか、関連する場合に自動的に有効になるようにします。

## エージェントが可能なこと

デバッガーツールを使うことで、エージェントは手作業で行うのと同じランタイム調査を実行します：

* 実行構成やソース場所に対してデバッグセッションを開始し、実行中のセッションのステータスを確認します（ `xdebug_start_debugger_session` 、 `xdebug_get_debugger_status` ）。

* ブレークポイントの一覧、設定、削除、特定の行までの実行を行います（ `xdebug_list_breakpoints` 、 `xdebug_set_breakpoint` 、 `xdebug_remove_breakpoint` 、 `xdebug_run_to_line` ）。

* ステップ実行、再開、一時停止、セッションの停止で実行を制御します（ `xdebug_control_session` ）。

* ローカル変数、フレーム値、ネストされたフィールドを読み取り、式の評価や変更を行います（ `xdebug_get_frame_values` 、 `xdebug_get_value_by_path` 、 `xdebug_evaluate_expression` 、 `xdebug_set_variable` ）。

* スレッドとそのコールスタックを検査します（ `xdebug_get_threads` 、 `xdebug_get_stack` ）。

* 一時停止中のネイティブセッションの CPU レジスター、メモリ、および機械語命令を読み取ります ( `xdebug_get_registers` 、 `xdebug_read_memory` 、 `xdebug_disassemble` )。

* 一時停止中の組み込みセッションの ARM Cortex-M フォールトステータスレジスターをデコードします ( `xdebug_get_fault_status` )。 詳細については、 [ARM Cortex-M ハードフォールトをデバッグする](#hardfault)を参照してください。

## エージェントでコードをデバッグする

プロジェクトを開いた後、問題内容をエージェントに説明し、コードのデバッグを依頼します。 例：

```TEXT
The cart total is far too low. Start a debug session,
set a breakpoint in line_total(), and find out why the
discount is applied incorrectly.
        
```

エージェントは必要なブレークポイントを設定し、デバッグセッションを開始して、プログラムが一時停止するのを待ちます。 実行が停止すると、コールスタック、ローカル変数、仮説を検証するために必要な式を読み取り、その結果を報告します。

![CLion が line_total() のブレークポイントで一時停止中で、Debug ツールウィンドウにはコールスタック、gross 変数と net 変数の値が表示されている](https://resources.jetbrains.com/help/img/idea/2026.3/cl_agentic_debugging.png)

エージェントは標準のCLion デバッガーを操作するため、   デバッグ  ツールウィンドウでセッションを追跡し、いつでも操作を引き継げます。

## ARM Cortex-M ハードフォールトをデバッグする

ハードフォールトは ARM Cortex-M CPU の例外で、低レベルで操作が失敗したとき、たとえばプログラムが無効なメモリアドレスにアクセスしたときにプロセッサーが発生させます。 フォールトハンドラーはスタックされたレジスターとフォールトステータスレジスターを取得しますが、それらをデコードせずに実行を停止するため、プロセッサーはフォールトが発生したことだけを報告し、理由は報告しません。

バンドルされている  `clion-embedded-hardfault`  スキルは、その停止を調査に変えます。 CLion はフォールトデータをデコードしてエージェントに渡し、エージェントはフォールトを起こした命令をソースコードまでトレースして、フォールトの原因を報告します。

> **Note:**
> ハードフォールトデバッグは CLion 2026.2.2 以降で使用できます。

### エージェントが受け取るもの

生のレジスターダンプの代わりに、CLion はエージェントに次の根拠データを提供します:

* 報告されるフォールト条件にデコードされたフォールトステータスレジスター。

* フォールトの瞬間にハードウェアがスタックした例外フレーム。実行中のプログラムによって上書きされる前に読み取られます。

* フォールトを起こしたメモリマップドアクセスの背後にあるペリフェラルレジスター。デバイスの [SVD 記述](peripheral-view.html#periph-tab)からデコードされます。

* フォールトを起こしたアドレスとその周辺メモリの逆アセンブル。

CLion は、メモリマップ、レジスター、命令エンコーディングの独自モデルからこのデータを構築するため、エージェントはプログラム出力から再構築するのではなく、フォールトを起こしたアドレスから開始します。 このデータはデバッガーから取得されるため、スキルはハードウェアベンダーに依存しません。ST-LINK、Segger J-Link、Lauterbach TRACE32 など、オンチップデバッグに使用する任意のツールで動作します。

### ハードフォールトの原因を見つける

スキルはデバッガーツール上で動作するため、まず [エージェントをデバッガーに接続する](#connect-agent)の説明に従って MCP サーバーを有効にします。 スキル自体は、  `設定 | AI | スキル`  の   バンドルされたスキル   セクションでデフォルトで有効になっています。 IDE 外のクライアントで使用するには、 [デバッガースキルをインストールする](#install-skill)の説明に従ってインストールします。

Procedure:

1. ターゲットをオンチップでデバッグし、フォールトハンドラーで停止するまでプログラムを実行します。

2. 問題を自然言語でエージェントに説明します。例:

```TEXT
This firmware hard faults from time to time, probably on an
invalid memory access. Find the cause and tell me how to fix it.
                    
```

セッションが  `HardFault_Handler` 、  `MemManage_Handler` 、  `BusFault_Handler` 、または  `UsageFault_Handler`  で停止した場合、またはプロンプトで CFSR、HFSR、MMFAR、BFAR レジスターや例外スタックフレームに言及している場合、エージェントは自動的にスキルを適用します。 エージェントがスキルを見落とす場合は、プロンプトでスキル名を指定してタスクを明確にします:

```TEXT
Use the clion-embedded-hardfault skill to find the cause of this fault.
                    
```

3. エージェントはデコードされたフォールトデータを読み取り、メモリと逆アセンブルを調査し、フォールトを起こした命令をソースコードまでトレースします。 その後、バグの場所と修復方法を報告します。

4. 修正を自分で適用するか、エージェントに適用させてデバッグセッションを再実行し、結果を確認します。

## 制限

* ブレークポイントエラーやロギングブレークポイントの出力は、JVM ベースのデバッガーのみで報告されます。 C および C++ デバッガーでは、ロギングブレークポイントを設定してもこれらのイベントストリームが空のままになる場合があります。

* デバッグセッション中の `constexpr` 式の評価は、デバッガーツール経由ではまだサポートされていません。

* [ハードフォールトデバッグスキル](#hardfault)は、Claude Code と Codex のどちらでも、 AI チャット ツールウィンドウ内と CLI モードの両方で動作します。 GitHub Copilot では、CLI モードでのみ動作します。

