클로드코드101/시작하기
설치 및 설정
러스트코리아
2025. 8. 12. 09:23
반응형
Claude Code 설치
필수 조건
- 노드.js >= 18.x
- 유효한 Anthropic API 키
설치 단계
- 클로드 코드 받기
- 최신 버전을 받으려면 Claude Code 웹사이트를 방문하세요 .
- API 키 설정
-
export ANTHROPIC_API_KEY=your_api_key_here - 설치 확인
-
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가 도구 권한을 요청합니다. 권장 사항:
- 항상 허용 :
- Read- 파일 읽기
- Write- 파일 쓰기
- Bash(git *)- Git 명령어
- 주의해서 사용하세요 :
- 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 서비스 상태를 확인하세요.

반응형