Claude API 401 Unauthorized 해결

해결 단계

1. 1

   API 키 확인

   https://console.anthropic.com/settings/keys 에서 키가 활성 상태인지 확인. Revoked이면 새 키 발급.

2. 2

   헤더 형식 검증

   Anthropic은 `x-api-key` 헤더 사용. OpenAI 스타일 `Authorization: Bearer ...`를 쓰면 401 발생.

   headers: {
     "x-api-key": process.env.ANTHROPIC_API_KEY,
     "anthropic-version": "2023-06-01",
     "content-type": "application/json"
   }

3. 3

   환경변수 로딩 확인

   Next.js라면 `.env.local`에 `ANTHROPIC_API_KEY=sk-ant-...` 저장 후 dev 서버 재시작. Vercel 배포면 Environment Variables에 등록 후 Redeploy.

4. 4

   키 형식 점검

   Anthropic 키는 `sk-ant-api03-`로 시작. 복사 시 앞뒤 공백·줄바꿈이 끼면 401.

5. 5

   조직·프로젝트 매칭

   Anthropic 콘솔에 여러 워크스페이스가 있을 경우, 키 발급한 워크스페이스의 결제 상태도 확인.

자주 묻는 질문