GitLab for VS Code를 사용할 때 다음과 같은 문제가 발생할 수 있습니다.

아래에서 문제가 해결되지 않으면 지원에 필요한 정보를 수집하여 gitlab-vscode-extension 이슈 트래커에 버그를 보고하세요.

로그#

GitLab for VS Code 확장 프로그램과 확장 프로그램을 구동하는 GitLab Language Server 모두 문제 해결에 도움이 되는 로그를 제공합니다.

디버그 로그 활성화#

디버그 로깅을 활성화하려면:

• VS Code에서 Settings 편집기를 엽니다:

  macOS: Command+,를 누릅니다.

• Windows 또는 Linux: Control+,를 누릅니다.

• Extensions > GitLab > Other를 선택합니다.

• GitLab: Debug 아래에서 체크박스를 선택하여 디버그 모드를 켭니다.

• 창을 다시 로드하여 확장 프로그램을 재시작합니다.

  Command Palette를 엽니다:

  macOS: Command+Shift+P를 누릅니다.

• Windows 또는 Linux: Control+Shift+P를 누릅니다.

• Developer: Reload Window를 입력하고 Enter를 누릅니다.

디버그 로그 보기#

디버그 로그를 보려면:

• VS Code에서 View > Output을 선택합니다.

• 출력 패널의 오른쪽 상단 모서리에서 드롭다운 목록을 선택하여 GitLab 또는 GitLab Language Server 로그로 필터링합니다.

• 오류, 경고, 연결 문제 또는 인증 문제를 확인합니다.

인증#

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

오류: ...OS Keychain에 접근할 수 없음#

macOS와 Ubuntu에서 확장 프로그램이 인증을 위해 OS Keychain에 접근할 수 없을 때 오류가 발생할 수 있습니다.

예시:

The GitLab extension can't access the OS Keychain.
If you use Ubuntu, see this existing issue.

Error: Cannot get password
at I.$getPassword (vscode-file://vscode-app/snap/code/97/usr/share/code/resources/app/out/vs/workbench/workbench.desktop.main.js:1712:49592)

운영 체제에 맞는 아래 해결 방법을 따르세요.

이 오류에 대한 자세한 내용은 다음을 참조하세요:

• Extension issue 580

• Upstream microsoft/vscode issue 147515

macOS 해결 방법#

macOS에서 이 오류를 해결하려면:

• 머신에서 Keychain Access를 열고 vscodegitlab.gitlab-workflow를 검색합니다.

• 키체인에서 vscodegitlab.gitlab-workflow를 삭제합니다.

• Command+Shift+P를 눌러 Command Palette를 엽니다.

• GitLab: Remove Account from VS Code를 입력하고 Enter를 눌러 VS Code에서 손상된 계정을 제거합니다.

• Command Palette를 다시 열고 GitLab: Authenticate를 실행하여 계정을 다시 추가합니다.

Ubuntu 해결 방법#

Ubuntu 20.04 및 22.04에서 snap으로 VS Code를 설치하면 VS Code가 OS 키체인에서 비밀번호를 읽을 수 없습니다. 확장 프로그램 버전 3.44.0 이상은 보안 토큰 저장을 위해 OS 키체인을 사용합니다.

VS Code 버전 1.68.0보다 이전 버전을 사용하는 경우 다음 해결 방법 중 하나를 시도하세요:

• GitLab for VS Code 확장 프로그램을 버전 3.43.1로 다운그레이드합니다.

• snap 대신 .deb 패키지에서 VS Code를 설치합니다:

  snap VS Code를 제거합니다.

• .deb 패키지에서 VS Code를 설치합니다.

• Ubuntu의 Password & Keys로 이동하여 vscodegitlab.workflow/gitlab-tokens 항목을 찾아 제거합니다.

• VS Code에서 Control+Shift+P를 눌러 Command Palette를 엽니다.

• Gitlab: Remove Your Account를 입력하고 Enter를 눌러 자격 증명이 없는 계정을 제거합니다.

• Command Palette를 다시 열고 GitLab: Authenticate를 실행하여 계정을 다시 추가합니다.

VS Code 버전 1.68.0 이상을 사용하는 경우 재인증을 시도하세요:

• Ubuntu의 Password & Keys로 이동하여 vscodegitlab.workflow/gitlab-tokens 항목을 찾아 제거합니다.

• VS Code에서 Control+Shift+P를 눌러 Command Palette를 엽니다.

• Gitlab: Remove Your Account를 입력하고 Enter를 눌러 자격 증명이 없는 계정을 제거합니다.

• Command Palette를 다시 열고 GitLab: Authenticate를 실행하여 계정을 다시 추가합니다.

GDK 사용 시 연결 및 인가 오류#

VS Code와 GDK를 함께 사용할 때 시스템이 localhost에서 실행 중인 GitLab 인스턴스에 보안 TLS 연결을 설정할 수 없다는 오류가 발생할 수 있습니다.

예를 들어, GitLab 서버로 127.0.0.1:3000을 사용하는 경우:

Request to https://127.0.0.1:3000/api/v4/version failed, reason: Client network
socket disconnected before secure TLS connection was established

이 문제는 GDK를 http에서 실행하고 GitLab 인스턴스가 https에서 호스팅되는 경우에 발생합니다.

이를 해결하려면:

• Command Palette를 엽니다:

  macOS: Command+Shift+P를 누릅니다.

• Windows 또는 Linux: Control+Shift+P를 누릅니다.

• GitLab: Authenticate를 입력하고 Enter를 누릅니다.

• 인스턴스의 http URL을 수동으로 입력하는 옵션을 선택하고 Enter를 누릅니다.

• 나머지 프롬프트에 따라 인증을 완료합니다.

프로젝트 구성#

다음과 같은 프로젝트 구성 오류가 발생할 수 있습니다.

계정 및 프로젝트 구성 오류#

VS Code에서 프로젝트를 열면 GitLab(tanuki) 탭의 프로젝트 이름 옆에 오류 메시지가 표시될 수 있습니다. 또는 상태 표시줄에 여러 계정이나 프로젝트에 대한 경고 메시지가 표시될 수 있습니다.

이 메시지는 확장 프로그램이 사용할 리포지터리, 계정 또는 프로젝트를 식별할 수 없을 때 나타납니다.

이 오류를 해결하려면:

• 원격 저장소가 정의되지 않았거나 여러 원격 저장소가 구성된 경우 리포지터리에 연결을 참조하세요.

• 상태 표시줄에 Multiple GitLab Accounts가 표시되는 경우 계정을 전환하세요.

• 상태 표시줄에 **(multiple projects)**가 표시되는 경우 프로젝트를 선택하세요.

VS Code에서 Git을 처음 사용하는 경우 리포지터리 초기화 및 VS Code 워크스페이스에 대한 정보는 VS Code의 소스 제어를 참조하세요. 이 작업은 GitLab 확장 프로그램 외부에서 수행됩니다.

SSH 사용자 정의 별칭이 있는 Git 원격 저장소#

리포지터리 원격 저장소가 SSH 사용자 정의 별칭을 사용하는 경우 확장 프로그램이 리포지터리를 GitLab 프로젝트와 올바르게 매칭하지 못할 수 있습니다. 예를 들어, 원격 저장소가 git@gitlab.com:group/project.git 대신 git@my-work-gitlab:group/project.git을 사용하는 경우입니다.

이 문제를 해결하려면:

• 원격 저장소를 HTTP를 사용하도록 변경하거나 사용자 정의 별칭 없이 SSH를 사용합니다.

• 확장 프로그램에서 기본 GitLab Duo 네임스페이스를 구성합니다.

기본 네임스페이스를 구성하려면:

• 프로젝트가 속한 네임스페이스를 확인합니다.

• VS Code에서 Settings 편집기를 엽니다:

  macOS: Command+,를 누릅니다.

• Windows 또는 Linux: Control+,를 누릅니다.

• Extensions > GitLab > GitLab Duo를 선택합니다.

• GitLab › Duo Agent Platform: Default Namespace 아래에 네임스페이스를 입력합니다.

HTTPS 프로젝트 클론은 작동하지만 SSH 클론이 실패하는 경우#

HTTPS 클론은 작동하지만 SSH 클론 오류가 발생할 수 있습니다. 이는 SSH URL 호스트 또는 경로가 HTTPS 경로와 다를 때 발생합니다.

GitLab for VS Code 확장 프로그램은 다음을 사용합니다:

• 설정한 계정을 매칭하기 위해 호스트를 사용합니다.

• 네임스페이스와 프로젝트 이름을 가져오기 위해 경로를 사용합니다.

예를 들어, VS Code 확장 프로그램 프로젝트의 URL은 다음과 같습니다:

• SSH: git@gitlab.com:gitlab-org/gitlab-vscode-extension.git

• HTTPS: https://gitlab.com/gitlab-org/gitlab-vscode-extension.git

두 URL 모두 gitlab.com 호스트와 gitlab-org/gitlab-vscode-extension 경로를 가집니다.

이 오류를 해결하려면:

• SSH URL이 다른 호스트에 있는지 또는 경로에 추가 세그먼트가 있는지 확인합니다.

• 둘 중 하나라도 해당하는 경우 Git 리포지터리를 GitLab 프로젝트에 수동으로 할당합니다:

  VS Code의 왼쪽 사이드바에서 GitLab(tanuki)을 선택합니다.

• (no GitLab project)로 표시된 프로젝트를 선택한 다음 Manually assign GitLab project를 선택합니다:

• 목록에서 올바른 프로젝트를 선택합니다.

이 프로세스를 단순화하는 방법에 대한 자세한 내용은 gitlab-vscode-extension 프로젝트의 issue 577을 참조하세요.

네트워크 및 연결#

다음과 같은 네트워크 및 연결 오류가 발생할 수 있습니다.

오류: 프록시를 사용할 때 407 Access Denied 실패#

인증된 프록시를 사용하는 경우 407 Access Denied (authentication_failed) 오류가 발생할 수 있습니다.

예시:

Request failed: Can't add GitLab account for https://gitlab.com. Check your instance URL and network connection.
Fetching resource from https://gitlab.com/api/v4/personal_access_tokens/self failed

이 오류를 해결하려면 GitLab Language Server의 프록시 인증을 활성화하세요.

사용자 정의 인증서 오류#

자체 서명 인증서와 같은 사용자 정의 인증서를 사용하여 GitLab 인스턴스에 연결하는 경우 오류가 발생할 수 있습니다.

이러한 오류는 인증서에 다음 설정이 사용되는 경우 발생할 수 있습니다:

해결 방법은 사용자 정의 Certificate Authorities에 대한 확장 프로그램 구성을 참조하세요.

만료된 SSL 인증서#

잘못된 SSL 인증서 만료 오류가 발생할 수 있습니다. 예시:

API request failed - Error: certificate has expired

이 오류를 해결하려면 시스템 인증서를 비활성화하세요:

• VS Code에서 Settings 편집기를 엽니다:

  macOS: Command+,를 누릅니다.

• Windows 또는 Linux: Control+,를 누릅니다.

• User 설정 탭에서 Application > Proxy를 선택합니다.

• Proxy Strict SSL 및 System Certificates 설정을 비활성화합니다.

GitLab Duo#

VS Code에서 GitLab Duo를 사용할 때 다음과 같은 문제가 발생할 수 있습니다.

GitLab Duo 기능을 사용할 수 없음#

VS Code에서 GitLab Duo 오류를 해결하려면:

• 필수 요건을 충족하고 필요한 설정이 켜져 있는지 확인합니다.

• Admin 모드가 비활성화되어 있는지 확인합니다.

• 진단 출력을 검토합니다:

  VS Code에서 Command Palette를 엽니다:

  macOS: Command+Shift+P를 누릅니다.

• Windows 또는 Linux: Control+Shift+P를 누릅니다.

• GitLab: Diagnostics 명령을 실행하고 실패한 검사에 대한 출력을 검토합니다.

• 진단에서 기능이 켜져 있지 않다고 표시되는 경우:

  VS Code에서 Settings 편집기를 엽니다:

  macOS: Command+,를 누릅니다.

• Windows 또는 Linux: Control+,를 누릅니다.

• Extensions > GitLab > GitLab Duo를 선택합니다.

• 누락된 기능의 GitLab › 섹션을 찾아 체크박스를 선택하여 켭니다.

• 진단에서 현재 프로젝트에 대해 Agentic Chat이 지원되지 않는다고 표시되는 경우 기본 GitLab Duo 네임스페이스를 설정합니다.

• 진단에서 모든 Agentic Chat 검사를 통과했는데도 패널이 보이지 않는 경우 사용자 정의 VS Code 레이아웃에서 숨겨져 있을 수 있습니다.

  VS Code에서 Command Palette를 엽니다:

  macOS: Command+Shift+P를 누릅니다.

• Windows 또는 Linux: Control+Shift+P를 누릅니다.

• View: Show GitLab Duo Agent Platform 또는 View: Toggle GitLab Duo Agent Platform 명령을 실행합니다.

Code Suggestions 지원은 Code Suggestions 문제 해결을 참조하세요.

GitLab Duo가 WebSocket 엔드포인트 대신 HTTP/1.1 응답을 반환함#

로그에서 /-/cable WebSocket 엔드포인트 대신 GitLab Duo의 HTTP/1.1 응답이 표시될 수 있습니다.

이는 GitLab 인스턴스가 WebSocket 연결을 차단할 때 발생합니다.

이 오류를 해결하려면 네트워크 관리자에게 GitLab 인스턴스에서 IDE 클라이언트의 인바운드 WebSocket 연결을 허용하도록 수정을 요청하세요.

원격 환경에서 GitLab Duo Chat 초기화 실패#

브라우저 기반 VS Code 또는 원격 SSH 연결과 같은 원격 개발 환경에서 GitLab Duo Chat을 사용할 때 다음과 같은 초기화 실패가 발생할 수 있습니다:

• 비어 있거나 로드되지 않는 Chat 패널.

• 로그의 오류(예: The webview didn't initialize in 10000ms).

• 확장 프로그램이 접근할 수 없는 로컬 URL에 연결을 시도합니다.

이 오류를 해결하려면:

• VS Code에서 Settings 편집기를 엽니다:

  macOS: Command+,를 누릅니다.

• Windows 또는 Linux: Control+,를 누릅니다.

• 오른쪽 상단 모서리에서 **Open Settings (JSON)**을 선택하여 settings.json 파일을 편집합니다.

• 다음 설정을 추가하거나 수정합니다:

"gitlab.featureFlags.languageServerWebviews": false

• 변경 사항을 저장하고 창을 다시 로드합니다:

  Command Palette를 엽니다:

  macOS: Command+Shift+P를 누릅니다.

• Windows 또는 Linux: Control+Shift+P를 누릅니다.

• Developer: Reload Window를 입력하고 Enter를 누릅니다.

영구적인 해결책에 대한 업데이트는 issue #1944 및 Issue #1943을 참조하세요.

GitLab Duo 명령이 실패하거나 무한 실행되는 경우#

VS Code에서 GitLab Duo Agentic Chat 또는 Software Development Flow를 사용할 때 GitLab Duo가 루프에 걸리거나 명령 실행에 어려움을 겪을 수 있습니다.

이 문제는 Oh My ZSH! 또는 powerlevel10k와 같은 셸 테마나 통합을 사용할 때 발생할 수 있습니다. GitLab Duo 에이전트가 터미널을 생성하면 셸 테마나 통합이 명령의 올바른 실행을 방해할 수 있습니다.

해결 방법으로 아래 지침에 따라 에이전트가 보내는 명령에 더 단순한 테마를 사용하세요.

수정에 대한 자세한 내용은 issue 2116을 참조하세요.

.zshrc 파일 편집#

VS Code에서 에이전트가 보내는 명령을 실행할 때 Oh My ZSH! 또는 powerlevel10k가 더 단순한 테마를 사용하도록 구성합니다. IDE에서 노출하는 환경 변수를 사용하여 이 값을 설정할 수 있습니다.

~/.zshrc 파일을 편집하여 다음 코드를 포함합니다:

# ~/.zshrc

# Path to your oh-my-zsh installation
export ZSH="$HOME/.oh-my-zsh"

# ...

# Decide whether to load a full terminal environment,
# or keep it minimal for agentic AI in IDEs
if [[ "$TERM_PROGRAM" == "vscode" ]]; then
  echo "IDE agentic environment detected, not loading full shell integrations"
else
  # Oh My ZSH
  source $ZSH/oh-my-zsh.sh
  # Theme: Powerlevel10k
  [[ ! -f ~/.p10k.zsh ]] || source ~/.p10k.zsh
  # Other integrations like syntax highlighting
fi

# Other setup, like PATH variables

Bash 셸 편집#

VS Code에서 Bash의 고급 프롬프트를 끌 수 있습니다.

~/.bashrc 또는 ~/.bash_profile 파일을 편집하여 다음 코드를 포함합니다:

# ~/.bashrc or ~/.bash_profile

# Decide whether to load a full terminal environment,
# or keep it minimal for Agentic AI in IDEs
if [[ "$TERM_PROGRAM" == "vscode" ]]; then
  echo "IDE agentic environment detected, not loading full shell integrations"

  # Keep only essential settings for agents
  export PS1='\$ '  # Minimal prompt

else
  # Load full Bash environment

  # Custom prompt (e.g., Starship, custom PS1)
  if command -v starship &> /dev/null; then
    eval "$(starship init bash)"
  else
    # ... Add your own PS1 variable
  fi

  # Load additional integrations
fi

# Always load essential environment variables and aliases

지원에 필요한 정보#

지원팀에 문의하기 전에 최신 GitLab for VS Code 확장 프로그램이 설치되어 있는지 확인하세요.

VS Code Marketplace의 Version History 탭에서 최신 릴리즈를 확인하세요.

영향을 받는 사용자에게서 다음 정보를 수집하여 버그 보고서에 제공하세요:

• 사용자에게 표시된 오류 메시지.

• GitLab 및 GitLab Language Server 로그.

• 진단 출력.

  Command Palette를 엽니다:

  macOS: Command+Shift+P를 누릅니다.

• Windows 또는 Linux: Control+Shift+P를 누릅니다.

• GitLab: Diagnostics를 입력하고 Enter를 누릅니다.

• 확장 프로그램 버전을 메모합니다.

• 시스템 정보:

  VS Code에서 OS 세부 정보:

  macOS: Code > About Visual Studio Code로 이동하여 OS를 찾습니다.

• Windows 또는 Linux: Help > About으로 이동하여 OS를 찾습니다.

• 머신 사양(CPU, RAM): 머신에서 이 정보를 제공합니다. IDE에서는 접근할 수 없습니다.

• 영향 범위를 설명합니다. 몇 명의 사용자가 영향을 받습니까?

• 오류를 재현하는 방법을 설명합니다. 가능하면 화면 녹화를 포함합니다.

• 다른 GitLab Duo 기능이 어떻게 영향을 받는지 설명합니다:

  GitLab Quick Chat이 작동합니까?

• Code Suggestions가 작동합니까?

• Web IDE의 GitLab Duo Chat이 응답을 반환합니까?

• GitLab for VS Code 확장 프로그램 격리 가이드에 설명된 대로 확장 프로그램 격리 테스트를 수행합니다. 다른 확장 프로그램이 문제를 일으키는지 확인하기 위해 다른 모든 확장 프로그램을 비활성화(또는 제거)해 보세요.