GitLab Duo AI 모델
GitLab v19.5Offering: GitLab.com
요약
모든 GitLab Duo 기능은 기본 모델을 사용합니다. 기능마다 다른 모델을 선택할 수 있으며, 선택한 모델은 변경할 때까지 유지됩니다. 다음 표는 각 GitLab Duo 기능의 기본 모델을 나열한 것입니다. 다음 표는 각 기능에 대해 선택할 수 있는 모델을 나열한 것입니다.
모든 GitLab Duo 기능은 기본 모델을 사용합니다. GitLab은 성능을 최적화하기 위해 기본 모델을 변경할 수 있습니다. 모델 변경은 GitLab AI Gateway에서 이루어지며 사용 중인 GitLab 버전과 관계없이 적용됩니다.
기능마다 다른 모델을 선택할 수 있으며, 선택한 모델은 변경할 때까지 유지됩니다.
기본 모델#
히스토리
- GitLab 19.4에서 GitLab Duo Code Review의 모델 설정이 Non-Agentic Code Review로 변경되었습니다.
다음 표는 각 GitLab Duo 기능의 기본 모델을 나열한 것입니다.
| 기능 | 모델 |
|---|---|
| Code Suggestions | |
| Code Generation | Claude Sonnet 4.6 Gemini Enterprise Agent Platform |
| Code Completion | Codestral 25.08 Fireworks |
| GitLab Duo Chat | |
| General Chat | Claude Sonnet 4.6 Gemini Enterprise Agent Platform |
| Code Explanation | Claude Sonnet 4.6 Gemini Enterprise Agent Platform |
| Test Generation | Claude Sonnet 4.6 Gemini Enterprise Agent Platform |
| Refactor Code | Claude Sonnet 4.6 Gemini Enterprise Agent Platform |
| Fix Code | Claude Sonnet 4.6 Gemini Enterprise Agent Platform |
| Root Cause Analysis | Claude Sonnet 4.6 Gemini Enterprise Agent Platform |
| GitLab Duo for merge requests | |
| Merge Commit Message Generation | Claude Sonnet 4.6 Gemini Enterprise Agent Platform |
| Merge Request Summary | Claude Sonnet 4.6 Gemini Enterprise Agent Platform |
| Code Review Summary | Claude Sonnet 4.6 Gemini Enterprise Agent Platform |
| Non-Agentic Code Review | Claude Sonnet 4.5 Gemini Enterprise Agent Platform |
| Other GitLab Duo features | |
| Vulnerability Explanation | Claude Sonnet 4.6 Gemini Enterprise Agent Platform |
| Vulnerability Resolution | Claude Sonnet 4.6 Gemini Enterprise Agent Platform |
| Discussion Summary | Claude Sonnet 4.6 Gemini Enterprise Agent Platform |
| GitLab Duo for CLI | Claude Sonnet 4.6 Gemini Enterprise Agent Platform |
지원되는 모델#
히스토리
- GitLab 19.4에서 GitLab Duo Code Review의 모델 설정이 Non-Agentic Code Review로 변경되었습니다.
다음 표는 각 기능에 대해 선택할 수 있는 모델을 나열한 것입니다.
Code Suggestions#
| 모델 | Code Generation | Code Completion |
|---|---|---|
| Claude Sonnet 4.5 | ✅ | ✅ |
| Codestral 25.01 Fireworks | ❌ | ✅ |
| Codestral 25.08 Fireworks | ❌ | ✅ |
| Codestral 25.08 Gemini Enterprise Agent Platform | ❌ | ✅ |
| Gemini 2.5 Flash Gemini Enterprise Agent Platform | ✅ | ❌ |
GitLab Duo 비에이전틱 Chat#
| 모델 | General Chat | Code Explanation | Test Generation | Refactor Code | Fix Code | Root Cause Analysis |
|---|---|---|---|---|---|---|
| Claude Haiku 4.5 | ✅ | ❌ | ❌ | |||
| Claude Sonnet 3 | ❌ | ❌ | ✅ | |||
| Claude Sonnet 4.5 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Claude Sonnet 4.5 Gemini Enterprise Agent Platform | ✅ | ✅ | ✅ | ✅ | ✅ | |
| Claude Sonnet 4.6 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Claude Sonnet 4.6 Gemini Enterprise Agent Platform | ✅ | ✅ | ✅ | ✅ | ✅ |
머지 리퀘스트용 GitLab Duo#
| 모델 | Merge Commit Message Generation | Merge Request Summary | Code Review Summary | Non-Agentic Code Review |
|---|---|---|---|---|
| Claude Sonnet 4.5 | ✅ | ✅ | ✅ | ✅ |
| Claude Sonnet 4.5 Gemini Enterprise Agent Platform | ❌ | ❌ | ❌ | ✅ |
| Claude Sonnet 4.6 | ❌ | ❌ | ❌ | ✅ |
| Claude Sonnet 4.6 Gemini Enterprise Agent Platform | ❌ | ❌ | ❌ | ✅ |
기타 GitLab Duo 기능#
| 모델 | Vulnerability Explanation | Vulnerability Resolution | GitLab Duo for CLI | Discussion Summary |
|---|---|---|---|---|
| Claude Haiku 4.5 | ❌ | ✅ | ❌ | |
| Claude Sonnet 4.5 | ✅ | ✅ | ✅ | ✅ |
| Claude Sonnet 4.5 Gemini Enterprise Agent Platform | ✅ | ✅ | ||
| Claude Sonnet 4.6 | ✅ | ✅ | ✅ | ✅ |
| Claude Sonnet 4.6 Gemini Enterprise Agent Platform | ✅ | ✅ |
기능에 대한 모델 선택#
히스토리
최상위 그룹에서 기능에 사용할 모델을 선택할 수 있습니다. 선택한 모델은 해당 기능에 대해 모든 하위 그룹과 프로젝트에 적용됩니다.
GitLab Self-Managed 또는 GitLab Dedicated에서 인스턴스 단위로 모델을 설정하려면 모델 선택을 참고합니다.
사전 요구 사항:
- 그룹의 Owner 권한이 있어야 합니다.
- 모델을 선택하는 그룹이 최상위 그룹이어야 합니다.
- GitLab 18.3 이상에서 여러 GitLab Duo 네임스페이스에 속해 있다면 기본 네임스페이스를 지정해야 합니다.
기능에 사용할 모델을 선택하려면 다음과 같이 진행합니다.
- 상단 바에서 Search or go to를 선택하고 그룹을 찾습니다.
- 왼쪽 사이드바에서 Settings > GitLab Duo를 선택합니다.
- Model selection 아래에서 Manage models를 선택합니다.
- 구성할 기능을 찾아 드롭다운 목록에서 모델을 선택합니다.
- 선택 사항. 섹션의 여러 기능에 모델을 적용하려면 Bulk update 드롭다운 목록에서 모델을 선택합니다. 모델은 호환되는 기능에만 적용됩니다.
- 선택 사항. 섹션의 모든 기능을 기본 모델로 되돌리려면 Reset to default를 선택합니다.
올바른 모델 선택#
많은 사용 사례에서는 Claude Haiku 4.5 나 GPT-5.4 Mini처럼 더 빠르고 비용 효율이 높은 모델로 시작하는 편이 좋습니다. 이 방식은 다음 순서로 진행합니다.
- Claude Haiku 4.5 또는 GPT-5.4 Mini를 선택합니다.
- 사용 사례를 충분히 테스트합니다.
- 성능이 요구 사항을 충족하는지 평가합니다.
- 특정 기능이 부족할 때만 상위 모델로 올립니다.
이 방식은 다음과 같은 경우에 사용할 수 있습니다.
- 탐색적이거나 처리량이 많은 작업
- 지연 시간 요건이 엄격한 애플리케이션
- 비용에 민감한 구현
문제 해결#
기본값이 아닌 모델을 선택하면 다음과 같은 문제가 발생할 수 있습니다.
모델을 사용할 수 없음#
GitLab Duo AI 네이티브 기능에서 GitLab 기본 모델을 사용한다면, GitLab은 최적의 성능과 안정성을 유지하기 위해 별도 고지 없이 기본 모델을 변경할 수 있습니다.
GitLab Duo AI 네이티브 기능에 특정 모델을 선택했는데 그 모델을 사용할 수 없으면 자동 대체는 이루어지지 않습니다. 해당 모델을 사용하는 기능은 사용할 수 없게 됩니다.
기본 GitLab Duo 네임스페이스 없음#
선택한 모델로 GitLab Duo 기능을 사용할 때 기본 GitLab Duo 네임스페이스를 설정해야 한다는 오류가 표시될 수 있습니다.
이 문제는 여러 GitLab Duo 네임스페이스에 속해 있거나, GitLab 원격이 구성되지 않은 프로젝트에서 로컬로 작업할 때 발생합니다.
이 문제를 해결하려면 기본 GitLab Duo 네임스페이스를 설정합니다.