Source: https://aiprimetech.io/ko/docs/ [홈](/ko/) / 문서 # 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; 문자열 하나를 변경하여 모델을 전환할 수 있습니다. [빠른 시작약 일 분 만에 첫 요청 보내기](/ko/docs/getting-started/quickstart/)[Claude Code환경 변수 두 개](/ko/docs/guides/claude-code/)[모델ID, 컨텍스트 윈도, 요금](/ko/docs/getting-started/models/)[API 참조엔드포인트 및 스키마](/ko/docs/api-reference/overview/) ## 시작하기 [소개AI Prime Tech가 무엇인지, 어떤 엔드포인트를 지원하는지, Anthropic을 직접 호출하는 것과 어떻게 다른지 알아보세요.](/ko/docs/getting-started/introduction/)[빠른 시작키를 발급받고 환경 변수 두 개를 설정한 다음 약 일 분 만에 첫 요청을 보내세요.](/ko/docs/getting-started/quickstart/)[인증키를 전송하는 방법, 각 형식에 필요한 헤더, 키를 안전하게 보관하는 방법을 알아보세요.](/ko/docs/getting-started/authentication/)[모델 및 키 그룹API 키로 사용할 수 있는 모델을 확인하고, 적절한 그룹을 선택하고, 최신 모델 요금을 확인하세요.](/ko/docs/getting-started/models/)[기본 URL누구나 헷갈리는 설정 하나: 각 클라이언트가 요구하는 URL과 /v1 접미사 포함 여부.](/ko/docs/getting-started/base-urls/)[첫 요청 설명Messages 호출 하나를 줄별로 살펴보며 각 필드의 역할과 반환되는 내용을 설명합니다.](/ko/docs/getting-started/first-request/) ## API 참조 [API 개요게이트웨이가 제공하는 모든 엔드포인트와 각 엔드포인트가 사용하는 형식 및 반환하는 내용.](/ko/docs/api-reference/overview/)[Messages APIPOST /v1/messages — Anthropic 형식 엔드포인트: 매개변수, 응답 구조 및 예제.](/ko/docs/api-reference/messages/)[Chat Completions APIPOST /v1/chat/completions — Cursor, LangChain, LiteLLM 및 OpenAI SDK용 OpenAI 형식 엔드포인트.](/ko/docs/api-reference/chat-completions/)[모델 엔드포인트GET /v1/models — 사용 중인 키로 호출할 수 있는 모델 ID를 정확히 확인하세요.](/ko/docs/api-reference/models-endpoint/)[스트리밍두 형식의 서버 전송 이벤트 — 이벤트 구조가 다르므로 혼동하면 아무 응답도 없는 것처럼 보입니다.](/ko/docs/api-reference/streaming/)[오류게이트웨이가 반환하는 모든 상태 코드와 실제 발생 원인 및 해결 방법.](/ko/docs/api-reference/errors/)[요청 속도 제한요청 제한의 작동 방식, 여기서 429이 의미하는 것, 그리고 이를 유발하지 않는 클라이언트를 구현하는 방법.](/ko/docs/api-reference/rate-limits/)[도구 사용 및 함수 호출모델이 함수를 호출하도록 설정하세요 — 요청 루프, 두 가지 형식, 토큰을 낭비하는 실수.](/ko/docs/api-reference/tool-use/)[비전 및 이미지 입력멀티모달 모델에 이미지를 보내세요 — 인코딩, 크기 제한 및 비용.](/ko/docs/api-reference/vision/) ## 통합 가이드 [Claude Code환경 변수 두 개로 Anthropic의 CLI 에이전트를 게이트웨이에 연결하고, 잘못된 키에 조용히 요금이 청구되는 함정을 피하세요.](/ko/docs/guides/claude-code/)[CursorAnthropic 계정 없이 OpenAI 호환 엔드포인트를 통해 Cursor에서 Claude 모델을 사용하세요.](/ko/docs/guides/cursor/)[ClineAnthropic 형식 엔드포인트에 연결하도록 Cline VS Code 확장 프로그램을 설정하세요.](/ko/docs/guides/cline/)[Aider두 가지 통신 형식 중 하나로 터미널 페어 프로그래밍 도구를 게이트웨이에 연결해 실행하세요.](/ko/docs/guides/aider/)[ZedZed 편집기에 게이트웨이를 사용자 지정 어시스턴트 제공업체로 추가하세요.](/ko/docs/guides/zed/)[ContinueVS Code 및 JetBrains용 Continue 확장 프로그램을 설정하세요.](/ko/docs/guides/continue/)[VS Code 확장 프로그램사용자 지정 기본 URL을 지원하는 VS Code AI 확장 프로그램과 각 프로그램을 게이트웨이에 연결하는 방법.](/ko/docs/guides/vscode-extensions/)[JetBrains IDEIntelliJ IDEA, PyCharm, WebStorm, GoLand 등 — Continue 또는 OpenAI 호환 플러그인을 통해 연결하세요.](/ko/docs/guides/jetbrains/)[OpenCode오픈 소스 터미널 코딩 에이전트를 게이트웨이에 연결하세요.](/ko/docs/guides/opencode/)[Codex CLIGPT 또는 Claude 모델로 OpenAI의 Codex CLI와 Codex IDE 확장 프로그램을 게이트웨이에 연결해 실행하세요.](/ko/docs/guides/codex-cli/)[OpenClaw게이트웨이 모델을 사용하도록 OpenClaw 에이전트 프레임워크를 설정하세요.](/ko/docs/guides/openclaw/)[Claude Code용 MCP 서버실제로 유용한 모델 컨텍스트 프로토콜 설정과 시간을 낭비하게 만드는 함정.](/ko/docs/guides/mcp-servers/)[도구별 API 키 설정올바른 키 그룹을 선택한 다음 클라이언트에 필요한 키와 기본 URL을 사용하세요.](/ko/docs/guides/api-key-configuration/) ## API 사용 [비용 관리에이전트 작업에서 토큰이 실제로 소모되는 곳과 청구액을 바꾸는 네 가지 조절 요소.](/ko/docs/guides/cost-control/)[프롬프트 캐싱입력 요금의 일부만으로 고정된 접두사를 다시 읽으세요 — 캐시할 대상과 제외할 대상, 작동 여부를 확인하는 방법.](/ko/docs/guides/prompt-caching/)[컨텍스트 관리긴 세션의 비용이 비선형적으로 증가하는 이유와 대화 기록의 크기를 제한하는 패턴.](/ko/docs/guides/context-management/)[Anthropic API에서 마이그레이션값 두 개만 변경하여 기존 Anthropic SDK 코드베이스를 이전하세요.](/ko/docs/guides/migration-from-anthropic/)[OpenAI API에서 마이그레이션OpenAI SDK를 그대로 사용하면서 기본 URL을 변경해 Claude 모델에 접근하세요.](/ko/docs/guides/migration-from-openai/)[프로덕션 모범 사례통합 시스템이 실제 트래픽을 처리하기 전에 올바르게 준비해야 할 사항.](/ko/docs/guides/best-practices/)[문제 해결증상별 색인 — 현재 나타나는 증상을 찾아 원인으로 바로 이동하세요.](/ko/docs/guides/troubleshooting/) ## SDK [SDK 개요공식 Anthropic 및 OpenAI SDK는 모두 수정 없이 작동합니다 — 선호하는 형식에 따라 선택하세요.](/ko/docs/sdks/)[Python스트리밍과 비동기 처리를 포함한 anthropic 및 openai 패키지의 실행 가능한 예제.](/ko/docs/sdks/python/)[TypeScript스트리밍을 포함한 @anthropic-ai/sdk 및 openai의 Node 예제.](/ko/docs/sdks/typescript/)[cURL모든 엔드포인트에 대한 의존성 없는 예제 — 디버깅과 CI 검사에 유용합니다.](/ko/docs/sdks/curl/)[Go표준 라이브러리로 Go에서 게이트웨이를 호출하세요 — 타사 클라이언트가 필요하지 않습니다.](/ko/docs/sdks/go/) ## 결제 [요금크레딧이 토큰으로 환산되는 방식, 보너스의 내용 및 작업 비용 계산 방법.](/ko/docs/billing/pricing/)[크레딧선불 잔액의 작동 방식, 잔액이 차감되는 항목, 실행 도중 잔액이 소진되는 일을 피하는 방법.](/ko/docs/billing/credits/)[무제한 요금제정해진 기간 동안 정액으로 이용 — 포함된 항목과 크레딧보다 유리한 경우.](/ko/docs/billing/plans/)[결제 수단카드와 암호화폐 — 어떤 것을 사용해야 하는지, 보너스가 다른 이유.](/ko/docs/billing/payment-methods/)[환불 및 지원환불 가능한 항목과 불가능한 항목, 결제 문제를 문의하는 방법.](/ko/docs/billing/refunds/) ## 자료 [자주 묻는 질문실제로 자주 받는 질문에 대한 명확한 답변.](/ko/docs/resources/faq/)[용어집이 문서 전반에서 사용하는 용어의 정확한 정의.](/ko/docs/resources/glossary/)[보안 및 개인정보 보호키를 다루는 방법, 전송을 피해야 할 정보 및 이 서비스의 범위와 한계.](/ko/docs/resources/security/)[변경 내역API 인터페이스, 모델 및 문서의 주요 변경 사항.](/ko/docs/resources/changelog/)[서비스 상태 및 안정성게이트웨이가 업스트림 장애를 처리하는 방식과 서비스 성능이 저하되었을 때의 대응 방법.](/ko/docs/resources/status/)[이용 가능 여부 및 결제 수단서비스를 사용할 수 있는 지역과 카드 결제망을 이용할 수 없을 때의 결제 방법.](/ko/docs/resources/supported-countries/) ## 학습 기술 문서와 함께 제공되는 구매자 중심의 해설. [Anthropic 호환 API의 의미](/ko/learn/anthropic-compatible-api/)[Anthropic Python SDK: 설치, base_url, 스트리밍, 비동기 및 오류 처리 (2026)](/ko/learn/anthropic-python-sdk/)[Claude API 크레딧 구매: 충전 및 설정 가이드](/ko/learn/buy-claude-api-credits/)[Claude API를 가장 저렴하게 사용하는 방법](/ko/learn/cheapest-way-to-use-claude-api/)[Claude 서버 오류가 발생했나요? 모든 Claude API 오류 해설 — 400, 429 요청 제한, 500, 529 과부하 및 각 오류의 해결 방법](/ko/learn/claude-api-errors-troubleshooting/)[무료 Claude API 키? 실제로 무료인 것은 무엇인가요 — Claude 무료 API, 체험 크레딧 및 가장 저렴한 실제 이용 옵션 (2026)](/ko/learn/claude-api-free-trial/)[Claude API 통합 가이드: SDK, REST 및 프로덕션 패턴](/ko/learn/claude-api-integration/)[Claude 모델 해설 2026 — Claude 모델 비교: Claude Opus, Sonnet, Haiku, Fable 비교 및 Anthropic 모델 이름과 가격](/ko/learn/claude-api-models-compared/)[Claude API 요금 해설](/ko/learn/claude-api-pricing-explained/)[Claude API 게이트웨이와 Anthropic 직접 이용 비교](/ko/learn/claude-api-vs-anthropic-direct/)[Claude API와 Claude Pro/Max 구독 — 어떤 것을 선택할까요](/ko/learn/claude-api-vs-subscription/)[암호화폐로 Claude API 요금 결제하기](/ko/learn/claude-api-with-crypto-payment/)[대기 명단 없이 Claude API 이용하기](/ko/learn/claude-api-without-waitlist/)[Claude Code 요금 해설: API 비용, 요금제 및 비용 절감 방법](/ko/learn/claude-code-api-costs/)[Claude Code API 키 (2026) — ANTHROPIC_API_KEY: 발급 방법, claude setup-token, OAuth 토큰과 세션 키 비교](/ko/learn/claude-code-api-key-setup/)[Claude Code API: 키, 기본 URL 및 결제 방식 (2026)](/ko/learn/claude-code-api/)[Claude를 무제한으로 사용하는 방법: 요금제 및 제한](/ko/learn/get-unlimited-claude-usage/)[Claude API 키 발급 방법: 콘솔 및 게이트웨이 설정](/ko/learn/how-to-get-a-claude-api-key/)[Claude 토큰 사용량을 줄이는 방법](/ko/learn/how-to-reduce-claude-token-usage/)[OpenAI 호환 Claude API: OpenAI SDK로 Claude 사용하기(base_url, 스트리밍, 도구) (2026)](/ko/learn/openai-compatible-claude-api/)[자체 API에서 Claude로 Hermes Agent 사용하기: 사용자 지정 공급자 config.yaml 및 비용 관리 (2026)](/ko/learn/run-hermes-agent-with-claude-api/)[Claude에서 OpenClaw 무제한 실행하기](/ko/learn/run-openclaw-with-claude-api/)[무제한 Claude API: 제공 범위 및 공정 사용 제한](/ko/learn/unlimited-claude-api-access/)[무제한 Claude API 키를 발급받는 방법](/ko/learn/unlimited-claude-api-key/) [학습 문서 45개 모두 보기 →](/ko/learn/) Codex 및 GPT API 가이드: [Codex API 키 및 이용 방법](/ko/codex-api/) · [OpenAI 호환 API](/ko/openai-api/) · [Codex CLI 설정](/ko/docs/guides/codex-cli/) · [GPT-6 모델 비교](/ko/blog/gpt-6-models-for-codex/)