GitLab Duo CLIの使用

GitLab Duo CLIは2つのモードで使用できます:

• インタラクティブモード: GitLab UIまたはエディタ拡張機能内のGitLab Duo Chatと同様のチャットエクスペリエンスを提供します。ビルドモードとプランモードをサポートします。
• ヘッドレスモード: Runner、スクリプト、その他の自動化されたワークフローで非インタラクティブに使用できます。

前提条件

• GitLab Duo CLIがインストールされ、セットアップされていること。
• デフォルトのGitLab Duoネームスペースが設定されているか、GitLab Duoにアクセスできるオープンなプロジェクト。

インタラクティブモード

GitLab Duo CLIをインタラクティブモードで使用するには:

1. セットアップに応じて、インタラクティブモードを開始するコマンドを入力します:

   glab

   shell

   glab duo cli

   duo

   shell

   duo

2. ターミナルウィンドウにプロンプト>が表示されます。プロンプトの後に質問またはリクエストを入力し、Enterを押します。

   例:

   What is this repository about?
   
   Which issues need my attention?
   
   Help me implement issue 15.
   
   The pipelines in MR 23 are failing. Please help me fix them.

GitLab Duo CLIの処理中にレスポンスをキャンセルするには、Escapeを押します。GitLab Duo CLIは現在の操作を停止し、プロンプトに戻ります。

プロンプトの履歴を表示するには↑キーを使用します。履歴を検索するにはControl+Rを使用します。

ビルドモードとプランモードを切り替える

インタラクティブモードでは、作業中にGitLab Duo CLIを次の2つのモードに切り替えることができます:

たとえば、最初にプランモードでGitLab Duoと問題について検討します。準備ができたらビルドモードに切り替え、プランを実装するようにGitLab Duoに指示します。

GitLab Duo CLIでは、現在のモードが>プロンプトの下に表示します。モードを切り替えるには、Tabを押します。

スラッシュコマンド

インタラクティブモードでは、スラッシュコマンドを使用してGitLab Duo CLIを設定したり、アクションを実行したりできます。プロンプトにスラッシュコマンドを入力し、Enterを押します。

次のスラッシュコマンドを使用できます:

独自のスラッシュコマンドを作成することもできます。詳細については、カスタムスラッシュコマンドを参照してください。

設定

設定を変更するには:

1. インタラクティブモードで/settingsと入力し、Enterを押します。
2. 矢印キーを使用して、設定のリスト内を移動します。
3. 選択した設定を変更するには、EnterまたはSpaceを押します。
4. パネルを閉じるには、Escapeを押します。

変更内容はセッション間で保持されます。

次の設定を使用できます:

システム通知

ターミナルウィンドウがフォーカスされていないときにセッションでユーザーの確認や対応が必要になると（たとえば、タスクが完了した場合や、ツールの承認が必要な場合）、GitLab Duo CLIはシステム通知を送信できます。

通知は、設定パネルにある通知設定によって制御されます:

• auto（デフォルト）: ターミナルがフォーカスされていない場合に、システム通知を送信します。
• disabled: システム通知を送信しません。

ツールの承認

GitLab Duoがツールを使用する必要がある場合、使用を開始する前に承認を求めるプロンプトが表示されます。たとえば、ファイルを読み取る場合やコマンドを実行する場合などです。

次のオプションがあります:

• 承認: GitLab Duoはツールを1回使用できます。
• セッションで承認: GitLab Duoは、セッションの残りの期間、指定された引数でツールを使用できます。別の引数を使用する場合は、追加の承認が必要です。
• 拒否: GitLab Duoはツールを使用できません。

ヘッドレスモード

非インタラクティブモードでワークフローを実行するには、セットアップに応じたコマンドを使用します:

glab duo cli run --goal "Your goal or prompt here"

glab duo cli run --goal "Fix these errors: $eslint_output"

duo run --goal "Your goal or prompt here"

duo run --goal "Fix these errors: $eslint_output"

ヘッドレスモードを使用すると、GitLab Duo CLIは次のように動作します:

• 手動によるツール承認をバイパスし、すべてのツールの使用を自動的に承認します。
• 以前の会話からのコンテキストを保持しません。runコマンドを実行するたびに、新しいワークフローが開始されます。

モデルを選択する

インタラクティブモードまたはヘッドレスモードで使用するモデルを選択できます。

インタラクティブモードの場合

選択したモデルはセッション間で保持され、コンテキストを失うことなく、会話の途中でモデルを切り替えることができます。

前提条件:

• GitLab Duo CLI 8.76.0以降。

インタラクティブモードでモデルを選択するには:

1. インタラクティブモードで/modelと入力し、Enterを押します。
2. 矢印キーを使用して利用可能なモデルのリストをスクロールするか、モデル名を入力してリストを絞り込みます。
3. モデルを選択し、Enterを押してそのモデルに切り替えます。

ヘッドレスモードの場合

選択したモデルはセッション間で保持されません。

前提条件:

• GitLab Duo CLI 8.68.0以降。

ヘッドレスモードでモデルを選択するには:

1. モデルのgitlab_identifierを確認します。

2. GitLab Duo CLIを実行するときに、--modelオプションまたはGITLAB_DUO_MODEL環境変数をgitlab_identifierの値に設定します。

   glab

   --modelオプションを使用します:

   shell

   glab duo cli --model <gitlab_identifier_for_the_model>

   GITLAB_DUO_MODEL環境変数を使用します:

   shell

   GITLAB_DUO_MODEL=<gitlab_identifier_for_the_model> glab duo cli

   たとえば、GPT-5-Codex - OpenAIを使用するには:

   shell

   glab duo cli --model gpt_5_codex

   shell

   GITLAB_DUO_MODEL=gpt_5_codex glab duo cli

   duo

   --modelオプションを使用します:

   shell

   duo --model <gitlab_identifier_for_the_model>

   GITLAB_DUO_MODEL環境変数を使用します:

   shell

   GITLAB_DUO_MODEL=<gitlab_identifier_for_the_model> duo

   たとえば、GPT-5-Codex - OpenAIを使用するには:

   shell

   duo --model gpt_5_codex

   shell

   GITLAB_DUO_MODEL=gpt_5_codex duo

セッションを切り替える

GitLab Duo Chatセッションには、会話履歴とワークフローのデータが保存されます。セッションは、GitLab Duo CLI、GitLab UI、およびエディタ拡張機能で共有されます。

たとえば、ブラウザで会話を開始し、ターミナルでその会話を続けることができます。

セッションを参照して切り替えるには:

1. インタラクティブモードで/sessionsと入力し、Enterを押します。
2. 矢印キーを使用して利用可能なセッションのリストをスクロールするか、テキストを入力してリストを絞り込みます。
3. セッションを選択し、Enterを押します。

ヘッドレスモードでセッションを切り替えるには、--existing-session-idオプションを使用します。

Model Context Protocol（MCP）接続

GitLab Duo CLIをローカルまたはリモートのMCPサーバーに接続するには、GitLab IDE拡張機能と同じMCP設定を使用します。手順については、MCPサーバーを設定するを参照してください。

関連トピック

• GitLab Duo CLI完全参照
• エディタ拡張機能のセキュリティに関する考慮事項
• GitLab CLI
• GitLab Duo Agent Platformをカスタマイズする
• GitLab Duo Agent Platformセッション

トラブルシューティング

GitLab Duo CLIを使用する際、次の問題に遭遇する可能性があります。

証明書エラー

証明書エラーが発生する可能性があります:

Error: unable to verify the first certificate
Error: self-signed certificate in certificate chain

これらのエラーは、組織がHTTPS傍受プロキシなどでカスタム認証局（CA）を使用している場合に発生します。

証明書エラーを解決するには、次のいずれかの方法を使用します:

• システム証明書ストアを使用する（推奨）:

  1. CA証明書がオペレーティングシステムの証明書ストアにインストールされている場合は、それを使用するようにNode.jsを設定します。これにはNode.js 22.15.0、23.9.0、または24.0.0以降が必要です。

  2. GitLab Duo CLIをコンテナ内で実行する場合は、ホストシステムのストアではなく、コンテナのシステムストアにCA証明書をインストールします。

     shell

     export NODE_OPTIONS="--use-system-ca"

• CA証明書ファイルを指定する:

  1. 古いバージョンのNode.jsを使用している場合、またはCA証明書がシステムストアにない場合は、Node.jsに証明書ファイルを直接指定します。ファイルはPEM形式である必要があります。

  2. GitLab Duo CLIをコンテナで実行する場合は、コンテナ内の場所を指すパスを設定します。証明書ファイルを提供するには、ボリュームマウントを使用します。

     shell

     export NODE_EXTRA_CA_CERTS=/path/to/custom-ca.pem

証明書エラーを無視する

証明書エラーが引き続き発生する場合は、証明書の検証を無効にできます。

証明書エラーは潜在的なセキュリティ漏洩を警告するため、検証の無効化が安全であると確信できる場合にのみ、証明書の検証を無効にしてください。

前提条件:

• ブラウザで証明書チェーンを検証した、または管理者がこのエラーを無視しても安全であることを確認した。

証明書の検証を無効にするには:

export NODE_TLS_REJECT_UNAUTHORIZED=0