문제 해결

해결 방법:

1. Claude Code가 올바르게 설치되었는지 확인:

   npm list -g @anthropic-ai/claude-code

2. PATH에 npm 전역 bin 디렉토리가 포함되어 있는지 확인:

   echo $PATH
   npm config get prefix

3. PATH에 추가 (bash/zsh):

   echo 'export PATH="$(npm config get prefix)/bin:$PATH"' >> ~/.bashrc
   source ~/.bashrc

해결 방법:

# npm 전역 디렉토리 변경
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

# 다시 설치
npm install -g @anthropic-ai/claude-code

해결 방법:

1. API 키가 올바르게 설정되었는지 확인:

   echo $ANTHROPIC_API_KEY

2. API 키에 공백이나 특수 문자가 포함되지 않았는지 확인
3. 새로운 API 키 발급:
   • Claude Console에 로그인
   • API Keys 섹션으로 이동
   • 새 키 생성
4. 환경 변수 재설정:

   export ANTHROPIC_API_KEY="sk_your_new_api_key"

해결 방법:

• 현재 사용량 확인:

  claude usage --current

• 요청 간격 조정:

  claude config set rate-limit-delay 1000

• 더 높은 한도가 필요한 경우 플랜 업그레이드 고려

해결 방법:

1. 네트워크 연결 확인:

   ping api.anthropic.com
   curl -I https://api.anthropic.com

2. 프록시 설정 확인:

   echo $HTTP_PROXY
   echo $HTTPS_PROXY

3. 프록시 사용 시:

   claude --proxy http://proxy.company.com:8080

4. 타임아웃 값 증가:

   claude config set timeout 60000

해결 방법:

• 시스템 시간이 정확한지 확인
• 기업 프록시 사용 시 CA 인증서 설치:

  export NODE_EXTRA_CA_CERTS=/path/to/ca-cert.pem

• 임시 해결책 (권장하지 않음):

  export NODE_TLS_REJECT_UNAUTHORIZED=0

해결 방법:

• 컨텍스트 크기 최적화:

  > 현재 컨텍스트 사용량을 보여줘
  claude config set max-context 50000

• 불필요한 파일 제외:

  {
    "files": {
      "exclude": [
        "node_modules/**",
        "*.log",
        "dist/**"
      ]
    }
  }

• 더 빠른 모델 사용:

  claude --model claude-3-haiku

해결 방법:

• Node.js 메모리 한도 증가:

  export NODE_OPTIONS="--max-old-space-size=4096"

• 대화 히스토리 초기화:

  > /reset

• 작업을 더 작은 단위로 분할

해결 방법:

• 현재 작업 디렉토리 확인:

  pwd
  > 현재 디렉토리를 보여줘

• 파일 권한 확인:

  ls -la file.txt

• .gitignore나 설정에서 제외되지 않았는지 확인
• 심볼릭 링크 처리 설정:

  {
    "files": {
      "followSymlinks": true
    }
  }

해결 방법:

• Git 설정 확인:

  git config --list
  git status

• Git 권한 확인:

  ssh -T git@github.com

• Claude Code에 Git 도구 권한 부여:

  claude --allowedTools "Bash(git:*)"