VSCode에서 GitLab Duo 설정 가이드

Summary

VSCode에서 GitLab Duo 기능을 사용하기 위한 설정 방법을 안내합니다. 관련 GitLab 공식문서도 함께 참고부탁드립니다.

GitLab Workflow 확장 프로그램 설치

VSCode에서 GitLab Duo 기능을 사용하려면 GitLab Workflow라는 확장 프로그램을 설치해야 합니다.

  1. VSCode 확장 프로그램 마켓플레이스에서 GitLab Workflow 검색

  2. 확장 프로그램 설치

    image.png

GitLab 계정 연동

계정 등록 확인

설치 후 계정 연동 상태를 확인합니다. 아래와 같이 표시된다면 Add Account를 클릭해서 GitLab 계정을 등록해야 합니다.

image.png

image.png

계정 등록 시 GitLab Personal Access Token을 입력해야 합니다.

image.png

GitLab Personal Access Token 발급 방법

토큰 생성 경로

  1. 사내 GitLab > 좌측 상단 프로필 > Edit profile

    image.png

  2. Access Tokens > 토큰 생성 (Add new token)

    image.png

필요 권한 설정

GitLab Duo 사용을 위한 권한 설정:

  • 기한설정 : 최대 1년(self_rotate 활성화시 자동 갱신)
  • 기본 권한: api, read_user
  • Code Suggestions 기능: ai_features 권한 추가 필요
  • GitLab Agentic Chat (Beta) write 기능: write 권한 추가 필요

참고: GitLab Agentic Chat (Beta) 기능 중에는 직접 소스를 커밋하거나 이슈 페이지를 생성하는 기능이 포함되어 있으므로, write Agentic Chat 기능을 사용할 예정인 사용자는 write 권한까지 포함하여 토큰을 발급해야 합니다.

image.png

생성한 토큰을 복사합니다.

image.png

GitLab Duo 기능 활성화

GitLab Workflow > Settings에서 다음 기능들을 활성화합니다:

  • Duo Code Suggestion

  • Duo Chat

  • Duo Agent Platform

    image.png

image.png

설정 확인 및 디버그

로그 확인

VSCode에서 Debug 설정 후 로그를 확인하여 정상 동작을 검증할 수 있습니다.

image.png

설정 완료 확인

발급된 토큰을 입력하면 좌측에 GitLab Duo 아이콘이 표시됩니다.

설정이 완료되면 GitLab Duo User Guide를 참고하여 다양한 AI 기능을 활용할 수 있습니다.

image.png

주요 기능

설정 완료 후 다음과 같은 GitLab Duo 기능을 사용할 수 있습니다:

  • Code Suggestions: AI 기반 코드 자동 완성
  • Duo Chat: AI와의 대화형 코딩 지원
  • Duo Agent Platform: 고급 AI 에이전트 기능
Edited by SunJae Baek