홈 / 문서
Anthropic API 문서: Claude API 게이트웨이용 Anthropic API 문서
AI Prime Tech 게이트웨이용 Anthropic API 문서입니다. 동일한 Messages API와 모델 ID, 하나의 기본 URL과 하나의 키로 첫 curl 요청부터 프로덕션 환경 강화까지 다룹니다. 현재 제공되는 모든 Claude 모델을 지원합니다.
curl https://claudeapikey.dev/v1/messages -H "x-api-key: $ANTHROPIC_API_KEY" -H "anthropic-version: 2023-06-01" -H "content-type: application/json" -d '{"model": "claude-sonnet-5", "max_tokens": 1024,
"messages": [{"role": "user", "content": "Hello, Claude"}]}'네 단계로 시작하기
- 계정을 만들고 대시보드에서 API 키를 생성하세요.
- 설정할 항목:
ANTHROPIC_BASE_URL를 게이트웨이 호스트로 설정하고ANTHROPIC_API_KEY를 자신의 키로 설정하세요. SDK가/v1/messages를 자동으로 덧붙입니다. - Anthropic 형식(
/v1/messages) 또는 OpenAI 형식(/v1/chat/completions). - 다음에서 모델 ID를 선택하세요:
GET /v1/models; 문자열 하나를 변경하여 모델을 전환할 수 있습니다.
시작하기
소개AI Prime Tech가 무엇인지, 어떤 엔드포인트를 지원하는지, Anthropic을 직접 호출하는 것과 어떻게 다른지 알아보세요.빠른 시작키를 발급받고 환경 변수 두 개를 설정한 다음 약 일 분 만에 첫 요청을 보내세요.인증키를 전송하는 방법, 각 형식에 필요한 헤더, 키를 안전하게 보관하는 방법을 알아보세요.모델 및 키 그룹API 키로 사용할 수 있는 모델을 확인하고, 적절한 그룹을 선택하고, 최신 모델 요금을 확인하세요.기본 URL누구나 헷갈리는 설정 하나: 각 클라이언트가 요구하는 URL과 /v1 접미사 포함 여부.첫 요청 설명Messages 호출 하나를 줄별로 살펴보며 각 필드의 역할과 반환되는 내용을 설명합니다.
API 참조
API 개요게이트웨이가 제공하는 모든 엔드포인트와 각 엔드포인트가 사용하는 형식 및 반환하는 내용.Messages APIPOST /v1/messages — Anthropic 형식 엔드포인트: 매개변수, 응답 구조 및 예제.Chat Completions APIPOST /v1/chat/completions — Cursor, LangChain, LiteLLM 및 OpenAI SDK용 OpenAI 형식 엔드포인트.모델 엔드포인트GET /v1/models — 사용 중인 키로 호출할 수 있는 모델 ID를 정확히 확인하세요.스트리밍두 형식의 서버 전송 이벤트 — 이벤트 구조가 다르므로 혼동하면 아무 응답도 없는 것처럼 보입니다.오류게이트웨이가 반환하는 모든 상태 코드와 실제 발생 원인 및 해결 방법.요청 속도 제한요청 제한의 작동 방식, 여기서 429이 의미하는 것, 그리고 이를 유발하지 않는 클라이언트를 구현하는 방법.도구 사용 및 함수 호출모델이 함수를 호출하도록 설정하세요 — 요청 루프, 두 가지 형식, 토큰을 낭비하는 실수.비전 및 이미지 입력멀티모달 모델에 이미지를 보내세요 — 인코딩, 크기 제한 및 비용.
통합 가이드
Claude Code환경 변수 두 개로 Anthropic의 CLI 에이전트를 게이트웨이에 연결하고, 잘못된 키에 조용히 요금이 청구되는 함정을 피하세요.CursorAnthropic 계정 없이 OpenAI 호환 엔드포인트를 통해 Cursor에서 Claude 모델을 사용하세요.ClineAnthropic 형식 엔드포인트에 연결하도록 Cline VS Code 확장 프로그램을 설정하세요.Aider두 가지 통신 형식 중 하나로 터미널 페어 프로그래밍 도구를 게이트웨이에 연결해 실행하세요.ZedZed 편집기에 게이트웨이를 사용자 지정 어시스턴트 제공업체로 추가하세요.ContinueVS Code 및 JetBrains용 Continue 확장 프로그램을 설정하세요.VS Code 확장 프로그램사용자 지정 기본 URL을 지원하는 VS Code AI 확장 프로그램과 각 프로그램을 게이트웨이에 연결하는 방법.JetBrains IDEIntelliJ IDEA, PyCharm, WebStorm, GoLand 등 — Continue 또는 OpenAI 호환 플러그인을 통해 연결하세요.OpenCode오픈 소스 터미널 코딩 에이전트를 게이트웨이에 연결하세요.Codex CLIGPT 또는 Claude 모델로 OpenAI의 Codex CLI와 Codex IDE 확장 프로그램을 게이트웨이에 연결해 실행하세요.OpenClaw게이트웨이 모델을 사용하도록 OpenClaw 에이전트 프레임워크를 설정하세요.Claude Code용 MCP 서버실제로 유용한 모델 컨텍스트 프로토콜 설정과 시간을 낭비하게 만드는 함정.도구별 API 키 설정올바른 키 그룹을 선택한 다음 클라이언트에 필요한 키와 기본 URL을 사용하세요.
API 사용
비용 관리에이전트 작업에서 토큰이 실제로 소모되는 곳과 청구액을 바꾸는 네 가지 조절 요소.프롬프트 캐싱입력 요금의 일부만으로 고정된 접두사를 다시 읽으세요 — 캐시할 대상과 제외할 대상, 작동 여부를 확인하는 방법.컨텍스트 관리긴 세션의 비용이 비선형적으로 증가하는 이유와 대화 기록의 크기를 제한하는 패턴.Anthropic API에서 마이그레이션값 두 개만 변경하여 기존 Anthropic SDK 코드베이스를 이전하세요.OpenAI API에서 마이그레이션OpenAI SDK를 그대로 사용하면서 기본 URL을 변경해 Claude 모델에 접근하세요.프로덕션 모범 사례통합 시스템이 실제 트래픽을 처리하기 전에 올바르게 준비해야 할 사항.문제 해결증상별 색인 — 현재 나타나는 증상을 찾아 원인으로 바로 이동하세요.
SDK
SDK 개요공식 Anthropic 및 OpenAI SDK는 모두 수정 없이 작동합니다 — 선호하는 형식에 따라 선택하세요.Python스트리밍과 비동기 처리를 포함한 anthropic 및 openai 패키지의 실행 가능한 예제.TypeScript스트리밍을 포함한 @anthropic-ai/sdk 및 openai의 Node 예제.cURL모든 엔드포인트에 대한 의존성 없는 예제 — 디버깅과 CI 검사에 유용합니다.Go표준 라이브러리로 Go에서 게이트웨이를 호출하세요 — 타사 클라이언트가 필요하지 않습니다.
결제
요금크레딧이 토큰으로 환산되는 방식, 보너스의 내용 및 작업 비용 계산 방법.크레딧선불 잔액의 작동 방식, 잔액이 차감되는 항목, 실행 도중 잔액이 소진되는 일을 피하는 방법.무제한 요금제정해진 기간 동안 정액으로 이용 — 포함된 항목과 크레딧보다 유리한 경우.결제 수단카드와 암호화폐 — 어떤 것을 사용해야 하는지, 보너스가 다른 이유.환불 및 지원환불 가능한 항목과 불가능한 항목, 결제 문제를 문의하는 방법.
자료
자주 묻는 질문실제로 자주 받는 질문에 대한 명확한 답변.용어집이 문서 전반에서 사용하는 용어의 정확한 정의.보안 및 개인정보 보호키를 다루는 방법, 전송을 피해야 할 정보 및 이 서비스의 범위와 한계.변경 내역API 인터페이스, 모델 및 문서의 주요 변경 사항.서비스 상태 및 안정성게이트웨이가 업스트림 장애를 처리하는 방식과 서비스 성능이 저하되었을 때의 대응 방법.이용 가능 여부 및 결제 수단서비스를 사용할 수 있는 지역과 카드 결제망을 이용할 수 없을 때의 결제 방법.
학습
기술 문서와 함께 제공되는 구매자 중심의 해설.
Anthropic 호환 API의 의미Anthropic Python SDK: 설치, base_url, 스트리밍, 비동기 및 오류 처리 (2026)Claude API 크레딧 구매: 충전 및 설정 가이드Claude API를 가장 저렴하게 사용하는 방법Claude 서버 오류가 발생했나요? 모든 Claude API 오류 해설 — 400, 429 요청 제한, 500, 529 과부하 및 각 오류의 해결 방법무료 Claude API 키? 실제로 무료인 것은 무엇인가요 — Claude 무료 API, 체험 크레딧 및 가장 저렴한 실제 이용 옵션 (2026)Claude API 통합 가이드: SDK, REST 및 프로덕션 패턴Claude 모델 해설 2026 — Claude 모델 비교: Claude Opus, Sonnet, Haiku, Fable 비교 및 Anthropic 모델 이름과 가격Claude API 요금 해설Claude API 게이트웨이와 Anthropic 직접 이용 비교Claude API와 Claude Pro/Max 구독 — 어떤 것을 선택할까요암호화폐로 Claude API 요금 결제하기대기 명단 없이 Claude API 이용하기Claude Code 요금 해설: API 비용, 요금제 및 비용 절감 방법Claude Code API 키 (2026) — ANTHROPIC_API_KEY: 발급 방법, claude setup-token, OAuth 토큰과 세션 키 비교Claude Code API: 키, 기본 URL 및 결제 방식 (2026)Claude를 무제한으로 사용하는 방법: 요금제 및 제한Claude API 키 발급 방법: 콘솔 및 게이트웨이 설정Claude 토큰 사용량을 줄이는 방법OpenAI 호환 Claude API: OpenAI SDK로 Claude 사용하기(base_url, 스트리밍, 도구) (2026)자체 API에서 Claude로 Hermes Agent 사용하기: 사용자 지정 공급자 config.yaml 및 비용 관리 (2026)Claude에서 OpenClaw 무제한 실행하기무제한 Claude API: 제공 범위 및 공정 사용 제한무제한 Claude API 키를 발급받는 방법
Codex 및 GPT API 가이드: Codex API 키 및 이용 방법 · OpenAI 호환 API · Codex CLI 설정 · GPT-6 모델 비교