InfoGrab DocsInfoGrab Docs

GitLab Duo CLI 사용

요약

GitLab Duo CLI는 두 가지 모드로 사용할 수 있습니다: GitLab Duo CLI를 인터랙티브 모드로 사용하려면 다음과 같이 합니다: 환경에 맞는 명령을 입력해 인터랙티브 모드를 시작합니다: 터미널 창에 프롬프트 >가 나타납니다.

GitLab Duo CLI는 두 가지 모드로 사용할 수 있습니다:

  • 인터랙티브 모드: GitLab UI 나 에디터 확장의 GitLab Duo Chat과 비슷한 채팅 환경을 제공합니다. 빌드 모드, 플랜 모드, 자동 모드를 지원합니다.
  • 헤드리스 모드: 러너, 스크립트를 비롯한 자동화 워크플로에서 비대화식으로 사용할 수 있습니다.

사전 요구 사항#

  • GitLab Duo CLI가 설치되어 있고 설정되어 있어야 합니다.
  • 기본 GitLab Duo 네임스페이스가 설정되어 있거나, GitLab Duo에 접근할 수 있는 프로젝트가 열려 있어야 합니다.

인터랙티브 모드#

GitLab Duo CLI를 인터랙티브 모드로 사용하려면 다음과 같이 합니다:

  1. 환경에 맞는 명령을 입력해 인터랙티브 모드를 시작합니다:

   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 CLI를 처음 실행하면 온보딩 카드가 MCP 서버 연결과 GitLab 마켓플레이스의 플러그인 설치를 도와줍니다.

카드에는 단계를 선택하고 실행하기 위한 탐색 안내가 표시됩니다. 완료한 단계에는 연결된 MCP 서버 수나 설치된 플러그인 수와 함께 체크 표시가 나타납니다.

카드는 두 단계를 모두 완료한 뒤에도 첫 프롬프트를 보낼 때까지 유지됩니다. 이후 실행에서는 다시 표시되지 않습니다.

환영 카드#

새 세션을 시작할 때마다 기본적으로 환영 카드가 표시됩니다. Show work items on session start 설정으로 이 카드를 끌 수 있습니다.

이 카드는 일반적인 작업을 시작하기 위한 프롬프트를 제안하고, 프롬프트를 탐색하고 실행하기 위한 탐색 안내를 표시합니다. 예를 들어 GitLab 프로젝트에서 작업하는 경우 제안되는 프롬프트는 열려 있는 머지 리퀘스트와 이슈를 바탕으로 만들어집니다. 그렇지 않으면 카드에 일반적인 예시가 표시됩니다.

본인의 머지 리퀘스트에 대한 프롬프트를 선택했고 해당 소스 브랜치가 존재하면, 프롬프트는 GitLab Duo에 먼저 그 브랜치를 체크아웃하도록 지시합니다.

Run suggested prompts as /goal sessions 설정이 활성화되어 있고 인스턴스가 GitLab 19.3 이상이면, 리뷰 피드백을 처리하는 프롬프트가 /goal 세션으로 실행됩니다.

시작 카드 숨기기#

시작 카드는 기본적으로 활성화되어 있습니다. 끄려면 --startup-cards를 false로 설정합니다:

glab duo cli --startup-cards false
duo --startup-cards false

또는 STARTUP_CARDS 환경 변수를 false로 설정합니다. 둘 다 설정하면 --startup-cards 옵션이 환경 변수보다 우선합니다.

상태 표시줄#

화면 하단에는 다음 정보가 표시되는 상태 표시줄이 있습니다:

모드 전환#

인터랙티브 모드에서는 작업 중에 GitLab Duo CLI를 여러 모드로 전환할 수 있습니다:

모드 권한 동작 방식
빌드 모드(기본값) 읽기·쓰기 GitLab Duo가 작업을 실행하고 프로젝트를 변경할 수 있습니다.
플랜 모드 읽기 전용 GitLab Duo가 변경 없이 프로젝트를 분석하고 계획을 만들 수 있습니다.
자동 모드 읽기·쓰기 GitLab Duo가 먼저 승인을 요청하지 않고 도구를 사용할 수 있습니다. 자세한 내용은 자동 모드를 참고합니다.

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

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

슬래시 명령어#

히스토리

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

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

명령어 설명
/compact 컨텍스트 공간을 절약하기 위해 대화 기록을 압축합니다.
/copy GitLab Duo의 마지막 응답을 클립보드에 복사합니다.
/doctor GitLab Duo CLI 환경의 진단 정보를 표시합니다.
/exit GitLab Duo CLI를 종료합니다.
/export 세션을 이식 가능한 JSON 번들로 내보냅니다.
/feedback 버그 리포트나 기능 요청을 제출합니다.
/goal 목표를 향해 진행하는 세션을 시작합니다. GitLab 19.3 이상이 필요합니다.
/help 사용할 수 있는 단축키, 모드, 슬래시 명령어를 표시합니다.
/mcp 구성된 MCP 서버와 그 상태를 봅니다.
/model 현재 세션의 AI 모델을 전환합니다.
/new 새 채팅 세션을 시작합니다.
/review 코드 리뷰 서브에이전트로 변경 사항을 리뷰합니다.
/sessions 세션을 탐색하고 검색하고 전환합니다.
/settings 설정 패널을 엽니다.
/skills 현재 프로젝트에서 사용할 수 있는 Agent Skills를 나열합니다.
/whatsnew GitLab Duo CLI의 최근 변경 사항을 표시합니다.

슬래시 명령어가 여는 패널이나 대화 상자를 닫으려면 Escape를 누릅니다.

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

설정#

인터랙티브 모드에서 /settings를 입력하면 설정을 보고 변경할 수 있습니다. 자세한 내용은 GitLab Duo CLI 설정을 참고합니다.

시스템 알림#

히스토리

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

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

도구 승인#

히스토리

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

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

Note

Approve for session 옵션을 사용하려면 관리자가 그룹이나 인스턴스에서 이 옵션을 켜야 합니다. 자세한 내용은 도구 승인을 참고합니다.

자동 모드#

히스토리
Feature flag

이 기능의 가용성은 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.

자동 모드에서 GitLab Duo는 승인을 요청하지 않고 도구를 사용할 수 있습니다. 설정이 허용하는 경우 GitLab Duo는 다음 작업을 수행할 수 있습니다:

자동 모드는 에이전트 도구 거버넌스를 재정의하지 않습니다. 최상위 그룹에 대해 로컬 액세스 도구 거버넌스가 켜져 있으면, Always deny로 설정된 도구는 실행되지 않으며 Always ask로 설정된 도구는 여전히 승인을 요청합니다. 자세한 내용은 GitLab Duo CLI의 자동 모드를 참고합니다.

Warning

GitLab Duo는 실수를 할 수 있습니다. 파일, 이슈, 머지 리퀘스트, 웹 페이지처럼 GitLab Duo가 읽는 모든 콘텐츠에는 프롬프트 인젝션에 사용되는 악의적인 지시가 포함되어 있을 수 있습니다. 위험을 줄이려면 다음을 따릅니다:

자세한 내용은 에디터 확장 보안 고려 사항을 참고합니다.

자동 모드 켜기#

Auto mode 설정은 기본적으로 꺼져 있습니다. 자동 모드를 사용하려면 먼저 인스턴스, 그룹 또는 프로젝트에서 켜야 합니다. 그룹은 인스턴스의 설정을 상속하고, 하위 그룹과 프로젝트는 상위 그룹의 설정을 상속합니다.

사전 요구 사항:

  • 관리자 액세스 권한이 있어야 합니다.

인스턴스에서 자동 모드를 켜려면 다음과 같이 합니다:

  1. 오른쪽 상단에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 GitLab Duo를 선택합니다.
  3. Change configuration을 선택합니다.
  4. Auto mode 드롭다운 목록에서 다음 옵션 중 하나를 선택합니다:
    • On by default: 자동 모드를 사용할 수 있습니다. 그룹과 하위 그룹이 끌 수 있습니다.
    • Off by default: 자동 모드를 사용할 수 없습니다. 그룹과 하위 그룹이 켤 수 있습니다.
    • Always off: 자동 모드를 사용할 수 없습니다. 그룹과 하위 그룹이 켤 수 없습니다.
  5. Save changes를 선택합니다.

사전 요구 사항:

  • 그룹의 Owner 권한이 있어야 합니다.

그룹에서 자동 모드를 켜려면 다음과 같이 합니다:

  1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
  2. Settings > GitLab Duo를 선택합니다.
  3. Change configuration을 선택합니다.
  4. Auto mode 드롭다운 목록에서 다음 옵션 중 하나를 선택합니다:
    • On by default: 자동 모드를 사용할 수 있습니다. 하위 그룹과 프로젝트가 끌 수 있습니다.
    • Off by default: 자동 모드를 사용할 수 없습니다. 하위 그룹과 프로젝트가 켤 수 있습니다.
    • Always off: 자동 모드를 사용할 수 없습니다. 하위 그룹과 프로젝트가 켤 수 없습니다.
  5. Save changes를 선택합니다.

상위 그룹이 자동 모드를 Always off로 설정했다면 프로젝트 설정은 잠기며 켤 수 없습니다.

사전 요구 사항:

  • 프로젝트의 Maintainer 또는 Owner 권한이 있어야 합니다.

프로젝트에서 자동 모드를 켜려면 다음과 같이 합니다:

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. Settings > General을 선택합니다.
  3. GitLab Duo를 확장합니다.
  4. Auto mode 토글을 켭니다.
  5. Save changes를 선택합니다.

자동 모드 사용#

사전 요구 사항:

자동 모드를 사용하려면 다음과 같이 합니다:

  1. 설정을 반영하려면 프로젝트에서 GitLab Duo CLI를 시작하거나 다시 시작합니다.
  2. > 프롬프트 아래의 모드에 auto가 표시될 때까지 Tab을 누릅니다.
  3. 프롬프트를 입력합니다. 자동 모드는 해당 프롬프트부터 적용됩니다.

자동 모드 사용을 중단하려면 Tab을 눌러 다른 모드로 전환합니다. 변경 사항은 다음 프롬프트에 적용됩니다.

자동 모드는 세션 간에 유지되지 않습니다. 기본 모드를 다르게 설정하지 않는 한 새 세션이나 재개한 세션은 모두 빌드 모드로 시작합니다.

자동 모드 문제 해결#

Tab을 눌러도 auto가 나타나지 않으면 다음과 같이 합니다:

  1. 프로젝트에서 Auto mode 설정이 켜져 있는지 확인합니다.
  2. 어떤 상위 그룹도 Always off로 설정되어 있지 않은지 확인합니다.
  3. GitLab Duo CLI를 다시 시작합니다.

헤드리스 모드#

Warning

헤드리스 모드는 통제된 샌드박스 환경에서 신중하게 사용합니다.

워크플로를 비대화식으로 실행하려면 환경에 맞는 명령을 사용합니다:

glab duo cli run을 사용합니다:

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

예를 들어 ESLint 명령을 실행하고 오류를 GitLab Duo CLI로 넘겨 해결할 수 있습니다:

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

duo run을 사용합니다:

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

예를 들어 ESLint 명령을 실행하고 오류를 GitLab Duo CLI로 넘겨 해결할 수 있습니다:

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

헤드리스 모드를 사용하면 GitLab Duo CLI는 다음과 같이 동작합니다:

이미지를 컨텍스트로 제공#

히스토리
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.

사전 요구 사항:

GitLab Duo CLI를 인터랙티브 모드 또는 헤드리스 모드로 로컬에서 실행하면 GitLab Duo는 이미지를 읽어 컨텍스트로 사용할 수 있습니다. CLI가 읽을 수 있는 이미지는 다음과 같습니다.

프롬프트에 이미지를 직접 업로드할 수는 없습니다. 대신 이미 존재하는 이미지를 지정합니다.

이미지 요구 사항#

이미지를 컨텍스트로 사용하려면 이미지가 다음 요구 사항을 충족해야 합니다.

프롬프트 예시#

이슈에 첨부된 스크린샷에 나타난 UI 버그를 수정하도록 GitLab Duo CLI에 요청할 수 있습니다.

Look at the screenshot attached to issue 1234 and fix the alignment bug it shows.

아키텍처 다이어그램을 설명하도록 GitLab Duo CLI에 요청할 수 있습니다.

Read docs/architecture.png, explain the data flow, and identify any single points of failure.

화이트보드 사진을 설계 문서로 만들도록 GitLab Duo CLI에 요청할 수 있습니다.

Read whiteboard.jpg and turn it into a design document in docs/design.md.

모델 선택#

히스토리

인터랙티브 모드나 헤드리스 모드에서 사용할 모델을 선택할 수 있습니다.

인터랙티브 모드의 경우#

선택한 모델은 세션이 바뀌어도 유지되며, 대화 도중에 컨텍스트를 잃지 않고 모델을 전환할 수 있습니다.

사전 요구 사항:

인터랙티브 모드에서 모델을 선택하려면 다음과 같이 합니다:

  1. 인터랙티브 모드에서 /model을 입력하고 Enter를 누릅니다.
  2. 화살표 키로 사용 가능한 모델 목록을 훑어보거나, 모델 이름을 입력해 목록을 필터링합니다.
  3. 모델을 선택하고 Enter를 눌러 해당 모델로 전환합니다.

헤드리스 모드의 경우#

선택한 모델은 세션이 바뀌면 유지되지 않습니다.

사전 요구 사항:

헤드리스 모드에서 모델을 선택하려면 다음과 같이 합니다:

  1. 모델의 gitlab_identifier를 찾습니다.

  2. GitLab Duo CLI를 실행할 때 --model 옵션이나 GITLAB_DUO_MODEL 환경 변수를 gitlab_identifier 값으로 설정합니다.

--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

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

duo --model <gitlab_identifier_for_the_model>

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

GITLAB_DUO_MODEL=<gitlab_identifier_for_the_model> duo

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

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를 사용할 때 다음 문제가 발생할 수 있습니다.

인증서 오류#

다음과 같은 인증서 오류가 발생할 수 있습니다:

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

이 오류는 조직이 HTTPS를 가로채는 프록시 등에 사용자 지정 인증 기관(Certificate Authority, CA)을 사용할 때 발생합니다.

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

인증서 오류 무시#

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

Warning

인증서 검증을 비활성화하면 보안 위험이 있습니다. 운영 환경에서는 검증을 비활성화하지 않습니다.

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

사전 요구 사항:

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

export NODE_TLS_REJECT_UNAUTHORIZED=0

GitLab Duo CLI 사용

GitLab v19.6
Tier: Premium, Ultimate
Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated
원문 보기

요약

GitLab Duo CLI는 두 가지 모드로 사용할 수 있습니다: GitLab Duo CLI를 인터랙티브 모드로 사용하려면 다음과 같이 합니다: 환경에 맞는 명령을 입력해 인터랙티브 모드를 시작합니다: 터미널 창에 프롬프트 >가 나타납니다.

GitLab Duo CLI는 두 가지 모드로 사용할 수 있습니다:

  • 인터랙티브 모드: GitLab UI 나 에디터 확장의 GitLab Duo Chat과 비슷한 채팅 환경을 제공합니다. 빌드 모드, 플랜 모드, 자동 모드를 지원합니다.
  • 헤드리스 모드: 러너, 스크립트를 비롯한 자동화 워크플로에서 비대화식으로 사용할 수 있습니다.

사전 요구 사항#

  • GitLab Duo CLI가 설치되어 있고 설정되어 있어야 합니다.
  • 기본 GitLab Duo 네임스페이스가 설정되어 있거나, GitLab Duo에 접근할 수 있는 프로젝트가 열려 있어야 합니다.

인터랙티브 모드#

GitLab Duo CLI를 인터랙티브 모드로 사용하려면 다음과 같이 합니다:

  1. 환경에 맞는 명령을 입력해 인터랙티브 모드를 시작합니다:

   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 CLI를 처음 실행하면 온보딩 카드가 MCP 서버 연결과 GitLab 마켓플레이스의 플러그인 설치를 도와줍니다.

카드에는 단계를 선택하고 실행하기 위한 탐색 안내가 표시됩니다. 완료한 단계에는 연결된 MCP 서버 수나 설치된 플러그인 수와 함께 체크 표시가 나타납니다.

카드는 두 단계를 모두 완료한 뒤에도 첫 프롬프트를 보낼 때까지 유지됩니다. 이후 실행에서는 다시 표시되지 않습니다.

환영 카드#

새 세션을 시작할 때마다 기본적으로 환영 카드가 표시됩니다. Show work items on session start 설정으로 이 카드를 끌 수 있습니다.

이 카드는 일반적인 작업을 시작하기 위한 프롬프트를 제안하고, 프롬프트를 탐색하고 실행하기 위한 탐색 안내를 표시합니다. 예를 들어 GitLab 프로젝트에서 작업하는 경우 제안되는 프롬프트는 열려 있는 머지 리퀘스트와 이슈를 바탕으로 만들어집니다. 그렇지 않으면 카드에 일반적인 예시가 표시됩니다.

본인의 머지 리퀘스트에 대한 프롬프트를 선택했고 해당 소스 브랜치가 존재하면, 프롬프트는 GitLab Duo에 먼저 그 브랜치를 체크아웃하도록 지시합니다.

Run suggested prompts as /goal sessions 설정이 활성화되어 있고 인스턴스가 GitLab 19.3 이상이면, 리뷰 피드백을 처리하는 프롬프트가 /goal 세션으로 실행됩니다.

시작 카드 숨기기#

시작 카드는 기본적으로 활성화되어 있습니다. 끄려면 --startup-cards를 false로 설정합니다:

glab duo cli --startup-cards false
duo --startup-cards false

또는 STARTUP_CARDS 환경 변수를 false로 설정합니다. 둘 다 설정하면 --startup-cards 옵션이 환경 변수보다 우선합니다.

상태 표시줄#

화면 하단에는 다음 정보가 표시되는 상태 표시줄이 있습니다:

모드 전환#

인터랙티브 모드에서는 작업 중에 GitLab Duo CLI를 여러 모드로 전환할 수 있습니다:

모드 권한 동작 방식
빌드 모드(기본값) 읽기·쓰기 GitLab Duo가 작업을 실행하고 프로젝트를 변경할 수 있습니다.
플랜 모드 읽기 전용 GitLab Duo가 변경 없이 프로젝트를 분석하고 계획을 만들 수 있습니다.
자동 모드 읽기·쓰기 GitLab Duo가 먼저 승인을 요청하지 않고 도구를 사용할 수 있습니다. 자세한 내용은 자동 모드를 참고합니다.

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

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

슬래시 명령어#

히스토리

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

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

명령어 설명
/compact 컨텍스트 공간을 절약하기 위해 대화 기록을 압축합니다.
/copy GitLab Duo의 마지막 응답을 클립보드에 복사합니다.
/doctor GitLab Duo CLI 환경의 진단 정보를 표시합니다.
/exit GitLab Duo CLI를 종료합니다.
/export 세션을 이식 가능한 JSON 번들로 내보냅니다.
/feedback 버그 리포트나 기능 요청을 제출합니다.
/goal 목표를 향해 진행하는 세션을 시작합니다. GitLab 19.3 이상이 필요합니다.
/help 사용할 수 있는 단축키, 모드, 슬래시 명령어를 표시합니다.
/mcp 구성된 MCP 서버와 그 상태를 봅니다.
/model 현재 세션의 AI 모델을 전환합니다.
/new 새 채팅 세션을 시작합니다.
/review 코드 리뷰 서브에이전트로 변경 사항을 리뷰합니다.
/sessions 세션을 탐색하고 검색하고 전환합니다.
/settings 설정 패널을 엽니다.
/skills 현재 프로젝트에서 사용할 수 있는 Agent Skills를 나열합니다.
/whatsnew GitLab Duo CLI의 최근 변경 사항을 표시합니다.

슬래시 명령어가 여는 패널이나 대화 상자를 닫으려면 Escape를 누릅니다.

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

설정#

인터랙티브 모드에서 /settings를 입력하면 설정을 보고 변경할 수 있습니다. 자세한 내용은 GitLab Duo CLI 설정을 참고합니다.

시스템 알림#

히스토리

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

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

도구 승인#

히스토리

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

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

Note

Approve for session 옵션을 사용하려면 관리자가 그룹이나 인스턴스에서 이 옵션을 켜야 합니다. 자세한 내용은 도구 승인을 참고합니다.

자동 모드#

히스토리
Feature flag

이 기능의 가용성은 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.

자동 모드에서 GitLab Duo는 승인을 요청하지 않고 도구를 사용할 수 있습니다. 설정이 허용하는 경우 GitLab Duo는 다음 작업을 수행할 수 있습니다:

자동 모드는 에이전트 도구 거버넌스를 재정의하지 않습니다. 최상위 그룹에 대해 로컬 액세스 도구 거버넌스가 켜져 있으면, Always deny로 설정된 도구는 실행되지 않으며 Always ask로 설정된 도구는 여전히 승인을 요청합니다. 자세한 내용은 GitLab Duo CLI의 자동 모드를 참고합니다.

Warning

GitLab Duo는 실수를 할 수 있습니다. 파일, 이슈, 머지 리퀘스트, 웹 페이지처럼 GitLab Duo가 읽는 모든 콘텐츠에는 프롬프트 인젝션에 사용되는 악의적인 지시가 포함되어 있을 수 있습니다. 위험을 줄이려면 다음을 따릅니다:

자세한 내용은 에디터 확장 보안 고려 사항을 참고합니다.

자동 모드 켜기#

Auto mode 설정은 기본적으로 꺼져 있습니다. 자동 모드를 사용하려면 먼저 인스턴스, 그룹 또는 프로젝트에서 켜야 합니다. 그룹은 인스턴스의 설정을 상속하고, 하위 그룹과 프로젝트는 상위 그룹의 설정을 상속합니다.

사전 요구 사항:

  • 관리자 액세스 권한이 있어야 합니다.

인스턴스에서 자동 모드를 켜려면 다음과 같이 합니다:

  1. 오른쪽 상단에서 Admin을 선택합니다.
  2. 왼쪽 사이드바에서 GitLab Duo를 선택합니다.
  3. Change configuration을 선택합니다.
  4. Auto mode 드롭다운 목록에서 다음 옵션 중 하나를 선택합니다:
    • On by default: 자동 모드를 사용할 수 있습니다. 그룹과 하위 그룹이 끌 수 있습니다.
    • Off by default: 자동 모드를 사용할 수 없습니다. 그룹과 하위 그룹이 켤 수 있습니다.
    • Always off: 자동 모드를 사용할 수 없습니다. 그룹과 하위 그룹이 켤 수 없습니다.
  5. Save changes를 선택합니다.

사전 요구 사항:

  • 그룹의 Owner 권한이 있어야 합니다.

그룹에서 자동 모드를 켜려면 다음과 같이 합니다:

  1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
  2. Settings > GitLab Duo를 선택합니다.
  3. Change configuration을 선택합니다.
  4. Auto mode 드롭다운 목록에서 다음 옵션 중 하나를 선택합니다:
    • On by default: 자동 모드를 사용할 수 있습니다. 하위 그룹과 프로젝트가 끌 수 있습니다.
    • Off by default: 자동 모드를 사용할 수 없습니다. 하위 그룹과 프로젝트가 켤 수 있습니다.
    • Always off: 자동 모드를 사용할 수 없습니다. 하위 그룹과 프로젝트가 켤 수 없습니다.
  5. Save changes를 선택합니다.

상위 그룹이 자동 모드를 Always off로 설정했다면 프로젝트 설정은 잠기며 켤 수 없습니다.

사전 요구 사항:

  • 프로젝트의 Maintainer 또는 Owner 권한이 있어야 합니다.

프로젝트에서 자동 모드를 켜려면 다음과 같이 합니다:

  1. 상단 바에서 Search or go to를 선택하고 프로젝트를 찾습니다.
  2. Settings > General을 선택합니다.
  3. GitLab Duo를 확장합니다.
  4. Auto mode 토글을 켭니다.
  5. Save changes를 선택합니다.

자동 모드 사용#

사전 요구 사항:

자동 모드를 사용하려면 다음과 같이 합니다:

  1. 설정을 반영하려면 프로젝트에서 GitLab Duo CLI를 시작하거나 다시 시작합니다.
  2. > 프롬프트 아래의 모드에 auto가 표시될 때까지 Tab을 누릅니다.
  3. 프롬프트를 입력합니다. 자동 모드는 해당 프롬프트부터 적용됩니다.

자동 모드 사용을 중단하려면 Tab을 눌러 다른 모드로 전환합니다. 변경 사항은 다음 프롬프트에 적용됩니다.

자동 모드는 세션 간에 유지되지 않습니다. 기본 모드를 다르게 설정하지 않는 한 새 세션이나 재개한 세션은 모두 빌드 모드로 시작합니다.

자동 모드 문제 해결#

Tab을 눌러도 auto가 나타나지 않으면 다음과 같이 합니다:

  1. 프로젝트에서 Auto mode 설정이 켜져 있는지 확인합니다.
  2. 어떤 상위 그룹도 Always off로 설정되어 있지 않은지 확인합니다.
  3. GitLab Duo CLI를 다시 시작합니다.

헤드리스 모드#

Warning

헤드리스 모드는 통제된 샌드박스 환경에서 신중하게 사용합니다.

워크플로를 비대화식으로 실행하려면 환경에 맞는 명령을 사용합니다:

glab duo cli run을 사용합니다:

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

예를 들어 ESLint 명령을 실행하고 오류를 GitLab Duo CLI로 넘겨 해결할 수 있습니다:

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

duo run을 사용합니다:

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

예를 들어 ESLint 명령을 실행하고 오류를 GitLab Duo CLI로 넘겨 해결할 수 있습니다:

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

헤드리스 모드를 사용하면 GitLab Duo CLI는 다음과 같이 동작합니다:

이미지를 컨텍스트로 제공#

히스토리
Feature flag

이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참고합니다.

사전 요구 사항:

GitLab Duo CLI를 인터랙티브 모드 또는 헤드리스 모드로 로컬에서 실행하면 GitLab Duo는 이미지를 읽어 컨텍스트로 사용할 수 있습니다. CLI가 읽을 수 있는 이미지는 다음과 같습니다.

프롬프트에 이미지를 직접 업로드할 수는 없습니다. 대신 이미 존재하는 이미지를 지정합니다.

이미지 요구 사항#

이미지를 컨텍스트로 사용하려면 이미지가 다음 요구 사항을 충족해야 합니다.

프롬프트 예시#

이슈에 첨부된 스크린샷에 나타난 UI 버그를 수정하도록 GitLab Duo CLI에 요청할 수 있습니다.

Look at the screenshot attached to issue 1234 and fix the alignment bug it shows.

아키텍처 다이어그램을 설명하도록 GitLab Duo CLI에 요청할 수 있습니다.

Read docs/architecture.png, explain the data flow, and identify any single points of failure.

화이트보드 사진을 설계 문서로 만들도록 GitLab Duo CLI에 요청할 수 있습니다.

Read whiteboard.jpg and turn it into a design document in docs/design.md.

모델 선택#

히스토리

인터랙티브 모드나 헤드리스 모드에서 사용할 모델을 선택할 수 있습니다.

인터랙티브 모드의 경우#

선택한 모델은 세션이 바뀌어도 유지되며, 대화 도중에 컨텍스트를 잃지 않고 모델을 전환할 수 있습니다.

사전 요구 사항:

인터랙티브 모드에서 모델을 선택하려면 다음과 같이 합니다:

  1. 인터랙티브 모드에서 /model을 입력하고 Enter를 누릅니다.
  2. 화살표 키로 사용 가능한 모델 목록을 훑어보거나, 모델 이름을 입력해 목록을 필터링합니다.
  3. 모델을 선택하고 Enter를 눌러 해당 모델로 전환합니다.

헤드리스 모드의 경우#

선택한 모델은 세션이 바뀌면 유지되지 않습니다.

사전 요구 사항:

헤드리스 모드에서 모델을 선택하려면 다음과 같이 합니다:

  1. 모델의 gitlab_identifier를 찾습니다.

  2. GitLab Duo CLI를 실행할 때 --model 옵션이나 GITLAB_DUO_MODEL 환경 변수를 gitlab_identifier 값으로 설정합니다.

--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

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

duo --model <gitlab_identifier_for_the_model>

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

GITLAB_DUO_MODEL=<gitlab_identifier_for_the_model> duo

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

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를 사용할 때 다음 문제가 발생할 수 있습니다.

인증서 오류#

다음과 같은 인증서 오류가 발생할 수 있습니다:

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

이 오류는 조직이 HTTPS를 가로채는 프록시 등에 사용자 지정 인증 기관(Certificate Authority, CA)을 사용할 때 발생합니다.

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

인증서 오류 무시#

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

Warning

인증서 검증을 비활성화하면 보안 위험이 있습니다. 운영 환경에서는 검증을 비활성화하지 않습니다.

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

사전 요구 사항:

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

export NODE_TLS_REJECT_UNAUTHORIZED=0