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

이 요약은 AI가 원문을 분석해 생성했습니다. 정확한 내용은 원문 기준으로 확인하세요.

핵심 요약

Windows에서 Claude Code의 OAuth 인증 실패 문제를 해결하기 위해 API 키를 환경 변수로 직접 등록하고 설정 파일을 수정하는 구체적인 기술적 절차를 제시한다.

배경

Windows 사용자가 Claude Code 확장 프로그램 사용 시 OAuth 인증이 방화벽에 막히거나 설정 파일 충돌로 로그인이 반복되는 문제를 해결하기 위해 API 키 기반의 수동 설정 방법을 공유했다.

의미 / 영향

Windows의 네트워크 보안 정책이 AI 에이전트 도구의 로컬 인증 과정에 간섭할 수 있음을 보여준다. 커뮤니티는 복잡한 OAuth 대신 명시적인 API 키 설정과 환경 변수 구성을 더 신뢰할 수 있는 대안으로 수용하고 있다.

커뮤니티 반응

사용자들은 OAuth 방식의 불안정성에 공감하며, 제시된 API 키 기반의 수동 설정 방법이 실질적인 해결책이 되었다는 반응을 보였다.

주요 논점

01찬성다수

네트워크 보안 정책이 엄격한 Windows 환경에서는 자동 OAuth보다 수동 API 키 설정이 더 확실한 방법이다.

합의점 vs 논쟁점

합의점

Windows 방화벽이 로컬 호스트로의 인증 토큰 전달을 방해한다는 점
CLI와 확장 프로그램 간의 설정 파일 공유가 인증 충돌을 일으킨다는 점

실용적 조언

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 키를 사용자 환경 변수로 영구 등록하는 명령어

실무 Takeaway

Windows 환경의 Claude Code 로그인 오류는 주로 방화벽의 OAuth 콜백 차단과 설정 파일(~/.claude.json) 충돌로 인해 발생한다.
OAuth 대신 Anthropic API 키를 직접 발급받아 환경 변수로 등록하는 것이 가장 안정적인 해결책이다.
VS Code settings.json 설정 시 claude-code.environmentVariables 값을 배열([])이 아닌 객체({}) 형식으로 작성해야 정상 인식된다.
시스템 환경 변수 등록 후에는 반드시 VS Code를 재시작해야 변경된 인증 정보가 반영된다.

언급된 도구

Claude Code추천

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

VS Code중립

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

언급된 리소스

API DocsAnthropic Console API Keys