HTTP 401은 인증 실패를 의미합니다. 4AICode 릴레이는 Authorization: Bearer sk-4ai-...만 허용합니다.
체크리스트
- 헤더 존재 및 표기
Authorization: Bearer sk-4ai-xxxxxxxxxxxxxxxx
쿼리 문자열 키는 지원하지 않습니다. Bearer를 생략하지 마세요.
- 토큰 전체 — 생성 시 한 번만 표시됩니다.
sk-4ai-<your-token>placeholder 전체를 교체하세요. - 토큰 미폐기 — 폐기는 즉시 반영됩니다(토큰 가이드).
- 클라이언트 재시작 — env 변경 후 새 터미널 또는 IDE 전체 재시작. 토큰은
.com과.net모두에서 동작합니다. - Claude Code 확장 변수 —
ANTHROPIC_AUTH_TOKEN사용을 권장합니다(VS Code / Cursor 가이드).
흔한 경우
| 경우 | 조치 |
|---|---|
| 새 토큰인데도 401 | 공백 제거; 클라이언트 재시작 |
| 갑자기 401 | 폐기 여부 또는 조직 전환 후 오래된 토큰 확인 |
| 특정 도구만 실패 | 해당 도구가 셸 env를 무시할 수 있음; 도구 자체 설정 확인 |
계속 안 되면
대략적인 시각, 도구 이름, trace_id(있을 경우)를 support@4aicode.com으로 보내세요. 토큰 전체는 보내지 마세요.