Claude Code 에러 해결법 — 에러가 나도 당황하지 않는 법
Claude Code를 처음 쓴 날, 나는 에러를 7번 만났다. Blogger API 연결에서 OAuth 인증 실패, Threads API에서 403 응답, npm 설치에서 EACCES 권한 오류. 8년 차 개발자도 새로운 도구 앞에서는 초보자다. 그런데 에러 해결에 쓴 시간은 총 20분이었다. 에러 메시지를 Claude Code에게 그대로 붙여넣었더니 알아서 고쳤기 때문이다. 실제로 겪은 에러 5가지와 해결 과정을 정리한다.
에러에 대한 마인드셋
에러 = 실패가 아니다.
에러 = “이 부분이 안 돼요”라고 컴퓨터가 말하는 것이다.
해결 방법은 단순하다:
에러 메시지를 복사해서 Claude Code에게 붙여넣는다.
“이 에러 해결해줘”
끝이다.
에러 1: npm: command not found
언제: Claude Code 설치 시
원인: Node.js가 설치 안 됨
해결:
# Mac
brew install node
# Windows
https://nodejs.org에서 다운로드
에러 2: EACCES permission denied
언제: npm install -g 실행 시
원인: 관리자 권한 없음
해결:
# Mac
sudo npm install -g @anthropic-ai/claude-code
# Windows
관리자 권한으로 터미널 열기
에러 3: OAuth 인증 실패
언제: Blogger API, Threads API 연동 시
원인: credentials.json 경로 오류 또는 API 미활성화
해결:
실제로 Blogger API 자동 발행 스크립트를 만들 때 겪었다.
Google Cloud Console에서 Blogger API v3을 활성화하지 않아서 발생.
API 활성화 후 즉시 해결.
핵심: 에러 메시지에 URL이 포함되어 있으면
그 URL로 가서 설정하면 대부분 해결된다.
에러 4: 모듈 없음 (ModuleNotFoundError)
언제: Python 스크립트 실행 시
원인: 필요한 라이브러리 미설치
해결:
pip install 라이브러리이름
Claude Code에게 “이 에러 해결해줘”라고 하면
필요한 라이브러리를 알아서 설치한다.
에러 5: API 응답 403/401
언제: 외부 API 호출 시
원인: 인증 토큰 만료 또는 권한 부족
해결:
토큰을 재발급하거나 API 권한을 확인.
실제로 Reddit RSS 수집 시 403 에러가 반복됐는데
User-Agent를 브라우저로 바꾸니 해결됐다.
각 API마다 원인이 다르다.
에러 해결 공식
모든 에러에 통하는 공식:
1. 에러 메시지를 전체 복사
2. Claude Code에 붙여넣기
3. "이 에러 해결해줘"
4. Claude Code가 원인 분석 + 수정
5. 수정 후 다시 실행
대부분의 에러는 이 공식으로 해결된다.
안 되면 에러 메시지를 Google에 검색.
지금 바로 해볼 것
다음에 에러를 만나면 당황하지 말고 이렇게 하라:
- 에러 메시지 전체를 드래그해서 복사
- Claude Code에 붙여넣기
- “이 에러 해결해줘” 입력
이 3단계를 포스트잇에 적어서 모니터에 붙여라. 에러는 실패가 아니라 해결 가능한 메시지다.
자주 묻는 질문
Claude Code에서 에러가 나면 어떻게 하나?
에러 메시지를 그대로 Claude Code에게 보여주면 된다.
“이 에러 해결해줘”라고 붙여넣으면
원인을 분석하고 수정한다.
npm install에서 EACCES 에러가 나면?
권한 문제다.
Mac에서는 sudo를 붙이고,
Windows에서는 관리자 권한으로 터미널을 열어라.
댓글
댓글 쓰기