Source: https://aiprimetech.io/ko/learn/claude-api-errors-troubleshooting/ [홈](/ko/) / [학습](/ko/learn/) / Claude API 오류 설명: 서버 오류 500, 과부하 529, 요청 한도 429, 잘못된 요청 400 — 그리고 각 오류의 해결 방법 # Claude API 오류 설명: 서버 오류 500, 과부하 529, 사용량 제한 429, 잘못된 요청 400 — 각 오류의 해결 방법 Claude API를 사용하는 개발자라면 누구나 결국 오류를 만나게 됩니다. 일부는 개발자의 잘못에서 비롯되고(잘못된 형식의 요청), 일부는 Anthropic 측 문제이며(서버 문제), 일부는 구조적인 문제입니다(사용량이 많을 때의 요청 한도). 이 가이드에서는 흔히 발생하는 모든 Claude API 오류 코드의 실제 원인, 구체적인 해결 방법, 프로덕션 환경에 바로 적용할 수 있는 재시도 로직을 다룹니다. 또한 여러 업스트림 계정을 사용하는 게이트웨이를 통해 라우팅하면 요청 한도 및 과부하 오류의 발생 빈도를 어떻게 줄일 수 있는지도 설명합니다. ## 재시도하기 전에 액세스와 모델 확인하기 플랜이나 잔액에 따른 액세스가 활성화되어 있는지 확인하고, 키 그룹을 점검하고, 해당 키에 대해 반환된 모델을 사용하세요. 모델 목록 응답이 성공하는지는 초기 확인 사항입니다. 더 큰 규모로 에이전트를 실행하기 전에 작은 생성 요청 하나가 정상적으로 처리되는지 확인하세요. 다음을 사용하세요: [모델 및 키 그룹](/ko/docs/getting-started/models/) 및 다음 [에이전트 설정 체크리스트](/ko/agents/) 을 통해 액세스 문제를 도구 설정 및 업스트림 오류와 구분하세요. ## "Claude 서버 오류": 실제로 어떤 오류가 발생했나요? "Claude 서버 오류"는 API가 응답하지 않을 때 사람들이 검색하는 문구이지만, 실제 조치는 메시지에 표시된 숫자에 따라 달라집니다. **500**은 API 내부 오류이므로 기다리거나, 재시도하거나, 모델을 전환하세요. **529**은 모든 사용자에게 모델이 포화 상태라는 뜻이며, 같은 방식으로 대응하면 되고 시간이 지나면 저절로 해소됩니다. **429**는 한도에 도달했다는 뜻이므로 요청 속도를 낮추거나 병렬 요청 수를 줄이세요. **400**은 요청 자체가 거부되었다는 뜻이며, 같은 요청을 재시도해도 다시 실패합니다. 아래에서 해당 오류 코드를 찾아보세요. 각 섹션에는 정확한 메시지, 원인, 해결 방법이 나와 있습니다. 직접 작성한 코드가 아니라 Claude Code 내에서 오류가 발생한다면 /claude-code/errors/의 Claude Code 오류 가이드에서 CLI 관련 메시지(OAuth 시간 초과, "프로세스가 코드 1로 종료되었습니다", 도구 사용 동시성)를 확인할 수 있습니다. ## 오류 400 — 잘못된 요청 400 오류는 요청의 구조가 유효하지 않다는 뜻입니다. Claude API가 응답 생성을 시도하기도 전에 요청을 거부한 것입니다. 오류 본문에는 문제를 설명하는 메시지가 포함되어 있으므로 항상 주의 깊게 읽으세요. 일반적인 원인으로는 messages 배열이 비어 있거나 형식이 잘못된 경우, content 필드가 문자열 대신 null인 경우, max_tokens가 모델의 한도를 초과한 경우, 모델 식별자가 존재하지 않는 경우, 시스템 프롬프트 형식이 잘못된 경우, 도구 정의에 스키마 오류가 있는 경우 등이 있습니다. Claude Code 사용자에게 가장 자주 발생하는 400 오류는 컨텍스트 길이 초과입니다. 대화 기록이 모델의 컨텍스트 윈도우(대부분의 Claude 모델에서 200K 토큰)를 초과하면 API는 입력이 너무 길다는 메시지와 함께 400를 반환합니다. 해결하려면 /compact로 대화 기록을 요약하거나, 컨텍스트에서 큰 파일 내용을 제거하거나, 새 세션을 시작하세요. 이는 요청 한도 문제가 아니라 요청 크기에 대한 엄격한 제한입니다. 또 다른 일반적인 400 오류는 지원되지 않는 매개변수나 모델 버전을 보내는 경우입니다. 최근 SDK를 업그레이드했거나 모델 식별자를 변경했다면 요청의 모든 필드가 현재 API 명세와 일치하는지 다시 확인하세요. 모델 ID는 대소문자를 구분하며 버전별로 다릅니다. 'claude-opus-4-6'은 유효하지만 'Claude-Opus-4.6'는 유효하지 않습니다. 확실하지 않다면 /v1/models 엔드포인트를 조회해 제공업체가 허용하는 식별자를 정확히 확인하세요. ## 오류 400 - "요청한 모델에 비해 입력이 너무 깁니다" 이 400 오류는 요청(시스템 프롬프트 + 메시지 + 모든 도구 정의)이 모델의 컨텍스트 윈도우를 초과한다는 뜻입니다. 요청 한도 문제가 아니며 재시도로 해결되지 않습니다. 입력을 줄이거나 더 큰 컨텍스트를 지원하는 모델로 전환하기 전까지 같은 페이로드는 매번 실패합니다. 필요한 노력 순으로 정리한 실용적인 해결 방법은 세 가지입니다. 먼저 다시 보내는 대화 기록을 줄이세요. 대부분의 채팅 앱에는 전체 대화록이 아니라 최근 몇 차례의 대화와 누적 요약만 있으면 됩니다. 다음으로 전송 전에 토큰 수를 계산하고(토큰 계산 엔드포인트는 무료입니다), 코드에서 엄격한 입력 예산을 적용하세요. 마지막으로 전체 저장소나 책 한 권 분량의 문서처럼 전체 컨텍스트가 반드시 필요하다면 Fable 5과 같은 1M 컨텍스트 모델로 전환하세요. 그러면 같은 요청도 여유 있게 처리할 수 있습니다. 에이전트 도구에서 흔히 놓치는 부분이 있습니다. 오래 실행되는 세션에서는 도구 결과와 파일 내용이 쌓이다가 대화 한 차례만 더 진행해도 요청이 한도를 넘게 됩니다. Claude Code나 유사한 에이전트에서 세션 도중 이 오류가 나타나면 프롬프트를 줄이기보다 세션 컨텍스트를 압축하거나 지우세요. ## 오류 429 — "요청 한도에 도달했습니다" / "요청 한도를 초과했습니다" 같은 상황이 두 가지 문구로 표시됩니다. API는 HTTP 429을 반환하며 다음 내용을 포함합니다 rate_limit_error; claude.ai 및 Claude Code에서는 이를 "요청 한도를 초과했습니다" 또는 "요청 한도에 도달했습니다"로 표시합니다. 어떤 문구가 나타나든 원인은 같습니다. 계정이 현재 시간 구간의 할당량을 모두 사용했으며, 한도가 초기화될 때까지 요청이 거부됩니다. 429은 허용된 요청 처리율을 초과했다는 뜻입니다. 응답에는 재시도 전에 몇 초를 기다려야 하는지 알려주는 Retry-After 헤더가 포함됩니다. Anthropic의 요청 한도는 분당 요청 수(RPM), 분당 토큰 수(TPM), 일일 토큰 수(TPD) 등 여러 기준으로 적용됩니다. 이 중 하나라도 한도에 도달하면 429이 발생합니다. 오류 메시지는 대개 어떤 한도에 도달했는지 알려줍니다. Claude Code 사용자에게 요청 한도는 워크플로를 중단시키므로 가장 답답한 오류입니다. 개발자 한 명이 하위 에이전트와 함께 Claude Code를 실행하는 것만으로도 병렬 작업 중에 RPM 한도에, 또는 큰 파일이 컨텍스트에 포함된 세션에서 TPM 한도에 쉽게 도달할 수 있습니다. 한도는 계정 등급에 따라 다릅니다. 낮은 등급에는 더 엄격한 한도가 적용되며, 에이전트 사용량이 많으면 이 한도를 빈번하게 초과하게 됩니다. 429에 대한 올바른 대응은 지터를 적용한 지수 백오프입니다. Retry-After에 지정된 시간만큼 기다린 다음 무작위 지연을 추가하여 여러 클라이언트가 동시에 한도에 도달했을 때 요청이 한꺼번에 몰리는 현상을 방지하세요. AI Prime Tech Unlimited와 같은 게이트웨이는 여러 업스트림 계정으로 요청을 라우팅하여 사용 가능한 요청 한도를 사실상 늘림으로써 429 오류를 줄이는 데 도움이 됩니다. 한 업스트림 계정의 요청이 제한되면 게이트웨이는 다른 계정으로 라우팅합니다. ## 오류 500 — 내부 서버 오류 500 오류는 서버 측에서 문제가 발생했다는 뜻입니다. 사용자의 잘못이 아니며, 요청을 변경해서 해결할 수 있는 문제도 아닙니다. 이러한 오류는 일시적입니다. 500로 실패한 요청도 잠시 기다린 후 다시 시도하면 성공할 가능성이 높습니다. Anthropic의 인프라는 배포, 처리 용량 변경 또는 내부 서비스 장애 중에 간혹 500 오류를 반환합니다. 500 오류는 백오프를 적용해 단순히 재시도하면 됩니다. 1-2초 동안 기다린 후 동일한 요청을 다시 시도하세요. 다시 실패하면 4초, 그다음에는 8초를 기다리는 식으로 대기 시간을 최대 약 60초까지 늘리세요. 대부분의 500 오류는 첫 재시도에서 해결됩니다. 500 오류가 몇 분 이상 계속 발생하면 Anthropic의 상태 페이지나 게이트웨이의 상태 엔드포인트에서 알려진 장애가 있는지 확인하세요. 500에 대응하기 위해 요청을 수정하지 마세요. 문제는 서버 측에 있습니다. 프롬프트 변경, 컨텍스트 축소 또는 모델 전환은 도움이 되지 않으며, 사용자 측 문제가 아닌 것을 디버깅하느라 개발 시간만 낭비하게 됩니다. 필요한 조치는 재시도, 재시도 실패 시 더 오래 기다리기, 그리고 합리적인 시간 범위(5-10분 동안 연속 실패)를 넘겨 문제가 지속되면 알림을 보내는 것뿐입니다. ## 오류 529 — "Claude 서버가 과부하 상태입니다" (overloaded_error) 529 상태 코드는 Anthropic 고유의 코드이며, API에 수요가 몰려 요청한 모델이 일시적으로 처리 용량 한도에 도달했다는 뜻입니다. 429(YOUR의 요청 한도를 초과했다는 뜻)과 달리, 529은 개인별 한도와 관계없이 SYSTEM에 과부하가 걸렸다는 뜻입니다. 사용자가 잘못한 것은 없습니다. 그 시점에 사용 가능한 컴퓨팅 자원보다 수요가 많을 뿐입니다. 529 오류는 피크 시간대(미국 업무 시간), 새 모델 출시 직후(모두가 새 모델을 동시에 테스트할 때), 그리고 화제가 된 서비스나 콘텐츠로 인해 전체 고객의 사용량이 급증할 때 가장 흔하게 발생합니다. Opus는 요청당 더 많은 컴퓨팅 자원을 필요로 하고 처리 용량 제약도 더 엄격하므로, Sonnet과 Haiku에서는 Opus보다 이러한 오류가 덜 발생합니다. 529 오류는 500 오류보다 더 긴 백오프로 처리하세요. 5-10초 대기부터 시작해 대기 시간을 지수적으로 늘리세요. 프로덕션 시스템을 구축한다면 대체 모델 사용을 고려하세요. Opus가 529을 반환하면 해당 요청을 Sonnet으로 전환하는 방식입니다. 여러 업스트림 계정을 사용하는 게이트웨이도 도움이 될 수 있습니다. 과부하가 계정별 우선순위 등급에 미치는 영향이 서로 다를 수 있어, 수요가 몰릴 때 게이트웨이가 선택할 수 있는 라우팅 경로가 늘어나기 때문입니다. ## "정상 상태의 업스트림 없음" — Claude 오류가 아닌 인프라 오류 "정상 상태의 업스트림 없음"은 Claude API 자체가 반환하는 메시지가 아닙니다. 로드 밸런서나 인그레스 프록시(일반적으로 Envoy) 뒤에 있는 모든 백엔드 인스턴스를 사용할 수 없을 때 해당 구성 요소가 내보내는 메시지입니다. 장애 발생 시 claude.ai에서 이 메시지를 볼 수 있으며, 업스트림 연결 풀이 고갈되거나 상태 점검에 실패하는 프록시나 게이트웨이에서도 나타날 수 있습니다. 코드에서 수정할 부분은 없습니다. 일시적인 문제로 처리하세요. status.anthropic.com을 확인하고 기다린 다음, 529에 대응할 때와 동일하게 지수 백오프를 적용하여 재시도하세요. 공식 엔드포인트에서 몇 분 이상 지속된다면 서비스 장애입니다. 타사 게이트웨이에서 발생한다면 해당 게이트웨이가 업스트림 처리 용량을 모두 잃은 상태입니다. 이는 다중 계정 게이트웨이가 흡수하도록 설계된 장애 유형 중 하나입니다. 한 업스트림 계정의 요청이 제한되거나 상태가 비정상이면, 사용자에게 오류를 노출하는 대신 다른 계정으로 요청을 라우팅합니다. ## 프로덕션 환경을 위한 재시도 로직 잘 설계된 재시도 로직은 모든 일시적 오류(429, 500, 529)를 지수 백오프와 지터로 일관되게 처리하고, 영구적 오류(400, 401, 403)는 재시도할 수 없는 오류로 취급합니다. 패턴은 다음과 같습니다. 요청을 시도하고 상태 코드를 확인한 뒤, 재시도 가능한 오류라면 백오프를 적용해 기다리고 최대 N회 재시도하며, 재시도 불가능한 오류라면 즉시 예외를 발생시킵니다. 대부분의 애플리케이션에서는 최대 재시도 횟수를 3-5로 설정해야 합니다. 지터는 재시도가 동시에 발생하는 것을 방지합니다. 클라이언트 열 개가 동시에 요청 한도에 도달하고 모두 정확히 2초 후에 재시도하면, 다시 동시에 실패하게 됩니다. 무작위 지터를 추가하면(지연 시간에 0.5과 1.5 사이의 무작위 계수를 곱하면) 재시도가 시간상 분산되어 성공률이 크게 향상됩니다. 모든 프로덕션용 Claude API 클라이언트에는 지터를 포함해야 합니다. Claude Code와 에이전트 기반 워크플로에서는 HTTP 클라이언트 수준에서 재시도를 구현하여 개별 도구 호출과 하위 에이전트 요청에 자동으로 적용되도록 하세요. Anthropic SDK에는 이미 기본 재시도 로직이 포함되어 있지만, 사용 사례에 맞게 타임아웃과 최대 재시도 횟수를 조정할 수 있습니다. AI Prime Tech Unlimited를 사용하면 게이트웨이가 업스트림 재시도와 라우팅을 내부적으로 처리하여 클라이언트에 도달하는 오류 자체를 줄여줍니다. ## 게이트웨이가 이러한 오류를 줄이는 방식 AI Prime Tech Unlimited처럼 잘 설계된 게이트웨이는 여러 방식으로 오류 발생 빈도를 줄입니다. 요청 한도(429)의 경우 게이트웨이가 여러 업스트림 API 계정에 요청을 분산하므로, 실질적인 요청 한도는 단일 계정의 할당량이 아니라 모든 업스트림 계정의 한도를 합한 값이 됩니다. 과부하 오류(529)의 경우 게이트웨이는 우선순위나 대기열 위치가 다를 수 있는 다른 업스트림 계정에서 재시도할 수 있습니다. 서버 오류(500)의 경우 게이트웨이는 클라이언트에 오류를 반환하기 전에 사용자 개입 없이 재시도할 수 있습니다. 따라서 사용자는 오류 대신 약간 느린 응답을 받게 됩니다. 400 오류는 요청 자체가 유효하지 않아 게이트웨이가 해결할 수 없지만, 잘 설계된 게이트웨이는 Anthropic의 원본 오류 응답보다 더 명확한 오류 메시지를 제공하여 더 빠르게 디버깅할 수 있도록 돕습니다. 그 결과 개발자는 애플리케이션에 도달하는 오류가 줄고, 클라이언트 측에 필요한 재시도 로직이 줄어들며, 피크 시간대에도 더 안정적인 성능을 얻을 수 있습니다. 이는 작업 도중의 오류가 흐름을 끊을 수 있는 Claude Code 세션과 오류율이 사용자 경험에 직접 영향을 미치는 프로덕션 애플리케이션에서 특히 유용합니다. 무제한 요금제는 정액제이므로 이러한 재시도와 재라우팅에 추가 비용이 들지 않습니다. 복사 ``` import anthropic import time import random client = anthropic.Anthropic( api_key="YOUR_KEY", base_url="https://aiprimetech.io", ) def call_with_retry(messages, model="claude-sonnet-4-5", max_retries=4): for attempt in range(max_retries + 1): try: return client.messages.create( model=model, max_tokens=4096, messages=messages, ) except anthropic.RateLimitError as e: if attempt == max_retries: raise wait = (2 ** attempt) * random.uniform(0.5, 1.5) print(f"Rate limited, waiting {wait:.1f}s...") time.sleep(wait) except anthropic.InternalServerError as e: if attempt == max_retries: raise wait = (2 ** attempt) * random.uniform(0.5, 1.5) time.sleep(wait) except anthropic.BadRequestError: raise # Don't retry 400s # Usage: resp = call_with_retry([{"role": "user", "content": "Hello"}]) ``` ## 자주 묻는 질문 'Claude API 오류: 요청 한도에 도달함'은 무슨 뜻인가요? 분당 허용 요청 수, 분당 허용 토큰 수 또는 일일 허용 토큰 수를 초과했다는 뜻입니다. API는 Retry-After 헤더와 함께 HTTP 429을 반환합니다. 지정된 시간만큼 기다린 후 재시도하세요. 여러 업스트림 계정을 사용하는 게이트웨이는 요청을 더 큰 통합 요청 한도 풀에 분산하여 이러한 오류를 줄일 수 있습니다. Claude에서 "한도 초과"는 무슨 뜻인가요? 이는 429 요청 한도를 소비자에게 안내하는 표현으로, 현재 적용되는 시간 구간에 계정의 요청 또는 토큰 할당량을 모두 사용했다는 뜻입니다. API에서는 동일한 조건일 때 Retry-After 헤더와 함께 HTTP 429를 반환합니다. 안내된 시간만큼 기다린 후 백오프를 적용하여 재시도하세요. 지속적으로 사용량이 많다면 처리 용량이 더 큰 요금제나 게이트웨이가 해결책입니다. Claude가 "서버가 과부하 상태입니다"라고 표시하는 이유는 무엇인가요? 이는 HTTP 529, overloaded_error입니다. 요청한 모델이 사용자 개인뿐 아니라 모든 사용자에 대해 처리 용량 한도에 도달했다는 뜻입니다. 요청에는 아무런 문제가 없습니다. 지수 백오프와 지터를 적용하여 재시도하거나, 처리 용량이 회복될 때까지 호출을 다른 모델 또는 업스트림으로 라우팅하세요. Claude에서 "정상 상태의 업스트림 없음"은 무슨 뜻인가요? 이 메시지는 API가 아니라 서비스 앞단의 로드 밸런서에서 발생하며, 현재 사용 가능한 백엔드 인스턴스가 없다는 뜻입니다. 일시적인 문제이므로 상태 페이지를 확인하고 백오프를 적용해 재시도하되, 코드는 변경하지 마세요. 게이트웨이에서 발생한다면 전체 업스트림 풀이 중단되었거나 요청이 제한된 상태라는 뜻입니다. Claude API 오류 400은 어떻게 해결하나요? 오류 메시지 본문을 읽어보세요. 무엇이 잘못되었는지 정확히 알려줍니다. 일반적인 원인은 너무 긴 컨텍스트(/compact 사용), 유효하지 않은 모델 ID(/v1/models 확인), 형식이 잘못된 messages 배열 또는 지원되지 않는 매개변수입니다. 400 오류는 일시적 오류가 아니므로 요청을 수정하지 않은 채 재시도해서는 안 됩니다. 오류 529 overloaded_error란 무엇인가요? 529은 요청한 모델에 대한 Anthropic 인프라의 처리 용량이 한도에 도달했다는 뜻입니다. 이는 개인별 요청 한도가 아니라 시스템 전체의 과부하입니다. 5-10초 동안 기다린 후 지수 백오프를 적용하여 재시도하세요. 피크 시간대에는 부하가 더 적은 모델(Opus 대신 Sonnet)로 전환하는 것을 고려하세요. 무제한 요금제를 사용하면 요청 한도 오류가 없어지나요? 게이트웨이가 여러 업스트림 계정으로 요청을 라우팅하여 사용 가능한 요청 한도를 늘리므로 오류가 크게 줄어듭니다. 다만 게이트웨이 수준에서도 공정 사용을 위한 요청 한도는 적용됩니다. 특히 Claude Code를 많이 사용할 때는 Anthropic 계정 하나에 직접 연결하는 경우보다 429 오류가 훨씬 적게 발생합니다. 500 오류가 발생하면 재시도해야 하나요? 네. 500 오류는 일시적인 서버 측 문제입니다. 지수 백오프를 적용하여 1-2초 후에 동일한 요청을 그대로 재시도하세요. 요청을 수정하지 마세요. 이 오류는 입력 때문에 발생하는 것이 아닙니다. 500 오류가 5분 넘게 지속되면 제공업체의 상태 페이지를 확인하세요. "Claude API 오류 400: 요청한 모델에 비해 입력이 너무 깁니다"는 어떻게 해결하나요? 전송하는 토큰을 줄이세요. 다시 보내는 대화 기록을 줄이거나, 요청마다 토큰 수를 계산하여 입력량을 제한하거나, 전체 입력이 꼭 필요하다면 Fable 5처럼 1M 컨텍스트를 지원하는 모델로 전환하세요. 동일한 페이로드로 재시도해도 도움이 되지 않습니다. 요청 크기를 줄이거나 컨텍스트 윈도우를 늘려야 합니다. 몇 분 만에 Claude 사용 시작하기 API 키를 발급받으세요 — Anthropic 계정이나 대기자 명단 등록이 필요하지 않습니다.[API 키 발급받기](/register) AI Prime Tech는 독립적인 API 게이트웨이입니다. Anthropic과 제휴 관계가 없으며, Anthropic의 보증을 받거나 Anthropic의 리셀러로 활동하지 않습니다. Claude 및 관련 모델 이름은 각 소유자의 상표입니다. ## 더 많은 Claude API 가이드 [Claude API 키 발급 방법](/ko/learn/how-to-get-a-claude-api-key/)[Claude API 요금 해설](/ko/learn/claude-api-pricing-explained/)[Claude API를 가장 저렴하게 사용하는 방법](/ko/learn/cheapest-way-to-use-claude-api/)[Claude API로 Cursor 무제한 사용](/learn/use-claude-api-with-cursor/)[Claude Code 무제한 이용](/ko/learn/use-claude-api-with-claude-code/)[Claude API 게이트웨이와 Anthropic 직접 이용 비교](/ko/learn/claude-api-vs-anthropic-direct/)[OpenAI SDK로 Claude 사용하기: OpenAI 호환 엔드포인트, 스트리밍, 도구 및 제한](/ko/learn/openai-compatible-claude-api/)[Claude 모델 해설: Claude Opus, Sonnet, Haiku, Fable 비교 — 모든 Claude API 모델, Anthropic 모델 이름 및 가격 (2026)](/ko/learn/claude-api-models-compared/)[암호화폐로 Claude API 요금 결제하기](/ko/learn/claude-api-with-crypto-payment/)[대기 명단 없이 Claude API 이용하기](/ko/learn/claude-api-without-waitlist/)[Claude 토큰 사용량을 줄이는 방법](/ko/learn/how-to-reduce-claude-token-usage/)[Claude API로 Cline 무제한 사용](/ko/learn/use-claude-api-with-cline/)[Claude API로 Roo Code 무제한 사용](/ko/learn/use-claude-api-with-roo-code/)[JetBrains IDE에서 Claude 무제한 사용](/ko/learn/use-claude-api-with-jetbrains/)[게이트웨이를 통해 Claude와 함께 사용하는 Aider: ANTHROPIC_API_BASE, 구성 파일, architect 모드 및 문제 해결](/ko/learn/use-claude-api-with-aider/)[VS Code에서 Claude 무제한 사용](/ko/learn/use-claude-api-with-vscode/)[Claude용 OpenCode 구성: opencode.json 설정, 모델 및 일반적인 오류](/ko/learn/use-claude-api-with-opencode/)[게이트웨이를 통해 Claude와 함께 사용하는 Hermes Agent: 사용자 지정 제공업체 설정, 비용 관리 및 문제 해결](/ko/learn/run-hermes-agent-with-claude-api/)[Claude에서 OpenClaw 무제한 실행하기](/ko/learn/run-openclaw-with-claude-api/)[Anthropic 호환 API의 의미](/ko/learn/anthropic-compatible-api/)[Claude Code API 키 — ANTHROPIC_API_KEY: 발급 및 설정 방법과 대신 claude setup-token을 사용해야 하는 경우](/ko/learn/claude-code-api-key-setup/)[Claude Code API 비용 — 요금과 절감 방법](/ko/learn/claude-code-api-costs/)[Claude API 크레딧 구매 방법](/ko/learn/buy-claude-api-credits/)[Claude 무료 API: 무료 Claude API 키가 있나요? 2026년에 실제로 무료인 것은 무엇인가요?](/ko/learn/claude-api-free-trial/)[Claude API와 Claude Pro/Max 구독 — 어떤 것을 선택할까요](/ko/learn/claude-api-vs-subscription/)[사용자 지정 제공업체와 함께 사용하는 Codex CLI: config.toml, GPT 및 Claude 모델, IDE 확장 프로그램 및 문제 해결](/ko/learn/use-claude-api-with-codex/)[Claude를 n8n에 연결하기](/ko/learn/use-claude-api-with-n8n/)[LiteLLM을 Claude로 라우팅하기](/ko/learn/use-claude-api-with-litellm/)[Kilo Code에서 Claude 사용하기](/ko/learn/use-claude-api-with-kilo-code/)[게이트웨이를 통해 Claude와 함께 사용하는 GitHub Copilot Chat: Custom Endpoint 설정, 에이전트 모드 및 문제 해결](/ko/learn/use-claude-api-with-github-copilot/)[게이트웨이를 통해 Zed를 Claude에 연결하기](/ko/learn/use-claude-api-with-zed/)[Cherry Studio를 Claude에 연결하기](/ko/learn/use-claude-api-with-cherry-studio/)[LangChain의 ChatAnthropic: 가져오기, base_url, 스트리밍, 도구 및 오류](/ko/learn/use-claude-api-with-langchain/)[Anthropic Python SDK: 설치, base_url 설정, 스트리밍 및 오류 처리](/ko/learn/anthropic-python-sdk/)[Vercel AI SDK로 Claude 사용하기: createAnthropic baseURL, 스트리밍 및 문제 해결](/ko/learn/use-claude-api-with-vercel-ai-sdk/)[Claude로 Factory Droid 실행하기](/ko/learn/use-claude-api-with-factory-droid/)[Claude Code API 이해하기](/ko/learn/claude-code-api/)[애플리케이션에 Claude API 통합하기](/ko/learn/claude-api-integration/)[Claude를 무제한으로 사용하는 방법](/ko/learn/get-unlimited-claude-usage/)[Claude API 무제한 액세스의 의미](/ko/learn/unlimited-claude-api-access/)