2. HTTP로 Claude API 호출하기

에이전트 만들기 첫걸음으로 API를 호출해보려고 한다.

 

저번에도 말했듯이 구독 or API 키를 사용해 AI 모델을 불러올 수 있다.

 

API 키는 

 

https://platform.claude.com/

Claude Platform

여기서 클로드 코드 API를 가져올 수 있고,

 

https://platform.openai.com

OpenAI Platform

여기서는 gpt 모델을 가져올 수 있다.

 

뭐.. 딥시크나 glm도 가져오라면 가져올 수 있다! (사실 딥시크가 api키는 현재 가장 싸다.) (2달러 결제도 있어서)

 

딥시크의 경우에 openai api 호출방식을 그대로 사용하기 때문에 나중에 같이 알아보도록하고.

 

지금은 claude code api키를 사용해서 호출해보려고 한다.

 

 

가장 먼저 파워쉘을 열어준다. (윈도우는 파워쉘, 맥은 터미널)

$env:ANTHROPIC_API_KEY = "여기"

발급 받은 api키를 임시로 환경변수에 등록하는거다. 여기 라고 되어 잇는 위치에 api키를 발급받아 넣으면 된다.

 

echo $env:ANTHROPIC_API_KEY

다음과 같이 터미널에 입력했을때 api 키가 나오면 된다.

 

그리고 다음과 같이 입력해보자.

curl https://api.anthropic.com/v1/messages `
  -H "x-api-key: $env:ANTHROPIC_API_KEY" `
  -H "anthropic-version: 2023-06-01" `
  -H "content-type: application/json" `
  -d '{
    "model": "claude-haiku-4-5-20251001",
    "max_tokens": 200,
    "messages": [{"role": "user", "content": "안녕, 한 문장으로 자기소개해"}]
  }'

 

이미지와 같이 응답이 오면 성공!

여기서 주로 봐야될건

x-api-key = 우리가 등록한 환경변수의 키를 가져다 넣음

model = 사용할 모델 (haiku는 앤트로픽이 제공하는 가장 싸고 빠른 모델)

max_tokens = 답 최대 길이 (필수적으로 넣어야한다)

messages = 우리가 넣을 대화이다. (role은 사용자가 넣은 메시지인지 에이전트가 넣은 메시지인지 구분하기 위해 넣는다)

 

{
   "model":"claude-haiku-4-5-20251001",
   "id":"msg_011CdLkMhSAZ2trDxFPWbF5F",
   "type":"message",
   "role":"assistant",
   "content":[
      {
         "type":"text",
         "text":"안녕하세요! 저는 Claude라는 AI 어시스턴트로, 다양한질문에 답변하고 창의적인 작업을 도와드리는 것을 즐깁니다. 😊"
      }
   ],
   "stop_reason":"end_turn",
   "stop_sequence":null,
   "stop_details":null,
   "usage":{
      "input_tokens":25,
      "cache_creation_input_tokens":0,
      "cache_read_input_tokens":0,
      "cache_creation":{
         "ephemeral_5m_input_tokens":0,
         "ephemeral_1h_input_tokens":0
      },
      "output_tokens":71,
      "service_tier":"standard",
      "inference_geo":"not_available"
   }
}

응답온 json 인데,

주로 봐야할건,

content = 응답

stop_reason = 응답이 끝난 이유( 공부하면서 작성 중이라서 예상이지만 end_turn은 종료고, 나중에 tool_use가 있다면 이어서 툴 사용하게끔 붙이지 않을까 싶다.) 추후에 알아보도록 하자..

usage = 사용한 토큰양

 

 http 요청을 통해서 claude code api를 요청 해봤는데, 생각보다 쉽다^.

다음에는 이걸 그대로 파이썬으로 만들어 보도록 하자.