Windows 환경에서 Claude Code 확장 프로그램 로그인 오류 해결 가이드

실용적 조언

OAuth 로그인이 반복된다면 Anthropic Console에서 API 키를 새로 생성하여 사용하세요.
settings.json 수정 시 JSON 문법(객체 형태)을 정확히 지켜야 설정이 무시되지 않습니다.
환경 변수 설정 후에는 통합 터미널뿐만 아니라 VS Code 전체를 껐다 켜야 합니다.

섹션별 상세

Windows 방화벽과 백신 프로그램이 15초 타임아웃 이전에 OAuth 콜백을 차단하여 인증 토큰 수신이 실패하는 현상이 발생한다. 브라우저에서 인증을 완료해도 확장 프로그램이 이를 인지하지 못해 로그인 요청이 반복되는 구조적 한계가 확인됐다.

bash

npm install -g /claude-code

Claude Code CLI 도구를 전역으로 설치하는 명령어

Claude Code 확장 프로그램과 CLI 도구가 동일한 ~/.claude.json 파일을 공유하면서 서로의 자격 증명을 덮어쓰는 충돌이 발생한다. 이로 인해 한 쪽에서 로그인하면 다른 쪽의 인증 정보가 초기화되는 현상이 나타나므로 별도의 인증 방식이 필요하다.

문제를 해결하기 위해 OAuth 대신 Anthropic 콘솔에서 생성한 API 키를 직접 사용하는 방식이 권장된다. VS Code의 settings.json 내 claude-code.environmentVariables 항목에 객체 형식으로 API 키를 입력해야 하며, 배열 형식을 사용할 경우 작동하지 않는다.

json

"claude-code.environmentVariables": {
  "ANTHROPIC_API_KEY": "sk-ant-your-key-here"
}

VS Code settings.json에서 API 키를 객체 형식으로 설정하는 방법

설정을 영구적으로 유지하기 위해 PowerShell 명령어를 사용하여 시스템 환경 변수에 ANTHROPIC_API_KEY를 등록하는 단계가 포함된다. [System.Environment]::SetEnvironmentVariable 메서드를 통해 사용자 레벨에서 변수를 설정한 후 VS Code를 완전히 재시작해야 변경 사항이 적용된다.

powershell

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_API_KEY", "sk-ant-your-key", "User")

PowerShell을 사용하여 API 키를 사용자 환경 변수로 영구 등록하는 명령어

용어 해설

오픈 인증(OAuth): — 사용자가 비밀번호를 직접 공유하지 않고 제3자 애플리케이션에 권한을 부여하는 표준 프로토콜이다. 이 게시물에서는 브라우저 인증 후 토큰을 로컬 도구로 전달하는 과정이 Windows 방화벽에 의해 차단되는 문제의 원인으로 지목됐다.
API 키(API Key): — 애플리케이션이 특정 API 서비스에 접근할 때 신원을 확인하고 권한을 증명하기 위해 사용하는 고유 식별 코드이다. 네트워크 환경 문제로 OAuth 인증이 실패할 때 직접적인 인증 수단으로 활용되어 안정적인 연결을 보장한다.
환경 변수(Environment Variable): — 운영 체제 수준에서 프로세스가 참조할 수 있도록 저장된 동적 값이다. API 키와 같은 설정 정보를 시스템 전역 또는 사용자 세션에 저장하여 애플리케이션이 실행될 때마다 자동으로 해당 정보를 읽어올 수 있게 한다.

언급된 도구

Claude Code추천

Anthropic의 AI 코딩 에이전트 및 CLI 도구

VS Code중립

확장 프로그램이 실행되는 코드 편집기 환경

언급된 리소스

API DocsAnthropic Console API Keys