설치 및 설정

Claude Code 설치

필수 조건

• 노드.js >= 18.x
• 유효한 Anthropic API 키

설치 단계

1. 클로드 코드 받기
2. 최신 버전을 받으려면 Claude Code 웹사이트를  방문하세요 .
3. API 키 설정
4.  

   export ANTHROPIC_API_KEY=your_api_key_here

5. 설치 확인
6.  

   claude --version

초기 구성

CLAUDE.md 파일 만들기

CLAUDE.md프로젝트 루트에 파일을 만듭니다 .

 

# CLAUDE.md This is my project configuration file that Claude will automatically read. ## Common Commands- npm run build: Build the project- npm run test: Run tests- npm run lint: Code linting ## Project Standards- Use TypeScript- Follow ESLint rules- Prefer functional components

도구 권한 구성

처음 실행 시 Claude Code가 도구 권한을 요청합니다. 권장 사항:

1. 항상 허용 :
   • Read- 파일 읽기
   • Write- 파일 쓰기
   • Bash(git *)- Git 명령어
2. 주의해서 사용하세요 :
   • Bash(rm *)- 명령 삭제
   • Bash(sudo *)- 관리자 권한

환경 변수

.bashrc또는 에 추가하세요 .zshrc:

 

# Claude Code Configurationexport CLAUDE_CONFIG_PATH="$HOME/.claude"export CLAUDE_DEFAULT_MODEL="claude-3-sonnet"

구성 확인

설정을 확인하려면 다음 명령을 실행하세요.

 

claude -p "Read the README.md file in current directory and summarize it"

모든 것이 올바르게 작동하면 Claude Code가 README 파일을 읽고 요약할 것입니다.

 

일반적인 문제

Q: API 키가 인식되지 않습니다.

답변: 환경 변수가 올바르게 설정되었는지 확인하고 터미널을 재시작한 후 다시 시도하세요.

질문: 허가 거부

답변: 파일 권한을 확인하고 Claude Code가 대상 디렉토리에 액세스할 수 있는지 확인하세요.

Q: 서비스에 접속할 수 없습니다

A: 네트워크 연결 및 API 서비스 상태를 확인하세요.