클코클라우드 로고
로그인

문제 해결

문제는 대부분 키, endpoint, 세션, 네트워크 중 하나예요. 증상을 입력해 보세요.

Claude 서버 상태Claude API 및 서비스의 현재 운영 상태를 확인합니다.공지사항 · 서비스 상태진행 중인 이용 지연 공지와 지난 공지를 확인합니다.

연결되지 않아요

BASE_URL 설정이 반영되지 않아요

가장 가능성 높은 원인 새 셸에 환경 변수가 반영되지 않았어요.

먼저 해볼 해결법
  1. Linux/macOS 는 터미널에서 source ~/.zshrc (또는 ~/.bashrc) 를 실행하세요.
  2. Windows 는 터미널을 완전히 닫고 새로 여세요.
  3. BASE_URL 이 https://api.clcocloud.com/claude/v1 인지 확인하세요.

상세 가이드 보기 →

Windows에서 setx가 현재 창에 적용되지 않아요

가장 가능성 높은 원인 setx 는 다음에 열리는 셸부터 적용돼요.

먼저 해볼 해결법
  1. 명령 프롬프트 또는 PowerShell 을 완전히 닫고 다시 여세요.

상세 가이드 보기 →

회사 네트워크에서 연결이 안 돼요 (프록시/방화벽)

가장 가능성 높은 원인 회사망, 보안 프록시, DNS 정책이 클코클라우드 엔드포인트 연결을 막고 있을 수 있어요.

먼저 해볼 해결법
  1. 프록시 환경에서는 엔드포인트 허용 여부와 TLS 검사 정책을 먼저 확인하세요.
  2. 다른 네트워크(예: 개인 핫스팟)에서 연결을 시도해 보세요.

상세 가이드 보기 →

인증되지 않아요

Invalid API key 오류가 떠요401

가장 가능성 높은 원인 기존 공식 키가 환경 변수에 남아 있어요.

먼저 해볼 해결법
  1. 기존에 설정된 공식 API 키 환경 변수를 제거하세요.
  2. 클코클라우드에서 발급받은 키를 ANTHROPIC_AUTH_TOKEN 에 다시 넣으세요.
  3. 키를 붙여넣을 때 공백이 함께 들어가지 않았는지 확인하세요.

상세 가이드 보기 →

claude /logout 후에도 기존 세션이 살아 있어요

가장 가능성 높은 원인 다른 터미널의 CLI 세션이나 캐시가 남아 있어요.

먼저 해볼 해결법
  1. 열려 있는 모든 Claude Code 세션을 닫으세요.
  2. 새 터미널에서 다시 시작하세요.

상세 가이드 보기 →

403 권한 또는 정책 차단403

가장 가능성 높은 원인 키 상태, 플랜, 허용 모델 범위가 요청과 맞지 않아요.

먼저 해볼 해결법
  1. 키가 활성 상태인지, 플랜에 포함된 모델인지 확인하세요.

상세 가이드 보기 →

모델이 보이지 않아요

모델 목록이 보이지 않아요

가장 가능성 높은 원인 연결이 아직 완료되지 않았거나, 앱이 모델 목록을 새로고침하지 않았어요.

먼저 해볼 해결법
  1. 연결 설정 단계를 다시 확인하세요.
  2. 앱을 완전히 종료했다가 다시 실행하세요.
  3. CLI 는 새 터미널에서 다시 실행하세요.

상세 가이드 보기 →

응답이 오지 않아요

400 요청 형식 오류400

가장 가능성 높은 원인 요청 본문 형식이 맞지 않아요.

먼저 해볼 해결법
  1. model, messages, header 형식을 확인하세요.

상세 가이드 보기 →

429 요청량 제한에 걸렸어요429

가장 가능성 높은 원인 짧은 시간에 너무 많이 호출했어요.

먼저 해볼 해결법
  1. 호출 간격을 넓히고 지수 백오프(1초 → 2초 → 4초)로 재시도하세요.
  2. Retry-After 헤더가 있으면 그 시간만큼 기다리세요.

상세 가이드 보기 →

500/502/503/504 서버 오류500502503504

가장 가능성 높은 원인 서버 쪽 일시 오류이거나 모델이 혼잡할 수 있어요.

먼저 해볼 해결법
  1. 잠시 후 재시도하세요.
  2. 긴 컨텍스트 요청이라면 컨텍스트를 줄여 보세요.
  3. 서비스 상태 공지(/notices)를 확인하세요.

상세 가이드 보기 →

앱이 응답하지 않아요

가장 가능성 높은 원인 네트워크 지연, 큰 컨텍스트, 또는 연결 설정 문제일 수 있어요.

먼저 해볼 해결법
  1. 네트워크 연결을 확인하세요.
  2. 요청 크기를 줄여 다시 시도하세요.
  3. BASE_URL 과 키 설정을 다시 확인하세요.

상세 가이드 보기 →

앱별 문제

코덱스: OPENAI 환경변수와 config.toml이 충돌해요

가장 가능성 높은 원인 OPENAI_API_KEY · OPENAI_BASE_URL 환경 변수가 남아 있으면 config.toml 설정보다 먼저 잡힐 수 있어요.

먼저 해볼 해결법
  1. OPENAI_API_KEY 와 OPENAI_BASE_URL 환경 변수를 제거하세요.
  2. ~/.codex/config.toml 설정 파일만 남기세요.

상세 가이드 보기 →

코덱스: auth.json 키가 없거나 형식이 달라요

가장 가능성 높은 원인 ~/.codex/auth.json 에 OPENAI_API_KEY 가 없거나 형식이 틀렸어요.

먼저 해볼 해결법
  1. 발급받은 sk-proj- 키를 auth.json 에 다시 넣으세요.

상세 가이드 보기 →

코덱스: base_url이 잘못됐어요404

가장 가능성 높은 원인 config.toml 의 base_url 이 잘못 입력됐어요.

먼저 해볼 해결법
  1. base_url 이 https://api.clcocloud.com/codex/v1 인지 확인하세요.

상세 가이드 보기 →

그래도 해결되지 않을 때

그래도 해결되지 않으면 /support 에서 문의하거나 support.clcocloud@gmail.com 으로 연락해 주세요.

1:1 문의하기진단 체크리스트로 점검하기

오류 코드의 의미가 궁금하다면 오류 코드 문서를, 단계별 점검이 필요하다면 진단 체크리스트를 이용하세요.

이 문서가 도움이 되었나요?