문제 해결
문제는 대부분 키, endpoint, 세션, 네트워크 중 하나예요. 증상을 입력해 보세요.
Claude 서버 상태Claude API 및 서비스의 현재 운영 상태를 확인합니다.공지사항 · 서비스 상태진행 중인 이용 지연 공지와 지난 공지를 확인합니다.어떤 문제가 있나요?
연결되지 않아요
BASE_URL 설정이 반영되지 않아요
가장 가능성 높은 원인 새 셸에 환경 변수가 반영되지 않았어요.
- Linux/macOS 는 터미널에서 source ~/.zshrc (또는 ~/.bashrc) 를 실행하세요.
- Windows 는 터미널을 완전히 닫고 새로 여세요.
- BASE_URL 이 https://api.letsfine.com/claude/v1 인지 확인하세요.
Windows에서 setx가 현재 창에 적용되지 않아요
회사 네트워크에서 연결이 안 돼요 (프록시/방화벽)
가장 가능성 높은 원인 회사망, 보안 프록시, DNS 정책이 렛츠파인 엔드포인트 연결을 막고 있을 수 있어요.
- 프록시 환경에서는 엔드포인트 허용 여부와 TLS 검사 정책을 먼저 확인하세요.
- 다른 네트워크(예: 개인 핫스팟)에서 연결을 시도해 보세요.
인증되지 않아요
Invalid API key 오류가 떠요401
가장 가능성 높은 원인 기존 공식 키가 환경 변수에 남아 있어요.
- 기존에 설정된 공식 API 키 환경 변수를 제거하세요.
- 렛츠파인에서 발급받은 키를 ANTHROPIC_AUTH_TOKEN 에 다시 넣으세요.
- 키를 붙여넣을 때 공백이 함께 들어가지 않았는지 확인하세요.
claude /logout 후에도 기존 세션이 살아 있어요
가장 가능성 높은 원인 다른 터미널의 CLI 세션이나 캐시가 남아 있어요.
- 열려 있는 모든 Claude Code 세션을 닫으세요.
- 새 터미널에서 다시 시작하세요.
403 권한 또는 정책 차단403
모델이 보이지 않아요
모델 목록이 보이지 않아요
가장 가능성 높은 원인 연결이 아직 완료되지 않았거나, 앱이 모델 목록을 새로고침하지 않았어요.
- 연결 설정 단계를 다시 확인하세요.
- 앱을 완전히 종료했다가 다시 실행하세요.
- CLI 는 새 터미널에서 다시 실행하세요.
응답이 오지 않아요
400 요청 형식 오류400
429 요청량 제한에 걸렸어요429
가장 가능성 높은 원인 짧은 시간에 너무 많이 호출했어요.
- 호출 간격을 넓히고 지수 백오프(1초 → 2초 → 4초)로 재시도하세요.
- Retry-After 헤더가 있으면 그 시간만큼 기다리세요.
500/502/503/504 서버 오류500502503504
가장 가능성 높은 원인 서버 쪽 일시 오류이거나 모델이 혼잡할 수 있어요.
- 잠시 후 재시도하세요.
- 긴 컨텍스트 요청이라면 컨텍스트를 줄여 보세요.
- 서비스 상태 공지(/notices)를 확인하세요.
앱이 응답하지 않아요
가장 가능성 높은 원인 네트워크 지연, 큰 컨텍스트, 또는 연결 설정 문제일 수 있어요.
- 네트워크 연결을 확인하세요.
- 요청 크기를 줄여 다시 시도하세요.
- BASE_URL 과 키 설정을 다시 확인하세요.
앱별 문제
코덱스: OPENAI 환경변수와 config.toml이 충돌해요
가장 가능성 높은 원인 OPENAI_API_KEY · OPENAI_BASE_URL 환경 변수가 남아 있으면 config.toml 설정보다 먼저 잡힐 수 있어요.
- OPENAI_API_KEY 와 OPENAI_BASE_URL 환경 변수를 제거하세요.
- ~/.codex/config.toml 설정 파일만 남기세요.
코덱스: auth.json 키가 없거나 형식이 달라요
가장 가능성 높은 원인 ~/.codex/auth.json 에 OPENAI_API_KEY 가 없거나 형식이 틀렸어요.
- 발급받은 sk-proj- 키를 auth.json 에 다시 넣으세요.
코덱스: base_url이 잘못됐어요404
가장 가능성 높은 원인 config.toml 의 base_url 이 잘못 입력됐어요.
- base_url 이 https://api.letsfine.com/codex/v1 인지 확인하세요.
그래도 해결되지 않을 때
그래도 해결되지 않으면 /support 에서 문의하거나 support@letsfine.ai.kr 으로 연락해 주세요.
오류 코드의 의미가 궁금하다면 오류 코드 문서를, 단계별 점검이 필요하다면 진단 체크리스트를 이용하세요.
Gemini 연결 문제
구매가 준비 중이면 API 사용 가능 상태로 간주하지 마세요. 사용 가능 상태에서 401/403은 Gemini 키와 인증 헤더, 404는 해당 endpoint와 공개 모델 ID, 429는 잔액·사용 제한과 재시도 간격을 확인하세요. HTTP 5xx는 외부 서비스 상태를 확인하고, 같은 요청을 무한 재시도하지 마세요. 문의에는 키 대신 요청 ID와 상태 코드만 전달하세요.