InfoGrab DocsInfoGrab Docs

에이전트 플랫폼 AI 모델

요약

모든 GitLab Duo 기능은 기본 모델을 사용합니다. 일부 기능에서는 다른 모델을 선택할 수 있으며, 선택한 모델은 변경하기 전까지 유지됩니다. 다음 표는 Agent Platform의 기능별 기본 모델입니다. 다음 표는 Agent Platform의 기능에서 선택할 수 있는 모델입니다.

모든 GitLab Duo 기능은 기본 모델을 사용합니다. GitLab은 성능을 개선하기 위해 기본 모델을 변경할 수 있습니다. 모델 변경은 GitLab AI Gateway에서 이뤄지며, 별도 언급이 없는 한 GitLab 버전과 관계없이 적용됩니다.

일부 기능에서는 다른 모델을 선택할 수 있으며, 선택한 모델은 변경하기 전까지 유지됩니다.

기본 모델#

히스토리
  • GitLab 19.1에서 Code Review Flow 용 별도 모델 설정이 도입되었습니다.
  • 2026년 5월 20일에 Code Review Flow의 기본 LLM이 Claude Sonnet 4.6 Vertex로 변경되었습니다.
  • 2026년 8월 6일에 Code Review Flow의 기본 LLM이 Claude Sonnet 5 Vertex로 변경되었습니다.
  • 2026년 10월 2일에 Business Logic Security Scan의 기본 LLM이 Claude Sonnet 5 Gemini Enterprise Agent Platform으로 설정되었습니다.
  • 2026년 10월 5일에 Code Review Flow의 기본 LLM이 Claude Sonnet 5.5 Gemini Enterprise Agent Platform으로 변경되었습니다.
  • GitLab 19.5에서 Recommend Reviewers Flow용 별도 모델 설정이 도입되었습니다.
  • 2026년 10월 7일에 GitLab Duo Agentic Chat, GitLab Duo Developer, 다른 모든 에이전트의 기본 LLM이 Claude Sonnet 5.5 Gemini Enterprise Agent Platform으로 변경되었습니다.
  • 2026년 10월 8일에 Recommend Reviewers Flow의 기본 LLM이 Claude Haiku 5.5 Gemini Enterprise Agent Platform으로 변경되었습니다.

다음 표는 Agent Platform의 기능별 기본 모델입니다.

기능 모델
GitLab Duo Agentic Chat Claude Sonnet 5.5 Gemini Enterprise Agent Platform
Code Review Flow1 Claude Sonnet 5.5 Gemini Enterprise Agent Platform
Security Review Flow Claude Sonnet 4.6 Gemini Enterprise Agent Platform
Business Logic Security Scan2 Claude Sonnet 5 Gemini Enterprise Agent Platform
Recommend Reviewers Flow Claude Haiku 5.5 Gemini Enterprise Agent Platform
GitLab Duo Developer Claude Sonnet 5.5 Gemini Enterprise Agent Platform
다른 모든 에이전트 Claude Sonnet 5.5 Gemini Enterprise Agent Platform

지원되는 모델#

히스토리
  • 2026년 5월 26일에 GPT-5.2와 GPT-5.3 Codex가 Code Review Flow의 지원 모델로 추가되었습니다.
  • 2026년 8월 3일에 Claude Sonnet 5가 Code Review Flow의 지원 모델로 추가되었습니다.
  • Code Review Flow의 지원 모델이던 Claude Sonnet 4.5가 2026년 8월 10일에 더 이상 사용되지 않게 되었고 2026년 8월 25일에 제거되었습니다.
  • 2026년 9월 16일에 GLM 5.3, Kimi K3, MiniMax M3가 GitLab Duo Agentic Chat과 다른 모든 에이전트의 지원 모델로 추가되었습니다.
  • 2026년 9월 22일에 GPT-6 Sol과 GPT-6 Luna가 GitLab Duo Agentic Chat과 다른 모든 에이전트의 지원 모델로 추가되었습니다.
  • 2026년 9월 28일에 Claude Sonnet 5.5가 GitLab Duo Agentic Chat과 다른 모든 에이전트의 지원 모델로 추가되었습니다.
  • 2026년 9월 29일에 GPT-6.1 Sol이 GitLab Duo Agentic Chat과 다른 모든 에이전트의 지원 모델로 추가되었습니다.
  • 2026년 10월 2일에 Claude Sonnet 4.6과 Claude Sonnet 5가 Business Logic Security Scan의 지원 모델로 추가되었습니다.
  • 2026년 10월 5일에 Claude Sonnet 5.5와 Claude Sonnet 5.5 Gemini Enterprise Agent Platform이 Code Review Flow의 지원 모델로 추가되었습니다.
  • 2026년 10월 7일에 Claude Haiku 5.5가 GitLab Duo Agentic Chat과 다른 모든 에이전트의 지원 모델로 추가되었습니다.
  • 2026년 10월 8일에 Claude Haiku 5.5가 Recommend Reviewers Flow의 지원 모델로 추가되었습니다.

다음 표는 Agent Platform의 기능에서 선택할 수 있는 모델입니다.

모델 사용 가능 여부는 구독 및 체험판 상태에 따라 다를 수 있습니다. 체험판 중의 모델 사용 가능 여부는 GitLab Duo Agent Platform 체험판을 참고합니다.

모델 GitLab Duo
Agentic Chat		 Code Review Flow3 Security Review Flow Business Logic Security Scan2 Recommend Reviewers Flow 다른 모든 에이전트
Claude Fable 54 ✅ ❌ ❌ ❌ ❌ ✅
Claude Fable 5.14 ✅ ❌ ❌ ❌ ❌ ✅
Claude Sonnet 4.5 ✅ ❌ ✅ ❌ ❌ ✅
Claude Sonnet 4.6 ✅ ✅ ✅ ✅ ❌ ✅
Claude Sonnet 5 ✅ ✅ ❌ ✅ ✅ ✅
Claude Sonnet 5.5 ✅ ✅ ❌ ❌ ✅ ✅
Claude Haiku 4.5 ✅ ❌ ❌ ❌ ✅ ✅
Claude Haiku 5.5 ✅ ❌ ❌ ❌ ✅ ✅
Claude Opus 4.5 ✅ ❌ ❌ ❌ ❌ ✅
Claude Opus 4.6 ✅ ❌ ❌ ❌ ❌ ✅
Claude Opus 4.7 ✅ ❌ ❌ ❌ ❌ ✅
Claude Opus 4.8 ✅ ❌ ❌ ❌ ❌ ✅
Claude Opus 5 ✅ ❌ ❌ ❌ ❌ ✅
Claude Opus 5.5 ✅ ❌ ❌ ❌ ❌ ✅
Gemini 3.5 Flash ✅ ❌ ❌ ❌ ❌ ✅
Gemini 3.6 Flash ✅ ❌ ❌ ❌ ❌ ✅
Gemini 3.7 Flash ✅ ❌ ❌ ❌ ❌ ✅
Gemini 3.8 Flash ✅ ❌ ❌ ❌ ❌ ✅
GLM 5.3 ✅ ❌ ❌ ❌ ❌ ✅
GPT-5 ✅ ❌ ❌ ❌ ❌ ✅
GPT-5.1 ✅ ❌ ❌ ❌ ❌ ✅
GPT-5.2 ✅ ✅ ✅ ❌ ❌ ✅
GPT-5 Codex ✅ ❌ ❌ ❌ ❌ ✅
GPT-5.2 Codex ✅ ❌ ❌ ❌ ❌ ✅
GPT-5.3 Codex ✅ ✅ ✅ ❌ ❌ ✅
GPT-5 Mini ✅ ❌ ❌ ❌ ❌ ✅
GPT-5.4 Mini ✅ ❌ ❌ ❌ ❌ ✅
GPT-5.4 Nano ✅ ❌ ❌ ❌ ❌ ✅
GPT-5.54 ✅ ❌ ❌ ❌ ❌ ✅
GPT-5.6 Sol4 ✅ ❌ ❌ ❌ ❌ ✅
GPT-5.6 Terra4 ✅ ❌ ❌ ❌ ❌ ✅
GPT-5.6 Luna4 ✅ ❌ ❌ ❌ ❌ ✅
GPT-6 Astra4 ✅ ❌ ❌ ❌ ❌ ✅
GPT-6 Sol4 ✅ ❌ ❌ ❌ ❌ ✅
GPT-6 Luna4 ✅ ❌ ❌ ❌ ✅ ✅
GPT-6.1 Sol4 ✅ ❌ ❌ ❌ ❌ ✅
Kimi K3 ✅ ❌ ❌ ❌ ❌ ✅
MiniMax M3 ✅ ❌ ❌ ❌ ❌ ✅

기능에 대한 모델 선택#

히스토리

최상위 그룹에서 기능별로 기본 모델을 선택할 수 있습니다. 선택한 모델은 모든 하위 그룹과 프로젝트의 해당 기능에 적용됩니다.

GitLab Self-Managed 나 GitLab Dedicated에서 인스턴스 모델을 설정하는 방법은 모델 선택을 참고합니다.

사전 요구 사항:

  • 그룹의 Owner 권한이 있어야 합니다.
  • 모델을 선택하는 그룹이 최상위 그룹이어야 합니다.
  • GitLab 18.3 이상에서 GitLab Duo 네임스페이스에 여러 개 속해 있다면 기본 네임스페이스를 지정해야 합니다.

에이전틱 Chat의 모델 선택#

히스토리
  • GitLab 19.1에서 model_selection_allowlist라는 기능 플래그와 함께 Agentic Chat을 특정 모델로 제한하는 기능이 도입되었습니다. 기본적으로 활성화되어 있습니다.
  • GitLab 19.2에서 Agentic Chat을 특정 모델로 제한하는 기능이 일반 공급되었습니다. 기능 플래그 model_selection_allowlist가 제거되었습니다.
  • GitLab 19.5에서 third_party_agent_token_model_allowlist라는 기능 플래그와 함께 Agentic Chat을 특정 모델로 제한하는 기능이 외부 에이전트와 서드파티 도구로 확대되었습니다. 기본적으로 비활성화되어 있습니다.

Agentic Chat의 모델을 선택하려면 다음 단계를 따릅니다.

  1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.

  2. 왼쪽 사이드바에서 Settings > GitLab Duo를 선택합니다.

  3. Model selection 아래에서 Manage models를 선택합니다.

  4. GitLab Duo Agentic Chat 섹션으로 이동합니다.

  5. Default model 드롭다운 목록에서 모델을 선택합니다. 이 모델은 기본적으로 고정되며, GitLab 기본 모델을 선택한 경우가 아니라면 사용자가 변경할 수 없습니다. GitLab 기본 모델을 선택한 경우에는 GitLab이 관리하는 모든 모델을 사용자가 사용할 수 있습니다.

  6. 선택 사항. Agentic Chat을 특정 모델로 제한하려면 다음 단계를 따릅니다.

    1. Default model 드롭다운 목록 아래에서 Configure를 선택합니다.

    2. Available models: Agentic Chat 대화 상자에서 Restrict to specific models 체크박스를 선택합니다.

    3. Agentic Chat이 사용할 모델을 선택합니다. 모든 모델을 선택하려면 Select all models 체크박스를 선택합니다. 선택한 모든 모델을 해제하려면 Clear all models를 선택합니다.

      [!note] 기본 모델은 항상 사용자에게 제공되며 선택을 해제할 수 없습니다. 변경 사항을 저장하려면 기본 모델 외에 모델을 하나 이상 선택해야 합니다.

    4. Save를 선택합니다.

    [!note] Agentic Chat을 특정 모델로 제한하려면 기본 모델로 GitLab이 관리하는 모델을 선택해야 합니다.

Feature flag

외부 에이전트와 서드파티 도구에 대한 이 제한의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참조합니다.

이 제한은 GitLab 관리 자격 증명을 사용하는 외부 에이전트에도 적용됩니다. GitLab AI Gateway 토큰을 사용하는 OpenCode와 같은 서드파티 도구에도 적용됩니다. 이러한 에이전트나 도구가 목록에 없는 모델을 요청하면 요청이 HTTP 403 오류로 실패합니다. 이러한 에이전트가 사용하는 모델을 목록에 추가합니다. 일부 에이전트는 둘 이상의 모델을 사용합니다. 예를 들어 Claude Code는 백그라운드 작업에 더 작은 모델도 사용합니다.

Note

목록의 변경 사항은 새 토큰에 적용됩니다. 기존 토큰은 최대 1시간 동안 유효할 수 있습니다.

다른 에이전틱 기능의 모델 선택#

다른 에이전틱 기능의 모델을 선택하려면 다음 단계를 따릅니다.

  1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 Settings > GitLab Duo를 선택합니다.
  3. Model selection 아래에서 Manage models를 선택합니다.
  4. GitLab Duo Agent Platform 아래에서 구성하려는 기능을 찾습니다.
  5. 드롭다운 목록에서 기본 모델로 설정할 모델을 선택합니다.
  6. 선택 사항. 한 섹션의 여러 기능에 모델을 적용하려면 Bulk update 드롭다운 목록에서 모델을 선택합니다. 모델은 호환되는 기능에만 적용됩니다.
  7. 선택 사항. 한 섹션의 모든 기능을 기본 모델로 되돌리려면 Reset to default를 선택합니다.

GitLab Duo CLI의 모델을 지정하는 방법은 모델 선택을 참고합니다.

적합한 모델 선택#

많은 사용 사례에서는 Claude Haiku 4.5 나 GPT-5.4 Mini처럼 더 빠르고 비용 효율이 높은 모델로 시작하는 편이 좋습니다. 이 방식은 다음과 같습니다.

  1. Claude Haiku 4.5 또는 GPT-5.4 Mini를 선택합니다.
  2. 사용 사례를 충분히 테스트합니다.
  3. 성능이 요구 사항을 충족하는지 평가합니다.
  4. 특정 기능이 부족한 경우에만 상위 모델로 올립니다.

이 방식은 다음과 같은 경우에 사용할 수 있습니다.

  • 탐색적이거나 대량으로 처리하는 작업
  • 지연 시간 요구 사항이 엄격한 애플리케이션
  • 비용에 민감한 구현

문제 해결#

기본 모델이 아닌 모델을 선택할 때 다음과 같은 문제가 발생할 수 있습니다.

모델을 사용할 수 없음#

GitLab Duo AI 네이티브 기능에서 GitLab 기본 모델을 사용 중이라면, GitLab은 성능과 안정성을 유지하기 위해 사용자에게 알리지 않고 기본 모델을 변경할 수 있습니다.

GitLab Duo AI 네이티브 기능에 특정 모델을 선택했는데 그 모델을 사용할 수 없으면 자동 대체가 이뤄지지 않습니다. 해당 모델을 사용하는 기능은 사용할 수 없습니다.

체험판 중에는 프런티어 모델을 사용할 수 없음#

GitLab Duo Agent Platform 체험판을 사용 중이라면 일부 프런티어 모델은 체험판에 포함되지 않으므로 사용할 수 없습니다.

이를 해결하려면 다음 중 하나를 수행합니다.

자세한 내용은 GitLab Duo Agent Platform 체험판을 참고합니다.

기본 GitLab Duo 네임스페이스 없음#

모델을 선택한 상태로 GitLab Duo 기능을 사용할 때 기본 GitLab Duo 네임스페이스를 설정해야 한다는 오류가 표시될 수 있습니다.

이 문제는 GitLab Duo 네임스페이스에 여러 개 속해 있거나, GitLab 리모트가 구성되지 않은 프로젝트를 로컬에서 작업할 때 발생합니다.

이 문제를 해결하려면 기본 GitLab Duo 네임스페이스를 설정합니다.

IDE에서 에이전틱 Chat의 모델 선택이 작동하지 않음#

IDE에서 Agentic Chat의 모델을 선택할 때 모델 선택이 동작하지 않을 수 있습니다.

이 문제를 해결하려면 다음 단계를 따릅니다.

  1. IDE의 연결 유형이 WebSocket으로 설정되어 있는지 확인합니다.
  2. 네트워크 관리자에게 GitLab 인스턴스로의 WebSocket 트래픽이 허용되어 있는지 확인을 요청합니다.

Footnotes

  1. GitLab 19.0 이하에서 Code Review Flow는 비에이전틱 버전인 GitLab Duo Code Review에 설정된 기본 LLM을 사용합니다. ↩

  2. Business Logic Security Scan은 실험 기능입니다. bl_security_analyzer 기능 플래그가 활성화되어 있고 실험 및 베타 기능이 켜져 있을 때만 사용할 수 있습니다. ↩ ↩2

  3. GitLab 19.0 이하에서 Code Review Flow는 비에이전틱 버전인 GitLab Duo Code Review에 사용할 수 있는 모델만 사용할 수 있습니다. ↩

  4. 이 모델에는 공급업체 측 데이터 보존 제한이 적용됩니다. ↩ ↩2 ↩3 ↩4 ↩5 ↩6 ↩7 ↩8 ↩9 ↩10

에이전트 플랫폼 AI 모델

GitLab v19.5
Tier: Premium, Ultimate
Offering: GitLab.com
원문 보기

요약

모든 GitLab Duo 기능은 기본 모델을 사용합니다. 일부 기능에서는 다른 모델을 선택할 수 있으며, 선택한 모델은 변경하기 전까지 유지됩니다. 다음 표는 Agent Platform의 기능별 기본 모델입니다. 다음 표는 Agent Platform의 기능에서 선택할 수 있는 모델입니다.

모든 GitLab Duo 기능은 기본 모델을 사용합니다. GitLab은 성능을 개선하기 위해 기본 모델을 변경할 수 있습니다. 모델 변경은 GitLab AI Gateway에서 이뤄지며, 별도 언급이 없는 한 GitLab 버전과 관계없이 적용됩니다.

일부 기능에서는 다른 모델을 선택할 수 있으며, 선택한 모델은 변경하기 전까지 유지됩니다.

기본 모델#

히스토리
  • GitLab 19.1에서 Code Review Flow 용 별도 모델 설정이 도입되었습니다.
  • 2026년 5월 20일에 Code Review Flow의 기본 LLM이 Claude Sonnet 4.6 Vertex로 변경되었습니다.
  • 2026년 8월 6일에 Code Review Flow의 기본 LLM이 Claude Sonnet 5 Vertex로 변경되었습니다.
  • 2026년 10월 2일에 Business Logic Security Scan의 기본 LLM이 Claude Sonnet 5 Gemini Enterprise Agent Platform으로 설정되었습니다.
  • 2026년 10월 5일에 Code Review Flow의 기본 LLM이 Claude Sonnet 5.5 Gemini Enterprise Agent Platform으로 변경되었습니다.
  • GitLab 19.5에서 Recommend Reviewers Flow용 별도 모델 설정이 도입되었습니다.
  • 2026년 10월 7일에 GitLab Duo Agentic Chat, GitLab Duo Developer, 다른 모든 에이전트의 기본 LLM이 Claude Sonnet 5.5 Gemini Enterprise Agent Platform으로 변경되었습니다.
  • 2026년 10월 8일에 Recommend Reviewers Flow의 기본 LLM이 Claude Haiku 5.5 Gemini Enterprise Agent Platform으로 변경되었습니다.

다음 표는 Agent Platform의 기능별 기본 모델입니다.

기능 모델
GitLab Duo Agentic Chat Claude Sonnet 5.5 Gemini Enterprise Agent Platform
Code Review Flow1 Claude Sonnet 5.5 Gemini Enterprise Agent Platform
Security Review Flow Claude Sonnet 4.6 Gemini Enterprise Agent Platform
Business Logic Security Scan2 Claude Sonnet 5 Gemini Enterprise Agent Platform
Recommend Reviewers Flow Claude Haiku 5.5 Gemini Enterprise Agent Platform
GitLab Duo Developer Claude Sonnet 5.5 Gemini Enterprise Agent Platform
다른 모든 에이전트 Claude Sonnet 5.5 Gemini Enterprise Agent Platform

지원되는 모델#

히스토리
  • 2026년 5월 26일에 GPT-5.2와 GPT-5.3 Codex가 Code Review Flow의 지원 모델로 추가되었습니다.
  • 2026년 8월 3일에 Claude Sonnet 5가 Code Review Flow의 지원 모델로 추가되었습니다.
  • Code Review Flow의 지원 모델이던 Claude Sonnet 4.5가 2026년 8월 10일에 더 이상 사용되지 않게 되었고 2026년 8월 25일에 제거되었습니다.
  • 2026년 9월 16일에 GLM 5.3, Kimi K3, MiniMax M3가 GitLab Duo Agentic Chat과 다른 모든 에이전트의 지원 모델로 추가되었습니다.
  • 2026년 9월 22일에 GPT-6 Sol과 GPT-6 Luna가 GitLab Duo Agentic Chat과 다른 모든 에이전트의 지원 모델로 추가되었습니다.
  • 2026년 9월 28일에 Claude Sonnet 5.5가 GitLab Duo Agentic Chat과 다른 모든 에이전트의 지원 모델로 추가되었습니다.
  • 2026년 9월 29일에 GPT-6.1 Sol이 GitLab Duo Agentic Chat과 다른 모든 에이전트의 지원 모델로 추가되었습니다.
  • 2026년 10월 2일에 Claude Sonnet 4.6과 Claude Sonnet 5가 Business Logic Security Scan의 지원 모델로 추가되었습니다.
  • 2026년 10월 5일에 Claude Sonnet 5.5와 Claude Sonnet 5.5 Gemini Enterprise Agent Platform이 Code Review Flow의 지원 모델로 추가되었습니다.
  • 2026년 10월 7일에 Claude Haiku 5.5가 GitLab Duo Agentic Chat과 다른 모든 에이전트의 지원 모델로 추가되었습니다.
  • 2026년 10월 8일에 Claude Haiku 5.5가 Recommend Reviewers Flow의 지원 모델로 추가되었습니다.

다음 표는 Agent Platform의 기능에서 선택할 수 있는 모델입니다.

모델 사용 가능 여부는 구독 및 체험판 상태에 따라 다를 수 있습니다. 체험판 중의 모델 사용 가능 여부는 GitLab Duo Agent Platform 체험판을 참고합니다.

모델 GitLab Duo
Agentic Chat		 Code Review Flow3 Security Review Flow Business Logic Security Scan2 Recommend Reviewers Flow 다른 모든 에이전트
Claude Fable 54 ✅ ❌ ❌ ❌ ❌ ✅
Claude Fable 5.14 ✅ ❌ ❌ ❌ ❌ ✅
Claude Sonnet 4.5 ✅ ❌ ✅ ❌ ❌ ✅
Claude Sonnet 4.6 ✅ ✅ ✅ ✅ ❌ ✅
Claude Sonnet 5 ✅ ✅ ❌ ✅ ✅ ✅
Claude Sonnet 5.5 ✅ ✅ ❌ ❌ ✅ ✅
Claude Haiku 4.5 ✅ ❌ ❌ ❌ ✅ ✅
Claude Haiku 5.5 ✅ ❌ ❌ ❌ ✅ ✅
Claude Opus 4.5 ✅ ❌ ❌ ❌ ❌ ✅
Claude Opus 4.6 ✅ ❌ ❌ ❌ ❌ ✅
Claude Opus 4.7 ✅ ❌ ❌ ❌ ❌ ✅
Claude Opus 4.8 ✅ ❌ ❌ ❌ ❌ ✅
Claude Opus 5 ✅ ❌ ❌ ❌ ❌ ✅
Claude Opus 5.5 ✅ ❌ ❌ ❌ ❌ ✅
Gemini 3.5 Flash ✅ ❌ ❌ ❌ ❌ ✅
Gemini 3.6 Flash ✅ ❌ ❌ ❌ ❌ ✅
Gemini 3.7 Flash ✅ ❌ ❌ ❌ ❌ ✅
Gemini 3.8 Flash ✅ ❌ ❌ ❌ ❌ ✅
GLM 5.3 ✅ ❌ ❌ ❌ ❌ ✅
GPT-5 ✅ ❌ ❌ ❌ ❌ ✅
GPT-5.1 ✅ ❌ ❌ ❌ ❌ ✅
GPT-5.2 ✅ ✅ ✅ ❌ ❌ ✅
GPT-5 Codex ✅ ❌ ❌ ❌ ❌ ✅
GPT-5.2 Codex ✅ ❌ ❌ ❌ ❌ ✅
GPT-5.3 Codex ✅ ✅ ✅ ❌ ❌ ✅
GPT-5 Mini ✅ ❌ ❌ ❌ ❌ ✅
GPT-5.4 Mini ✅ ❌ ❌ ❌ ❌ ✅
GPT-5.4 Nano ✅ ❌ ❌ ❌ ❌ ✅
GPT-5.54 ✅ ❌ ❌ ❌ ❌ ✅
GPT-5.6 Sol4 ✅ ❌ ❌ ❌ ❌ ✅
GPT-5.6 Terra4 ✅ ❌ ❌ ❌ ❌ ✅
GPT-5.6 Luna4 ✅ ❌ ❌ ❌ ❌ ✅
GPT-6 Astra4 ✅ ❌ ❌ ❌ ❌ ✅
GPT-6 Sol4 ✅ ❌ ❌ ❌ ❌ ✅
GPT-6 Luna4 ✅ ❌ ❌ ❌ ✅ ✅
GPT-6.1 Sol4 ✅ ❌ ❌ ❌ ❌ ✅
Kimi K3 ✅ ❌ ❌ ❌ ❌ ✅
MiniMax M3 ✅ ❌ ❌ ❌ ❌ ✅

기능에 대한 모델 선택#

히스토리

최상위 그룹에서 기능별로 기본 모델을 선택할 수 있습니다. 선택한 모델은 모든 하위 그룹과 프로젝트의 해당 기능에 적용됩니다.

GitLab Self-Managed 나 GitLab Dedicated에서 인스턴스 모델을 설정하는 방법은 모델 선택을 참고합니다.

사전 요구 사항:

  • 그룹의 Owner 권한이 있어야 합니다.
  • 모델을 선택하는 그룹이 최상위 그룹이어야 합니다.
  • GitLab 18.3 이상에서 GitLab Duo 네임스페이스에 여러 개 속해 있다면 기본 네임스페이스를 지정해야 합니다.

에이전틱 Chat의 모델 선택#

히스토리
  • GitLab 19.1에서 model_selection_allowlist라는 기능 플래그와 함께 Agentic Chat을 특정 모델로 제한하는 기능이 도입되었습니다. 기본적으로 활성화되어 있습니다.
  • GitLab 19.2에서 Agentic Chat을 특정 모델로 제한하는 기능이 일반 공급되었습니다. 기능 플래그 model_selection_allowlist가 제거되었습니다.
  • GitLab 19.5에서 third_party_agent_token_model_allowlist라는 기능 플래그와 함께 Agentic Chat을 특정 모델로 제한하는 기능이 외부 에이전트와 서드파티 도구로 확대되었습니다. 기본적으로 비활성화되어 있습니다.

Agentic Chat의 모델을 선택하려면 다음 단계를 따릅니다.

  1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.

  2. 왼쪽 사이드바에서 Settings > GitLab Duo를 선택합니다.

  3. Model selection 아래에서 Manage models를 선택합니다.

  4. GitLab Duo Agentic Chat 섹션으로 이동합니다.

  5. Default model 드롭다운 목록에서 모델을 선택합니다. 이 모델은 기본적으로 고정되며, GitLab 기본 모델을 선택한 경우가 아니라면 사용자가 변경할 수 없습니다. GitLab 기본 모델을 선택한 경우에는 GitLab이 관리하는 모든 모델을 사용자가 사용할 수 있습니다.

  6. 선택 사항. Agentic Chat을 특정 모델로 제한하려면 다음 단계를 따릅니다.

    1. Default model 드롭다운 목록 아래에서 Configure를 선택합니다.

    2. Available models: Agentic Chat 대화 상자에서 Restrict to specific models 체크박스를 선택합니다.

    3. Agentic Chat이 사용할 모델을 선택합니다. 모든 모델을 선택하려면 Select all models 체크박스를 선택합니다. 선택한 모든 모델을 해제하려면 Clear all models를 선택합니다.

      [!note] 기본 모델은 항상 사용자에게 제공되며 선택을 해제할 수 없습니다. 변경 사항을 저장하려면 기본 모델 외에 모델을 하나 이상 선택해야 합니다.

    4. Save를 선택합니다.

    [!note] Agentic Chat을 특정 모델로 제한하려면 기본 모델로 GitLab이 관리하는 모델을 선택해야 합니다.

Feature flag

외부 에이전트와 서드파티 도구에 대한 이 제한의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참조합니다.

이 제한은 GitLab 관리 자격 증명을 사용하는 외부 에이전트에도 적용됩니다. GitLab AI Gateway 토큰을 사용하는 OpenCode와 같은 서드파티 도구에도 적용됩니다. 이러한 에이전트나 도구가 목록에 없는 모델을 요청하면 요청이 HTTP 403 오류로 실패합니다. 이러한 에이전트가 사용하는 모델을 목록에 추가합니다. 일부 에이전트는 둘 이상의 모델을 사용합니다. 예를 들어 Claude Code는 백그라운드 작업에 더 작은 모델도 사용합니다.

Note

목록의 변경 사항은 새 토큰에 적용됩니다. 기존 토큰은 최대 1시간 동안 유효할 수 있습니다.

다른 에이전틱 기능의 모델 선택#

다른 에이전틱 기능의 모델을 선택하려면 다음 단계를 따릅니다.

  1. 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
  2. 왼쪽 사이드바에서 Settings > GitLab Duo를 선택합니다.
  3. Model selection 아래에서 Manage models를 선택합니다.
  4. GitLab Duo Agent Platform 아래에서 구성하려는 기능을 찾습니다.
  5. 드롭다운 목록에서 기본 모델로 설정할 모델을 선택합니다.
  6. 선택 사항. 한 섹션의 여러 기능에 모델을 적용하려면 Bulk update 드롭다운 목록에서 모델을 선택합니다. 모델은 호환되는 기능에만 적용됩니다.
  7. 선택 사항. 한 섹션의 모든 기능을 기본 모델로 되돌리려면 Reset to default를 선택합니다.

GitLab Duo CLI의 모델을 지정하는 방법은 모델 선택을 참고합니다.

적합한 모델 선택#

많은 사용 사례에서는 Claude Haiku 4.5 나 GPT-5.4 Mini처럼 더 빠르고 비용 효율이 높은 모델로 시작하는 편이 좋습니다. 이 방식은 다음과 같습니다.

  1. Claude Haiku 4.5 또는 GPT-5.4 Mini를 선택합니다.
  2. 사용 사례를 충분히 테스트합니다.
  3. 성능이 요구 사항을 충족하는지 평가합니다.
  4. 특정 기능이 부족한 경우에만 상위 모델로 올립니다.

이 방식은 다음과 같은 경우에 사용할 수 있습니다.

  • 탐색적이거나 대량으로 처리하는 작업
  • 지연 시간 요구 사항이 엄격한 애플리케이션
  • 비용에 민감한 구현

문제 해결#

기본 모델이 아닌 모델을 선택할 때 다음과 같은 문제가 발생할 수 있습니다.

모델을 사용할 수 없음#

GitLab Duo AI 네이티브 기능에서 GitLab 기본 모델을 사용 중이라면, GitLab은 성능과 안정성을 유지하기 위해 사용자에게 알리지 않고 기본 모델을 변경할 수 있습니다.

GitLab Duo AI 네이티브 기능에 특정 모델을 선택했는데 그 모델을 사용할 수 없으면 자동 대체가 이뤄지지 않습니다. 해당 모델을 사용하는 기능은 사용할 수 없습니다.

체험판 중에는 프런티어 모델을 사용할 수 없음#

GitLab Duo Agent Platform 체험판을 사용 중이라면 일부 프런티어 모델은 체험판에 포함되지 않으므로 사용할 수 없습니다.

이를 해결하려면 다음 중 하나를 수행합니다.

자세한 내용은 GitLab Duo Agent Platform 체험판을 참고합니다.

기본 GitLab Duo 네임스페이스 없음#

모델을 선택한 상태로 GitLab Duo 기능을 사용할 때 기본 GitLab Duo 네임스페이스를 설정해야 한다는 오류가 표시될 수 있습니다.

이 문제는 GitLab Duo 네임스페이스에 여러 개 속해 있거나, GitLab 리모트가 구성되지 않은 프로젝트를 로컬에서 작업할 때 발생합니다.

이 문제를 해결하려면 기본 GitLab Duo 네임스페이스를 설정합니다.

IDE에서 에이전틱 Chat의 모델 선택이 작동하지 않음#

IDE에서 Agentic Chat의 모델을 선택할 때 모델 선택이 동작하지 않을 수 있습니다.

이 문제를 해결하려면 다음 단계를 따릅니다.

  1. IDE의 연결 유형이 WebSocket으로 설정되어 있는지 확인합니다.
  2. 네트워크 관리자에게 GitLab 인스턴스로의 WebSocket 트래픽이 허용되어 있는지 확인을 요청합니다.

Footnotes

  1. GitLab 19.0 이하에서 Code Review Flow는 비에이전틱 버전인 GitLab Duo Code Review에 설정된 기본 LLM을 사용합니다. ↩

  2. Business Logic Security Scan은 실험 기능입니다. bl_security_analyzer 기능 플래그가 활성화되어 있고 실험 및 베타 기능이 켜져 있을 때만 사용할 수 있습니다. ↩ ↩2

  3. GitLab 19.0 이하에서 Code Review Flow는 비에이전틱 버전인 GitLab Duo Code Review에 사용할 수 있는 모델만 사용할 수 있습니다. ↩

  4. 이 모델에는 공급업체 측 데이터 보존 제한이 적용됩니다. ↩ ↩2 ↩3 ↩4 ↩5 ↩6 ↩7 ↩8 ↩9 ↩10