glab duo cli

   duo

1. 터미널 창에 프롬프트 >가 나타납니다. 프롬프트 뒤에 질문이나 요청을 입력하고 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를 다음 두 모드로 전환할 수 있습니다:

예를 들어 플랜 모드에서 GitLab Duo와 문제를 논의하며 시작한 다음, 준비가 되면 빌드 모드로 전환해 GitLab Duo에 계획을 구현하도록 지시할 수 있습니다.

GitLab Duo CLI는 > 프롬프트 아래에 현재 모드를 표시합니다. 모드를 전환하려면 Tab을 누릅니다.

슬래시 명령어#

인터랙티브 모드에서는 슬래시 명령어로 GitLab Duo CLI를 구성하고 작업을 수행합니다. 프롬프트에 슬래시 명령어를 입력하고 Enter를 누릅니다.

사용할 수 있는 슬래시 명령어는 다음과 같습니다:

슬래시 명령어를 직접 만들 수도 있습니다. 자세한 내용은 사용자 정의 슬래시 명령어를 참고합니다.

설정#

설정을 변경하려면 다음과 같이 합니다:

1. 인터랙티브 모드에서 /settings를 입력하고 Enter를 누릅니다.
2. 화살표 키로 설정 목록을 이동합니다.
3. 선택한 설정을 변경하려면 Enter 또는 Space를 누릅니다.
4. 패널을 닫으려면 Escape를 누릅니다.

변경 사항은 세션이 바뀌어도 유지됩니다.

사용할 수 있는 설정은 다음과 같습니다:

시스템 알림#

GitLab Duo CLI는 터미널 창에 포커스가 없는 동안 세션에 사용자의 확인이 필요할 때 (예: 작업을 마쳤거나 도구 승인이 필요할 때) 시스템 알림을 보낼 수 있습니다.

알림은 설정 패널의 Notifications 설정으로 제어합니다:

• auto(기본값): 터미널에 포커스가 없을 때 시스템 알림을 보냅니다.
• disabled: 시스템 알림을 보내지 않습니다.

도구 승인#

GitLab Duo는 도구를 사용해야 할 때 시작 전에 승인을 요청합니다. 예를 들어 파일을 읽거나 명령을 실행해야 할 때 요청합니다.

선택지는 다음과 같습니다:

• Approve: GitLab Duo가 해당 도구를 한 번 사용할 수 있습니다.
• Approve for session: GitLab Duo가 남은 세션 동안 같은 인수로 해당 도구를 사용할 수 있습니다. 인수가 다르면 다시 승인해야 합니다.
• Deny: 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 값으로 설정합니다.

   glabduo

--model 옵션을 사용합니다:

glab duo cli --model <gitlab_identifier_for_the_model>

GITLAB_DUO_MODEL 환경 변수를 사용합니다:

GITLAB_DUO_MODEL=<gitlab_identifier_for_the_model> glab duo cli

예를 들어 GPT-5-Codex - OpenAI를 사용하려면 다음과 같이 합니다:

glab duo cli --model gpt_5_codex

GITLAB_DUO_MODEL=gpt_5_codex glab duo cli

duo --model <gitlab_identifier_for_the_model>

GITLAB_DUO_MODEL=<gitlab_identifier_for_the_model> duo

duo --model gpt_5_codex

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를 가로채는 프록시 등에 사용자 지정 인증 기관(Certificate Authority, CA)을 사용할 때 발생합니다.

인증서 오류를 해결하려면 다음 방법 중 하나를 사용합니다:

• 시스템 인증서 저장소를 사용합니다(권장):

  1. CA 인증서가 운영 체제의 인증서 저장소에 설치되어 있다면 Node.js가 이를 사용하도록 구성합니다. Node.js 22.15.0, 23.9.0, 24.0.0 이상이 필요합니다.

  2. GitLab Duo CLI를 컨테이너에서 실행한다면 호스트 시스템 저장소가 아니라 컨테이너의 시스템 저장소에 CA 인증서를 설치합니다.

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

• CA 인증서 파일을 지정합니다:

  1. 이전 Node.js 버전이거나 CA 인증서가 시스템 저장소에 없다면 Node.js가 인증서 파일을 직접 가리키도록 합니다. 파일은 PEM 형식이어야 합니다.

  2. GitLab Duo CLI를 컨테이너에서 실행한다면 경로를 컨테이너 내부 위치로 설정합니다. 인증서 파일은 볼륨 마운트로 제공합니다.

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

인증서 오류 무시#

그래도 인증서 오류가 계속되면 인증서 검증을 비활성화할 수 있습니다.

인증서 오류는 잠재적인 보안 침해를 알리는 신호이므로, 비활성화해도 안전하다고 확신할 때만 인증서 검증을 비활성화합니다.

사전 요구 사항:

• 브라우저에서 인증서 체인을 확인했거나, 관리자가 이 오류를 무시해도 안전하다고 확인해야 합니다.

인증서 검증을 비활성화하려면 다음과 같이 합니다:

export NODE_TLS_REJECT_UNAUTHORIZED=0

   glab duo cli

   duo

1. 터미널 창에 프롬프트 >가 나타납니다. 프롬프트 뒤에 질문이나 요청을 입력하고 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를 다음 두 모드로 전환할 수 있습니다:

예를 들어 플랜 모드에서 GitLab Duo와 문제를 논의하며 시작한 다음, 준비가 되면 빌드 모드로 전환해 GitLab Duo에 계획을 구현하도록 지시할 수 있습니다.

GitLab Duo CLI는 > 프롬프트 아래에 현재 모드를 표시합니다. 모드를 전환하려면 Tab을 누릅니다.

슬래시 명령어#

인터랙티브 모드에서는 슬래시 명령어로 GitLab Duo CLI를 구성하고 작업을 수행합니다. 프롬프트에 슬래시 명령어를 입력하고 Enter를 누릅니다.

사용할 수 있는 슬래시 명령어는 다음과 같습니다:

슬래시 명령어를 직접 만들 수도 있습니다. 자세한 내용은 사용자 정의 슬래시 명령어를 참고합니다.

설정#

설정을 변경하려면 다음과 같이 합니다:

1. 인터랙티브 모드에서 /settings를 입력하고 Enter를 누릅니다.
2. 화살표 키로 설정 목록을 이동합니다.
3. 선택한 설정을 변경하려면 Enter 또는 Space를 누릅니다.
4. 패널을 닫으려면 Escape를 누릅니다.

변경 사항은 세션이 바뀌어도 유지됩니다.

사용할 수 있는 설정은 다음과 같습니다:

시스템 알림#

GitLab Duo CLI는 터미널 창에 포커스가 없는 동안 세션에 사용자의 확인이 필요할 때 (예: 작업을 마쳤거나 도구 승인이 필요할 때) 시스템 알림을 보낼 수 있습니다.

알림은 설정 패널의 Notifications 설정으로 제어합니다:

• auto(기본값): 터미널에 포커스가 없을 때 시스템 알림을 보냅니다.
• disabled: 시스템 알림을 보내지 않습니다.

도구 승인#

GitLab Duo는 도구를 사용해야 할 때 시작 전에 승인을 요청합니다. 예를 들어 파일을 읽거나 명령을 실행해야 할 때 요청합니다.

선택지는 다음과 같습니다:

• Approve: GitLab Duo가 해당 도구를 한 번 사용할 수 있습니다.
• Approve for session: GitLab Duo가 남은 세션 동안 같은 인수로 해당 도구를 사용할 수 있습니다. 인수가 다르면 다시 승인해야 합니다.
• Deny: 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 값으로 설정합니다.

   glabduo

--model 옵션을 사용합니다:

glab duo cli --model <gitlab_identifier_for_the_model>

GITLAB_DUO_MODEL 환경 변수를 사용합니다:

GITLAB_DUO_MODEL=<gitlab_identifier_for_the_model> glab duo cli

예를 들어 GPT-5-Codex - OpenAI를 사용하려면 다음과 같이 합니다:

glab duo cli --model gpt_5_codex

GITLAB_DUO_MODEL=gpt_5_codex glab duo cli

duo --model <gitlab_identifier_for_the_model>

GITLAB_DUO_MODEL=<gitlab_identifier_for_the_model> duo

duo --model gpt_5_codex

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를 가로채는 프록시 등에 사용자 지정 인증 기관(Certificate Authority, CA)을 사용할 때 발생합니다.

인증서 오류를 해결하려면 다음 방법 중 하나를 사용합니다:

• 시스템 인증서 저장소를 사용합니다(권장):

  1. CA 인증서가 운영 체제의 인증서 저장소에 설치되어 있다면 Node.js가 이를 사용하도록 구성합니다. Node.js 22.15.0, 23.9.0, 24.0.0 이상이 필요합니다.

  2. GitLab Duo CLI를 컨테이너에서 실행한다면 호스트 시스템 저장소가 아니라 컨테이너의 시스템 저장소에 CA 인증서를 설치합니다.

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

• CA 인증서 파일을 지정합니다:

  1. 이전 Node.js 버전이거나 CA 인증서가 시스템 저장소에 없다면 Node.js가 인증서 파일을 직접 가리키도록 합니다. 파일은 PEM 형식이어야 합니다.

  2. GitLab Duo CLI를 컨테이너에서 실행한다면 경로를 컨테이너 내부 위치로 설정합니다. 인증서 파일은 볼륨 마운트로 제공합니다.

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

인증서 오류 무시#

그래도 인증서 오류가 계속되면 인증서 검증을 비활성화할 수 있습니다.

인증서 오류는 잠재적인 보안 침해를 알리는 신호이므로, 비활성화해도 안전하다고 확신할 때만 인증서 검증을 비활성화합니다.

사전 요구 사항:

• 브라우저에서 인증서 체인을 확인했거나, 관리자가 이 오류를 무시해도 안전하다고 확인해야 합니다.

인증서 검증을 비활성화하려면 다음과 같이 합니다:

export NODE_TLS_REJECT_UNAUTHORIZED=0