Claude Code 설정
개발 머신에서 Claude Code를 설치, 인증 및 사용을 시작하세요.
시스템 요구사항
- 운영 체제: macOS 10.15+, Ubuntu 20.04+/Debian 10+, 또는 Windows 10+ (WSL 1, WSL 2, 또는 Git for Windows 포함)
- 하드웨어: 4GB+ RAM
- 소프트웨어: Node.js 18+
- 네트워크: 인증 및 AI 처리를 위한 인터넷 연결 필요
- 셸: Bash, Zsh 또는 Fish에서 최적으로 작동
- 위치: Anthropic 지원 국가
표준 설치
To install Claude Code, run the following command:
권한 문제와 보안 위험을 초래할 수 있으므로 sudo npm install -g
를 사용하지 마세요.
권한 오류가 발생하면 권장 해결책은 Claude Code 구성을 참조하세요.
일부 사용자는 개선된 설치 방법으로 자동 마이그레이션될 수 있습니다.
설치 후 claude doctor
를 실행하여 설치 유형을 확인하세요.
설치 과정이 완료된 후, 프로젝트로 이동하여 Claude Code를 시작하세요:
Claude Code는 다음과 같은 인증 옵션을 제공합니다:
- Anthropic Console: 기본 옵션입니다. Anthropic Console을 통해 연결하고 OAuth 과정을 완료하세요. console.anthropic.com에서 활성 결제가 필요합니다.
- Claude App (Pro 또는 Max 플랜 포함): Claude Code와 웹 인터페이스를 모두 포함하는 통합 구독을 위해 Claude의 Pro 또는 Max 플랜을 구독하세요. 동일한 가격대에서 더 많은 가치를 얻으면서 한 곳에서 계정을 관리할 수 있습니다. Claude.ai 계정으로 로그인하세요. 시작 시 구독 유형과 일치하는 옵션을 선택하세요.
- 엔터프라이즈 플랫폼: 기존 클라우드 인프라를 사용한 엔터프라이즈 배포를 위해 Amazon Bedrock 또는 Google Vertex AI를 사용하도록 Claude Code를 구성하세요.
Claude Code는 자격 증명을 안전하게 저장합니다. 자세한 내용은 자격 증명 관리를 참조하세요.
Windows 설정
옵션 1: WSL 내에서 Claude Code
- WSL 1과 WSL 2 모두 지원됩니다
옵션 2: Git Bash를 사용한 네이티브 Windows에서 Claude Code
- Git for Windows가 필요합니다
- 포터블 Git 설치의 경우
bash.exe
경로를 지정하세요:
대체 설치 방법
Claude Code는 다양한 환경에 맞는 여러 설치 방법을 제공합니다.
설치 중 문제가 발생하면 문제 해결 가이드를 참조하세요.
설치 후 claude doctor
를 실행하여 설치 유형과 버전을 확인하세요.
전역 npm 설치
위의 설치 단계에 표시된 전통적인 방법
네이티브 바이너리 설치 (베타)
Claude Code의 기존 설치가 있는 경우 claude install
을 사용하여 네이티브 바이너리 설치를 시작하세요.
새로 설치하는 경우 다음 명령을 실행하세요:
macOS, Linux, WSL:
Windows PowerShell:
네이티브 Claude Code 설치 프로그램은 macOS, Linux 및 Windows에서 지원됩니다.
오래된 별칭이나 심볼릭 링크를 제거했는지 확인하세요.
설치가 완료되면 claude doctor
를 실행하여 설치를 확인하세요.
로컬 설치
- npm을 통한 전역 설치 후
claude migrate-installer
를 사용하여 로컬로 이동 - 자동 업데이터 npm 권한 문제 방지
- 일부 사용자는 이 방법으로 자동 마이그레이션될 수 있습니다
AWS 또는 GCP에서 실행
기본적으로 Claude Code는 Anthropic의 API를 사용합니다.
AWS 또는 GCP에서 Claude Code 실행에 대한 자세한 내용은 서드파티 통합을 참조하세요.
Claude Code 업데이트
자동 업데이트
Claude Code는 최신 기능과 보안 수정 사항을 제공하기 위해 자동으로 최신 상태를 유지합니다.
- 업데이트 확인: 시작 시 및 실행 중 주기적으로 수행
- 업데이트 과정: 백그라운드에서 자동으로 다운로드 및 설치
- 알림: 업데이트가 설치되면 알림을 받게 됩니다
- 업데이트 적용: 다음에 Claude Code를 시작할 때 업데이트가 적용됩니다
자동 업데이트 비활성화: