Claude Code · 문제 해결
Claude Code API 오류 401: 잘못된 API 키 해결
401은 API가 요청을 받았지만 인증할 수 없음을 의미합니다. 원인은 거의 항상 키 자체이거나 Claude Code가 어떤 변수에서 키를 읽는지에 있습니다.
마지막 확인
오류 텍스트
API Error: 401 {"type":"error","error":{"type":"authentication_error","message":"..."}}단계별 해결
1. 키를 다시 복사하세요
API Keys 페이지에서 키를 새로 복사하고 공백이나 줄 바꿈이 있는지 확인하세요. 키가 삭제되지 않았는지도 확인하세요.
2. 올바른 변수를 사용하세요
ANTHROPIC_AUTH_TOKEN에 aicodewith 키를 넣고, ANTHROPIC_API_KEY는 비워 두세요.
~/.claude/settings.json{ "env": { "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY", "ANTHROPIC_API_KEY": "", "ANTHROPIC_BASE_URL": "https://api.aicodewith.ai" } }3. 남은 설정 찾기
새 터미널에서 echo $ANTHROPIC_API_KEY와 echo $ANTHROPIC_AUTH_TOKEN을 실행하세요. ~/.zshrc 또는 ~/.bashrc에서 이전 export를 제거하세요.
4. 재시작하고 확인
모든 Claude Code 세션을 닫고 다시 시작한 뒤 /status를 실행하세요.
다른 원인
| 증상 | 원인 | 해결 |
|---|---|---|
| 설정 직후 401 | 키를 ANTHROPIC_API_KEY에 붙여넣음 | ANTHROPIC_AUTH_TOKEN으로 옮기기 |
| 어제는 작동했는데 오늘 401 | 키가 삭제되었거나 교체됨 | 새 키를 만들고 settings.json 업데이트 |
| 한 터미널에서만 401 | 해당 셸이 이전 키를 export함 | unset하거나 새 터미널 열기 |
| 대신 /login 하라는 메시지 | 키가 로드되지 않음; Claude Code가 플랜 로그인 상태 | settings.json 경로와 JSON 구문 확인 |
계속 실패하나요?
- aicodewith에서 해당 모델 페이지를 확인하세요: 각 채널의 최근 상태를 보여줍니다.
- 대시보드 사용 기록에서 해당 요청을 찾아 모델, 상태 및 비용을 확인하세요.
- 오류 발생 시각, 모델, 오류 텍스트를 support@aicodewith.com으로 이메일로 보내주세요 (전체 API 키는 절대 보내지 마세요).
FAQ
Claude Code 오류 401은 무엇을 의미하나요?
요청을 인증할 수 없습니다: 키가 잘못되었거나, 삭제되었거나, 잘못된 변수로 전송되었습니다.
ANTHROPIC_API_KEY와 ANTHROPIC_AUTH_TOKEN 중 무엇을 사용해야 하나요?
aicodewith 키를 ANTHROPIC_AUTH_TOKEN에 넣고 ANTHROPIC_API_KEY는 빈 문자열로 설정하세요.
왜 한 터미널에서는 작동하고 다른 터미널에서는 작동하지 않나요?
한 셸이 아직 이전 ANTHROPIC_API_KEY를 export하고 있을 수 있습니다. echo $ANTHROPIC_API_KEY를 실행해 확인하세요.
잔액 부족이 401을 일으킬 수 있나요?
잔액 문제는 별도의 잔액 부족 오류를 표시합니다. 메시지에 잔액 언급이 있으면 충전하고, 그렇지 않으면 키를 확인하세요.
지원을 위해 키를 공유해도 안전한가요?
아니요. 전체 키를 절대 보내지 마세요. 대신 오류 발생 시각과 모델을 알려주세요.
지금 사용해 보세요
요금은 선불 잔액에서 토큰 단위로 청구됩니다. 속도 및 동시성 제한이 적용되며, 각 API 키에 일일, 월간 또는 총 지출 한도를 설정할 수 있습니다.
관련 항목
출처
Claude 및 Claude Code는 Anthropic PBC의 상표입니다. aicodewith는 독립 플랫폼이며 Anthropic과 제휴하거나 Anthropic의 승인을 받지 않았습니다. 오류 형식은 Claude Code에서 인용한 것이며 변경될 수 있습니다. 확인일: 2026-10-10.