Clineはループです。変更を計画し、ファイルを編集し、コマンドを実行し、出力を読み取り、次に何をすべきかを決定します。では、なぜあなたのAPIテストはそのループに含まれないのでしょうか？それらはApidogのGUIの背後にあり、誰かがクリックするのを待っています。あなたのエージェントはそれらに触れることはありません。
解決策は、1つの設定ブロックです。Apidog CLIは、Apidogで作成したテストシナリオをターミナルから直接実行するnpmパッケージ `apidog-cli` です。CLIがインストールされ、Clineがそれを認識すると、あなたのエージェントはApidogシナリオをユニットテストと同じように実行します。コマンドを実行し、終了コードを読み取り、赤（失敗）が返ってきたらコードを修正します。
まだCLIをインストールしていない場合は、まずそれを行ってください。AIコーディングエージェントでApidog CLIをインストールする方法では、Clineが入力を行うnpmインストール、認証、および初回実行について解説しています。この記事では、`apidog --version`がバージョン番号を出力し、Apidogアカウントが認証されていることを前提としています。
この記事で説明するClineについて
Clineは、VS Code拡張機能として動作するオープンソースの自律型コーディングエージェントです（JetBrainsビルドとCLI版もあります）。リポジトリを読み込み、プランモードで計画を立て、その後アクティブモードに切り替えてファイルを編集し、シェルコマンドを実行し、自動承認設定に基づいて承認を求めます。これはホストされたチャットボットではありません。モデルはあなたのマシン上のコードベースに対して実行されます。VS CodeでClineパネルを開いており、作業中に差分とターミナル出力が表示されている場合、あなたは正しい場所にいます。Clineの使い方では、そのインストールとモデル選択の基本について説明しています。
この違いは重要です。なぜなら、Clineにはプロジェクトルールを学習する独自の方法があり、そのメカニズムによって、一時的な「テストを実行する」という指示が、Clineが自ら実行しようとするものに変わるからです。そのメカニズムが`.clinerules/`ディレクトリです。
ステップ1：チャットのリマインダーではなく、ルールを.clinerulesに追加する
Clineは、タスクを開始する前にワークスペースルートにある`.clinerules/`ディレクトリからプロジェクトルールを読み込みます。そのフォルダ内のすべての`.md`および`.txt`ファイルを読み取り、それらをセッション中に適用する指示セットに統合します。もし希望するなら単一の`.clinerules`ファイルを使用することもできますが、ルールが増えるにつれてディレクトリの方がより拡張性が高くなります。これはClineルールリファレンスに記載されています。
リポジトリのルートに、次のような短いブロックを持つ`.clinerules/apidog.md`というファイルを作成します。
# ApidogによるAPIテスト
- APIをテストするには、curlやアドホックスクリプトではなく、Apidog CLIを実行してください。
- コマンド: apidog run -t <scenario_id> -e <env_id> -r cli
- シナリオIDと環境IDはApidogのCI/CDタブから取得します。それらの正確な値を使用してください。
- 終了コード0はすべてのアサーションが成功したことを意味します。0以外は失敗を意味します。終了コードが真実であり、あなたの要約ではありません。
- マシンは`apidog login`ですでに認証されています。`--access-token`を追加したり、このファイルにトークンを置いたりしないでください。
- 不明なフラグがある場合は、`apidog run --help`を実行し、そこにある正確なフラグを使用してください。
これが、CLIをチャットで言及するのではなく、`.clinerules/`に書き込む理由です。Clineメッセージに入力されたシナリオIDは、タスクが終了すると消えてしまいます。`.clinerules/apidog.md`にあるものは、リポジトリをチェックアウトするすべてのチームメイトと、今後すべてのClineタスクのために存在します。ファイルはバージョン管理されているため、ルールはコードとともに伝わります。
ステップ2：Apidogからコマンドを取得する
推測したものではなく、実際の`apidog run`コマンドが必要です。Apidogでテストシナリオを開き、そのCI/CDタブに移動して、生成されたコマンドをコピーします。それは次のようになります。
apidog run -t 8291 -e 42 -r cli
`-t`の値はテストシナリオIDで、`-e`は環境IDです。これらは`.clinerules/apidog.md`に記述すべき正確な値です。Clineが常に正しいIDを持つように、これらをルールブロックに貼り付けてください。すべてのフラグセットについては、apidog runコマンドリファレンスを参照してください。
ステップ3：Clineにテストを実行させる
ルールが設定されたら、Clineパネルでタスクを開始します。Clineは開始時に`.clinerules/`を読み込むため、CLIが存在することをすでに知っています。APIに影響する変更を行うか、単にチェックを実行するよう依頼してください。
Apidogのテストシナリオを実行して、結果を教えてください。
Clineはステップを計画し、その後アクティブモードに切り替えて、あなたのルールから`apidog run`コマンドを発行します。最初にどれだけ尋ねるかは、あなたの承認設定によって異なります。Clineは各コマンドを評価し、安全であるか、承認が必要であるかをマークします。ステージングに対する読み取り専用のテストシナリオは、安全と見なされるコマンドの一種です。自動承認設定で安全なコマンドの実行が許可されている場合、`apidog run`はプロンプトなしで実行されます。そうでない場合、Clineは一時停止して尋ねてきます。承認し、今後も自動でシナリオを実行させたい場合は、execute-safe-commandsの自動承認をオンにしてください。`-r cli`レポーターは、各リクエストとアサーションの発生をターミナルで確認できる、ステップバイステップの結果と要約を直接出力します。
ステップ4：Cline内でレポートを読む
実行が赤（失敗）になった場合、レポートが答えを持っています。`-r cli`を使用すると、Clineはターミナル出力パネルで読みやすい内訳を取得します。各リクエスト、各アサーション、そしてどのリクエストが失敗したか、期待値と実際値が示されます。失敗したアサーションは、正確なフィールド名またはステータスコードを示し、これは通常、Clineが次のパスで修正を見つけるのに十分です。
ブラウザで開いたり、チームメイトに渡したりできるレポートの場合、HTMLレポーターを追加します。
apidog run -t 8291 -e 42 -r cli,html
`html`レポーターは自己完結型のファイルを`./apidog-reports`に書き込みます。Clineが次のステップを決定するために読み取るインライン出力を引き続き取得できるよう、リストに`cli`を残してください。JUnit形式のCIダッシュボードが解析するすべてのフラグとレポーターについては、Apidog CLI完全ガイドとApidog CLIテストレポートガイドを参照してください。
Clineのループ内でのテスト
その成果は、あなたが指示するのをやめても、`.clinerules/`が指示したからといってClineが自力でシナリオを実行するようになることにあります。
Clineがチェックアウト応答を構築するハンドラを編集している状況を想像してみてください。そのループは変化します。コードを編集し、その後、成功を宣言する代わりに、ステージングに対してApidogシナリオを実行し、終了コードを読み取り、それに基づいて行動します。緑（成功）なら次に進み、赤（失敗）ならレポートを開き、どのアサーションが失敗したか（ステータスコード、不足しているフィールド、間違った値）を読み取り、修正を試み、再実行します。APIテストは、Clineがすでにユニットテストを実行しているのと同じ編集-テスト-修正ループの一部となります。あなたは1つの指示を書いただけで、Clineはそのコマンドを既存の動作に組み込んだのです。
これは、あらゆるエージェントワークフローを安全にする「委任して検証する」モデルです。Clineはコマンドを実行し結果を読み取ります。あなたはApidogで視覚的にシナリオを作成し続け、エージェントが終了コードを正確に読み取っていることをスポットチェックします。より広範なパターンについては、APIテストにAIエージェントを使用する方法とApidog AIテストハーネスを参照してください。
Clineが実際にCLIを実行していることを確認する
エージェントは、実際には達成していない成功を報告することがあり、Clineも例外ではありません。問題を検出する頻度が高い順に3つのチェックがあります。
まず、コマンドが実際に実行されたことを確認してください。Clineは、実行したコマンドとその出力をタスクビューにインラインで表示します。文字通りの`apidog run ...`という行とその下の結果を探してください。Clineがテストを実行したと言っているのにコマンドが表示されない場合、それは実際には実行しなかったことを要約しています。再度実行するよう依頼し、生出力を見せてください。
次に、重要な終了コードを確認します。
そのapidog runコマンドの終了コードは何でしたか？
`apidog run`は、すべてのアサーションが成功した場合に`0`で終了し、何らかの失敗があった場合に非ゼロで終了します。この単一の動作により、Clineまたはパイプラインは実行をクリーンなゲートとして扱うことができます。Clineの文章が「テストに合格した」と述べているにもかかわらず終了コードが非ゼロである場合、終了コードが正しいです。
第三に、実際のシナリオを使用したことを確認してください。「scenario not found」というエラーで実行が失敗した場合、ClineがIDを作成したか、誤って記憶している可能性があります。`.clinerules/apidog.md`の`-t`と`-e`の値、およびApidogがCI/CDタブで生成したコマンドを再確認してください。ルールファイル内のIDが真実です。
オプション：Apidog MCPサーバーを接続する
`.clinerules/`から`apidog run`を実行するだけで、ほとんどのニーズに対応できます。しかし、さらに進んだ方法もあります。
Clineはモデルコンテキストプロトコル（MCP）をファーストクラスでサポートしています。VS Code拡張機能で、ClineパネルのMCPサーバーアイコンをクリックし、「Configure」を開き、「Configure MCP Servers」をクリックして`cline_mcp_settings.json`を開きます。`mcpServers`オブジェクトの下にあなたのサーバーを追加してください。Cline MCPドキュメントに記載されているように、JSONを手動で編集することなく、Cline内でMCPマーケットプレイスを閲覧してサーバーをインストールすることもできます。Apidog MCPサーバーは、MCPを介してあなたのAPI仕様を公開するため、Clineはコードを記述する際（事後ではなく）にスキーマを読み取ることができます。CLIはテストを実行し、MCPはエージェントに仕様を供給します。
Clineは対話型拡張機能であるため、ヘッドレスランナーが提供するような非対話型テストモードは組み込まれていません。Clineが存在しないパイプラインで`apidog run`を実行するには、GitHub ActionsでのApidog CLIがシークレット、レポーター、終了コードによるゲーティングについて説明し、Apidog CLI CI/CDパイプラインガイドがより広範な設定について説明しています。
Clineが間違った場合
セットアップ中にいくつかの失敗がよく発生します。
ルールファイルを無視する。Clineが一般的なコマンドを実行したり、まったくコマンドを実行しなかったりする場合、ルールがロードされていない可能性があります。フォルダ名が正確に`.clinerules`であり、ワークスペースのルートにあり、その中のファイルが`.md`または`.txt`で終わっていることを確認してください。新しいタスクを開始すると、Clineは強制的にルールを再ロードします。
アクセストークンを渡してしまう。Clineが`--access-token`を追加しようとする場合、それは公開されている例から推測しています。マシンは`apidog login`で認証されているため、ルールはすでにそれをしないように指示しています。その行を強調し、実際のトークンを`.clinerules/`に入れないでください。認証が実際にどのように機能するかについては、Apidog CLI認証ガイドを参照してください。
フラグをでっち上げる。「不明なオプション」エラーは、Clineがあなたのバージョンには存在しないフラグを推測したことを意味します。`apidog run --help`を実行し、そこから正確なフラグをコピーするよう伝えてください。これはインストールされているバージョンに対して常に正しいものです。
失敗した実行を合格と報告する。これは最も費用のかかる問題であり、終了コードのルールが`.clinerules/`ファイルと検証ステップの両方にある理由です。要約と終了コードが一致しない場合、終了コードが優先されます。
日常的なエージェントからテストされたループへ
これがセットアップです。インストールガイドに従って`apidog-cli`を一度インストールし、リポジトリの`.clinerules/`ディレクトリに短いApidogルールを追加すると、Clineはコード編集にすでに使用しているのと同じループ内でAPIテストを実行し、その結果を読み取る方法を認識します。壊れたエンドポイントは、変更がリリースされた後ではなく、Clineがまだその変更に取り組んでいる間に捕捉されます。
GUIの背後にあるテストは人間がクリックしたときに実行されますが、1行のコマンドはClineが決定したときにいつでも実行されます。あなたはApidogで視覚的にシナリオを構築し続け、あなたのエージェントはあなたが監視していない場所でそれらを実行します。Apidogをダウンロードし、1つのシナリオを構築し、その`apidog run`コマンドを`.clinerules/apidog.md`にドロップして、次の変更でClineがそれを拾うのを見てください。