홈 / 학습 / LangChain의 ChatAnthropic: 가져오기, base_url, 스트리밍, 도구 및 오류
Claude + LangChain. 작은 문서 카드로 만든 손그림 스타일의 체인 고리들이 프롬프트 시트, 모델 창, 최종 결과를 차례로 연결합니다.

LangChain의 ChatAnthropic: 가져오기, base_url, 스트리밍, 도구 및 오류

ChatAnthropic 다음 패키지의 langchain-anthropic 패키지에서 제공하는 LangChain의 Claude 채팅 모델입니다. 공식 Anthropic Python SDK를 래핑하므로, 게이트웨이에 연결하려면 인수 하나만 지정하면 됩니다. base_url을 호스트 루트로 설정하세요. 체인, 에이전트, 도구의 나머지 부분은 모두 그대로 유지됩니다.

설치 및 가져오기

터미널
pip install -U langchain-anthropic
app.py
from langchain_anthropic import ChatAnthropic

llm = ChatAnthropic(
    model="claude-sonnet-5",
    base_url="https://aiprimetech.io",           # host root: the SDK adds /v1/messages
    api_key="your_gateway_key",   # or set ANTHROPIC_API_KEY
)

print(llm.invoke("Say hello in one word.").text)
아니요 /v1 에서 base_url 를 여기에 사용하세요. 기반 Anthropic SDK가 다음을 추가합니다. /v1/messages 을 자체적으로 추가하므로, 다음을 추가하면 /v1 다음이 생성됩니다. /v1/v1/messages 및 404 page not found.

환경 변수로 구성하기

base_url 은 다음의 별칭입니다. anthropic_api_url및 api_key 은 다음의 별칭입니다. anthropic_api_key. 이를 전달하지 않으면 ChatAnthropic은 다음을 읽습니다. ANTHROPIC_API_URL 을 먼저 읽고, 그다음에는 ANTHROPIC_BASE_URL을 읽으며, 키는 다음에서 가져옵니다. ANTHROPIC_API_KEY. 명시적으로 전달한 인수가 항상 우선합니다.

터미널
export ANTHROPIC_API_KEY=your_gateway_key
export ANTHROPIC_API_URL=https://aiprimetech.io
app.py
from langchain_anthropic import ChatAnthropic

llm = ChatAnthropic(model="claude-sonnet-5")   # picks up the gateway from the environment

스트리밍

app.py
for chunk in llm.stream("Explain backpressure in two sentences."):
    print(chunk.text, end="", flush=True)

.text 은 각 청크의 텍스트 블록만 수집하므로, 모델이 사고 블록이나 도구 사용 블록을 함께 출력해도 결과가 깔끔하게 유지됩니다. 긴 답변에는 스트리밍을 사용하세요. 긴 비스트리밍 요청은 시간 초과의 일반적인 원인입니다.

도구 및 구조화된 출력

tools.py
from langchain_core.tools import tool

@tool
def get_time(city: str) -> str:
    """Return the current local time in a city."""
    return "12:00"

msg = llm.bind_tools([get_time]).invoke("What time is it in Tokyo?")
print(msg.tool_calls)
structured.py
from pydantic import BaseModel

class Weather(BaseModel):
    city: str
    temperature_c: float

print(llm.with_structured_output(Weather).invoke("It is 21 degrees in Lisbon today."))

재시도, 시간 제한 및 max_tokens

max_retries 기본값은 2으로, Anthropic SDK와 동일합니다. 연결 오류, 429 및 5xx 응답에 대해 재시도합니다. timeout (다음의 별칭: default_request_timeout)의 단위는 초입니다. max_tokens 을 설정하지 않으면 모델 프로필의 값을 사용합니다.

app.py
llm = ChatAnthropic(
    model="claude-sonnet-5",
    base_url="https://aiprimetech.io",
    max_retries=4,
    timeout=120,
    max_tokens=8000,
)

배치 처리에서는 키의 동시 실행 한도를 넘지 않도록 병렬 실행 수를 제한하세요: llm.batch(inputs, config={"max_concurrency": 3}).

ChatOpenAI를 사용하는 대안

코드를 다음으로 표준화했다면 ChatOpenAI, 게이트웨이의 OpenAI 호환 엔드포인트로 Claude도 사용할 수 있습니다. 이 방식에서는 끝에 다음을 붙여야 합니다: /v1 . ChatAnthropic과는 반대입니다.

app.py
from langchain_openai import ChatOpenAI

llm = ChatOpenAI(model="claude-sonnet-5", base_url="https://aiprimetech.io/v1", api_key="your_gateway_key")

Claude에는 ChatAnthropic 사용을 권장합니다. 프롬프트 캐싱과 사고 블록 같은 네이티브 기능을 유지할 수 있습니다.

문제 해결

표시되는 내용 원인 해결 방법
404 page not found/v1 ChatAnthropic의 다음 항목에 base_url호스트 루트를 사용하세요: https://aiprimetech.io
Model "..." is not supported키가 속한 그룹에서 제공하지 않는 ID 또는 날짜가 포함된 이전 이름아래 표의 최신 ID를 사용하세요
AuthenticationErrorANTHROPIC_API_KEY 실행 중인 프로세스에서 비어 있거나 다른 엔드포인트용 키인 경우전달하세요: api_key= 을 명시적으로 전달하여 테스트하세요
RateLimitError: Concurrency limit exceeded병렬 호출이 너무 많음(batch, 비동기 gather)max_concurrency 배치 설정에서
APITimeoutError스트리밍을 사용하지 않는 긴 생성 작업스트리밍을 사용하거나 다음 값을 늘리세요: timeout
모델 ID 권장 용도
claude-sonnet-5코딩과 에이전트 작업의 기본 선택: 빠르고 성능이 뛰어나며 가격은 중간 수준입니다.
claude-opus-5-5더 어려운 추론, 대규모 리팩터링, 장시간 에이전트 실행.
claude-fable-5-1성능이 가장 뛰어나고 가격도 가장 높습니다. 가장 어려운 작업에 사용하세요.
claude-haiku-4-5저렴하고 빠름: 제목, 요약, 분류, 간단한 단계.

자주 묻는 질문

ChatAnthropic은 어떻게 가져오나요?
pip install -U langchain-anthropic을 실행한 다음 from langchain_anthropic import ChatAnthropic으로 가져오세요.
ChatAnthropic의 base_url에 /v1이 필요한가요?
아니요. https://aiprimetech.io; 같은 호스트 루트를 전달하세요. Anthropic SDK가 /v1/messages를 추가합니다. ChatOpenAI는 반대로 /v1이 필요합니다.
ChatAnthropic은 어떤 환경 변수를 읽나요?
키에는 ANTHROPIC_API_KEY을 사용하며, base_url을 전달하지 않으면 엔드포인트에는 ANTHROPIC_API_URL, 그다음 ANTHROPIC_BASE_URL를 사용합니다.
base_url은 anthropic_api_url과 같은가요?
네. base_url은 anthropic_api_url의 별칭이고, api_key는 anthropic_api_key의 별칭입니다.
몇 분 만에 Claude 사용 시작하기

API 키를 발급받으세요 — Anthropic 계정이나 대기자 명단 등록이 필요하지 않습니다.

API 키 발급받기

AI Prime Tech는 독립적인 API 게이트웨이입니다. Anthropic과 제휴 관계가 없으며, Anthropic의 보증을 받거나 Anthropic의 리셀러로 활동하지 않습니다. Claude 및 관련 모델 이름은 각 소유자의 상표입니다.

더 많은 Claude API 가이드

Claude API 키 발급 방법Claude API 요금 해설Claude API를 가장 저렴하게 사용하는 방법Claude API로 Cursor 무제한 사용Claude Code 무제한 이용Claude API 게이트웨이와 Anthropic 직접 이용 비교OpenAI 호환 API를 통해 Claude 사용하기Claude 모델 해설: Claude Opus, Sonnet, Haiku, Fable 비교 — 모든 Claude API 모델, Anthropic 모델 이름 및 가격 (2026)암호화폐로 Claude API 요금 결제하기대기 명단 없이 Claude API 이용하기Claude 토큰 사용량을 줄이는 방법Claude API로 Cline 무제한 사용Claude API로 Roo Code 무제한 사용JetBrains IDE에서 Claude 무제한 사용Claude API로 Aider 무제한 사용하기VS Code에서 Claude 무제한 사용Claude용 OpenCode 구성: opencode.json 설정, 모델 및 일반적인 오류Claude에서 Hermes 에이전트 무제한 실행하기Claude에서 OpenClaw 무제한 실행하기Anthropic 호환 API의 의미Claude Code API 키 — ANTHROPIC_API_KEY: 발급 및 설정 방법과 대신 claude setup-token을 사용해야 하는 경우Claude Code API 비용 — 요금과 절감 방법Claude API 오류 설명: 서버 오류 500, 과부하 529, 사용량 제한 429, 잘못된 요청 400 — 각 오류의 해결 방법Claude API 크레딧 구매 방법 — 그리고 Claude 크레딧이 어떤 "Claude 계정 구매" 상품보다 나은 이유Claude 무료 API: 무료 Claude API 키가 있나요? 2026년에 실제로 무료인 것은 무엇인가요?Claude API와 Claude Pro/Max 구독 — 어떤 것을 선택할까요Claude에서 Codex CLI 실행하기Claude를 n8n에 연결하기LiteLLM을 Claude로 라우팅하기Kilo Code에서 Claude 사용하기GitHub Copilot에 Claude 연결하기게이트웨이를 통해 Zed를 Claude에 연결하기Cherry Studio를 Claude에 연결하기Anthropic Python SDK: 설치, base_url 설정, 스트리밍 및 오류 처리Vercel AI SDK로 Claude 사용하기: createAnthropic baseURL, 스트리밍 및 문제 해결Claude로 Factory Droid 실행하기Claude Code API 이해하기애플리케이션에 Claude API 통합하기Claude를 무제한으로 사용하는 방법 — 그리고 "Claude Code 크랙 버전"이 없는 이유

Claude API 가이드 더 보기

Anthropic 호환 API의 의미Anthropic Python SDK: 설치, base_url 설정, 스트리밍 및 오류 처리Claude API 크레딧 구매 방법Claude API를 가장 저렴하게 사용하는 방법Claude API 오류 설명: 서버 오류 500, 과부하 529, 사용량 제한 429, 잘못된 요청 400 — 각 오류의 해결 방법Claude 무료 API: 무료 Claude API 키가 있나요? 2026년에 실제로 무료인 것은 무엇인가요?애플리케이션에 Claude API 통합하기Claude 모델 해설: Claude Opus, Sonnet, Haiku, Fable 비교 — 모든 Claude API 모델, Anthropic 모델 이름 및 가격 (2026)Claude API 요금 해설Claude API 게이트웨이와 Anthropic 직접 이용 비교Claude API와 Claude Pro/Max 구독 — 어떤 것을 선택할까요암호화폐로 Claude API 요금 결제하기대기 명단 없이 Claude API 이용하기Claude Code API 이해하기Claude Code API 비용 — 요금과 절감 방법Claude Code API 키 — ANTHROPIC_API_KEY: 발급 및 설정 방법과 대신 claude setup-token을 사용해야 하는 경우Claude를 무제한으로 사용하는 방법Claude API 키 발급 방법Claude 토큰 사용량을 줄이는 방법OpenAI SDK로 Claude 사용하기: OpenAI 호환 엔드포인트, 스트리밍, 도구 및 제한게이트웨이를 통해 Claude와 함께 사용하는 Hermes Agent: 사용자 지정 제공업체 설정, 비용 관리 및 문제 해결Claude에서 OpenClaw 무제한 실행하기Claude API 무제한 액세스의 의미무제한 Claude API 키를 발급받는 방법Claude Code 무제한 사용 — 토큰 제한 없음Claude Opus 4.8 무제한 이용Claude 무제한 사용 — 요금제 및 가격게이트웨이를 통해 Claude와 함께 사용하는 Aider: ANTHROPIC_API_BASE, 구성 파일, architect 모드 및 문제 해결Cherry Studio를 Claude에 연결하기Claude Code 무제한 이용Claude API로 Cline 무제한 사용사용자 지정 제공업체와 함께 사용하는 Codex CLI: config.toml, GPT 및 Claude 모델, IDE 확장 프로그램 및 문제 해결Claude 무제한 이용으로 Cursor 실행하기Claude로 Factory Droid 실행하기게이트웨이를 통해 Claude와 함께 사용하는 GitHub Copilot Chat: Custom Endpoint 설정, 에이전트 모드 및 문제 해결JetBrains IDE에서 Claude 무제한 사용Kilo Code에서 Claude 사용하기LiteLLM을 Claude로 라우팅하기Claude를 n8n에 연결하기Claude용 OpenCode 구성: opencode.json 설정, 모델 및 일반적인 오류Claude API로 Roo Code 무제한 사용Vercel AI SDK로 Claude 사용하기: createAnthropic baseURL, 스트리밍 및 문제 해결VS Code에서 Claude 무제한 사용게이트웨이를 통해 Zed를 Claude에 연결하기