Claude Code Windows 환경 구성

Windows 시스템에서 Claude Code 개발 환경을 구성하는 방법에 대한 자세한 가이드, Node.js 설치, 환경 변수 구성 등 포함.

Windows 시스템 요구 사항

  • Windows 10 이상
  • 관리자 권한 (소프트웨어 설치용)
  • 최소 2GB 사용 가능한 디스크 공간

Node.js 설치

방법 1: 공식 설치 패키지 (권장)

단계 1: Node.js 다운로드

Node.js 공식 웹사이트를 방문하여 LTS 버전의 Windows 설치 패키지(.msi 파일)를 다운로드하세요

단계 2: 설치 프로그램 실행

  1. 다운로드한 .msi 파일을 더블클릭
  2. "Next"를 클릭하여 설치 계속
  3. 라이선스 계약 수락
  4. 설치 경로 선택 (기본 경로 사용 권장)
  5. "Add to PATH" 옵션이 선택되어 있는지 확인
  6. "Install"을 클릭하여 설치 시작

단계 3: 설치 확인

명령 프롬프트(cmd) 또는 PowerShell을 열고 다음을 실행하세요:

cmd
node --version
npm --version

방법 2: Chocolatey 사용

PowerShell (관리자)
# Chocolatey 설치 (설치되지 않은 경우)
Set-ExecutionPolicy Bypass -Scope Process -Force
[System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072
iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))

# Node.js 설치
choco install nodejs

방법 3: Winget 사용

cmd
winget install OpenJS.NodeJS

환경 변수 구성

임시 구성 (현재 세션에서 유효)

set ANTHROPIC_BASE_URL=https://i7dc.com/api
set ANTHROPIC_AUTH_TOKEN=你的key
cd your-project-folder
claude

영구 구성 (권장)

방법 1: 시스템 속성을 통한 구성

  1. "내 PC"를 마우스 오른쪽 버튼으로 클릭 → "속성"
  2. "고급 시스템 설정"을 클릭
  3. "시스템 속성" 창에서 "환경 변수"를 클릭
  4. "사용자 변수" 또는 "시스템 변수"에서 "새로 만들기"를 클릭
  5. 다음 변수를 추가:
    • 변수 이름: ANTHROPIC_BASE_URL, 변수 값: https://i7dc.com/api
    • 변수 이름: ANTHROPIC_AUTH_TOKEN, 변수 값: 你的key
  6. "확인"을 클릭하여 저장

방법 2: PowerShell을 사용한 구성

PowerShell (관리자)
# 현재 사용자에 대한 환경 변수 설정
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://i7dc.com/api", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "你的key", "User")

# 설정 확인
[Environment]::GetEnvironmentVariable("ANTHROPIC_BASE_URL", "User")
[Environment]::GetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "User")

Windows Terminal 구성 (권장)

더 나은 사용 경험을 위해 Windows Terminal을 설치하는 것이 좋습니다:

PowerShell
# Microsoft Store를 통해 설치
winget install Microsoft.WindowsTerminal

# 또는 패키지 관리자를 통해 설치
choco install microsoft-windows-terminal

Windows Terminal 시작 프로필 구성

  1. Windows Terminal 열기
  2. Ctrl + ,를 눌러 설정 열기
  3. 왼쪽 메뉴에서 "프로필" → "새 프로필 추가" 선택
  4. 다음과 같이 구성:
    • 이름: Claude Code
    • 명령줄: powershell.exe
    • 시작 디렉토리: 你的项目目录
    • 고급 설정에서 환경 변수 추가

일반적인 문제 해결

문제 1: node 명령을 인식할 수 없음

해결 방법:

cmd
# PATH 환경 변수 확인
echo %PATH%

# Node.js를 PATH에 수동으로 추가 (임시)
set PATH=%PATH%;C:\Program Files\nodejs

문제 2: npm 설치 속도가 느림

해결 방법:

cmd
# 국내 미러 소스 사용
npm config set registry https://registry.npmmirror.com

문제 3: PowerShell 실행 정책 제한

해결 방법:

PowerShell (관리자)
# 스크립트 실행을 임시로 허용
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

# 영구 설정 (관리자 권한 필요)
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine

문제 4: 방화벽이 연결을 차단

해결 방법:

  1. Windows 방화벽 설정 열기
  2. "Windows 방화벽을 통한 앱 또는 기능 허용"을 클릭
  3. Node.js를 찾아 "개인" 및 "공용" 네트워크를 선택

구성 확인

구성을 완료한 후 명령 프롬프트 또는 PowerShell을 다시 시작하고 다음 명령을 실행하여 확인하세요:

cmd
echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%
claude --version

올바른 환경 변수 값과 버전 정보가 출력되면 구성이 성공한 것입니다!

다음 단계

환경 구성을 완료한 후 다음을 수행할 수 있습니다:

  1. 모든 프로젝트 디렉토리에서 claude를 실행하여 사용 시작
  2. 원하는 테마 선택
  3. 보안 알림을 확인하고 작업 디렉토리 신뢰
  4. AI 프로그래밍 파트너와 협업 시작!🚀
AI와 함께 무한한 혁신, 끝없는 기회
소개
기능 특성
사용 문서
가격 플랜
연락하기
약관 및 정책
이용 약관
개인정보 약관
특정 상거래법