Claude에 접근하는 다섯 가지 방법

Published: at 04:45 PM

들어가며

이전 차시에서 학생과 교육 기관을 위한 Claude 사용 방법을 알아봤다. 이번에는 Claude에 접근하는 다양한 방법을 학습한다.

Claude는 다섯 가지 방법으로 사용할 수 있다. claude.ai 웹 인터페이스, API 직접 호출, 그리고 세 가지 클라우드 플랫폼(AWS Bedrock, Google Vertex AI, Microsoft Foundry)이다. 각 방법의 특징과 장단점을 이해하고 상황에 맞는 접근 방법을 선택할 수 있도록 하자.

접근 방법 개요

방법장점단점적합한 경우
claude.ai설치 불필요, 즉시 사용프로그래밍 통합 불가일반 사용, 테스트
API 직접 호출최신 기능, 유연성코딩 필요개발자, 커스텀 앱
AWS BedrockAWS 통합, IAM 활용AWS 의존성AWS 사용 조직
Google Vertex AIGCP 통합, 글로벌 엔드포인트GCP 의존성GCP 사용 조직
Microsoft FoundryAzure 통합, GPT와 함께 사용Enterprise 구독 필요Azure 사용 조직

claude.ai 웹 인터페이스

개요

claude.ai는 브라우저에서 Claude를 사용하는 가장 간단한 방법이다. 계정만 만들면 바로 시작할 수 있다.

주요 기능

대화

파일 처리

프로젝트

장점

단점

적합한 경우

API 직접 호출

개요

Anthropic이 직접 제공하는 API를 통해 Claude를 호출하는 방법이다. 가장 최신 기능을 사용할 수 있고 유연성이 높다.

API 키 발급

  1. Claude Platform 접속
  2. 계정 생성 또는 로그인
  3. API Keys 섹션에서 새 키 생성
  4. 키를 안전하게 저장 (다시 표시되지 않음)

환경 변수 설정

# Linux/macOS
export ANTHROPIC_API_KEY="your-api-key"

# Windows PowerShell
$env:ANTHROPIC_API_KEY="your-api-key"

SDK 설치

Python

pip install anthropic

TypeScript/JavaScript

npm install @anthropic-ai/sdk

Java

<dependency>
    <groupId>com.anthropic</groupId>
    <artifactId>anthropic-sdk-java</artifactId>
    <version>2.18.0</version>
</dependency>

Go

go get github.com/anthropics/anthropic-sdk-go

기본 사용 예제

Python

import anthropic

client = anthropic.Anthropic()

message = client.messages.create(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "안녕하세요, Claude!"}
    ]
)
print(message.content[0].text)

TypeScript

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic();

const message = await client.messages.create({
    model: "claude-sonnet-4-5-20250929",
    max_tokens: 1024,
    messages: [
        { role: "user", content: "안녕하세요, Claude!" }
    ]
});
console.log(message.content[0].text);

스트리밍

실시간으로 응답을 받으려면 스트리밍을 사용한다.

Python

with client.messages.stream(
    model="claude-sonnet-4-5-20250929",
    max_tokens=1024,
    messages=[{"role": "user", "content": "긴 이야기를 해주세요."}]
) as stream:
    for text in stream.text_stream:
        print(text, end="", flush=True)

TypeScript

const stream = await client.messages.create({
    model: "claude-sonnet-4-5-20250929",
    max_tokens: 1024,
    messages: [{ role: "user", content: "긴 이야기를 해주세요." }],
    stream: true
});

for await (const event of stream) {
    if (event.type === "content_block_delta" &&
        event.delta.type === "text_delta") {
        process.stdout.write(event.delta.text);
    }
}

비동기 처리 (Python)

import asyncio
import anthropic

async def main():
    client = anthropic.AsyncAnthropic()

    message = await client.messages.create(
        model="claude-sonnet-4-5-20250929",
        max_tokens=1024,
        messages=[{"role": "user", "content": "안녕하세요!"}]
    )
    print(message.content[0].text)

asyncio.run(main())

에러 처리

Python

from anthropic import APIError, RateLimitError, AuthenticationError

try:
    message = client.messages.create(...)
except AuthenticationError:
    print("API 키가 올바르지 않다.")
except RateLimitError:
    print("요청 한도를 초과했다.")
except APIError as e:
    print(f"API 오류: {e}")

장점

단점

적합한 경우

AWS Bedrock

개요

Amazon Bedrock은 AWS 환경에서 Claude를 사용할 수 있게 해주는 서비스다. AWS IAM, VPC 등 기존 AWS 인프라와 통합할 수 있다.

사전 요구사항

모델 접근 요청

  1. AWS Console에서 Bedrock 서비스로 이동
  2. Model Access에서 Anthropic 모델 선택
  3. Request model access 클릭
  4. 대부분의 Claude 모델은 자동 승인

사용 가능한 모델

모델모델 ID글로벌미국유럽일본
Claude Opus 4.6anthropic.claude-opus-4-6-v1✓✓✓✓
Claude Sonnet 4.6anthropic.claude-sonnet-4-6✓✓✓✓
Claude Sonnet 4.5anthropic.claude-sonnet-4-5-20250929-v1:0✓✓✓✓
Claude Haiku 4.5anthropic.claude-haiku-4-5-20251001-v1:0✓✓✓✗

SDK 설치

Python

pip install -U "anthropic[bedrock]"

TypeScript

npm install @anthropic-ai/bedrock-sdk

기본 사용 예제

Python

from anthropic import AnthropicBedrock

client = AnthropicBedrock(
    aws_region="us-west-2"
)

message = client.messages.create(
    model="global.anthropic.claude-opus-4-6-v1",
    max_tokens=256,
    messages=[{"role": "user", "content": "안녕하세요!"}]
)
print(message.content[0].text)

TypeScript

import AnthropicBedrock from "@anthropic-ai/bedrock-sdk";

const client = new AnthropicBedrock({
    awsRegion: "us-west-2"
});

const message = await client.messages.create({
    model: "global.anthropic.claude-opus-4-6-v1",
    max_tokens: 256,
    messages: [{ role: "user", content: "안녕하세요!" }]
});
console.log(message.content[0].text);

글로벌 vs 리전 엔드포인트

Claude Sonnet 4.5 이후 모델부터 두 가지 엔드포인트를 제공한다.

글로벌 엔드포인트 (권장)

리전 엔드포인트 (CRIS)

Claude Code와 함께 사용

Claude Code에서 Bedrock을 사용하려면 환경 변수를 설정한다.

export CLAUDE_CODE_USE_BEDROCK=1
export AWS_REGION=us-west-2
export ANTHROPIC_MODEL='global.anthropic.claude-sonnet-4-5-20250929-v1:0'

장점

단점

적합한 경우

Google Vertex AI

개요

Google Vertex AI는 GCP 환경에서 Claude를 사용할 수 있게 해준다. Google Cloud 프로젝트와 통합되어 기존 GCP 워크플로우에 쉽게 추가할 수 있다.

사전 요구사항

Vertex AI API 활성화

gcloud config set project YOUR-PROJECT-ID
gcloud services enable aiplatform.googleapis.com

사용 가능한 모델

모델Vertex AI 모델 ID
Claude Opus 4.6claude-opus-4-6
Claude Sonnet 4.6claude-sonnet-4-6
Claude Sonnet 4.5claude-sonnet-4-5@20250929
Claude Haiku 4.5claude-haiku-4-5@20251001

SDK 설치

Python

pip install -U google-cloud-aiplatform "anthropic[vertex]"

TypeScript

npm install @anthropic-ai/vertex-sdk

기본 사용 예제

Python

from anthropic import AnthropicVertex

project_id = "MY_PROJECT_ID"
region = "global"

client = AnthropicVertex(project_id=project_id, region=region)

message = client.messages.create(
    model="claude-opus-4-6",
    max_tokens=100,
    messages=[
        {
            "role": "user",
            "content": "안녕하세요!",
        }
    ],
)
print(message.content[0].text)

TypeScript

import { AnthropicVertex } from "@anthropic-ai/vertex-sdk";

const projectId = "MY_PROJECT_ID";
const region = "global";

const client = new AnthropicVertex({
    projectId,
    region
});

const result = await client.messages.create({
    model: "claude-opus-4-6",
    max_tokens: 100,
    messages: [
        { role: "user", content: "안녕하세요!" }
    ]
});
console.log(result.content[0].text);

글로벌 vs 리전 엔드포인트

Bedrock과 마찬가지로 두 가지 엔드포인트를 제공한다.

글로벌 엔드포인트 (권장)

client = AnthropicVertex(project_id="MY_PROJECT_ID", region="global")

리전 엔드포인트

client = AnthropicVertex(project_id="MY_PROJECT_ID", region="us-east1")

리전 엔드포인트는 10% 추가 비용이 발생한다.

Claude Code와 함께 사용

export CLAUDE_CODE_USE_VERTEX=1
export CLOUD_ML_REGION=global
export ANTHROPIC_VERTEX_PROJECT_ID=YOUR-PROJECT-ID

장점

단점

적합한 경우

Microsoft Foundry

개요

Microsoft Foundry는 Azure 환경에서 Claude를 사용할 수 있게 해준다. Azure는 Claude와 GPT 모델을 모두 제공하는 유일한 클라우드 플랫폼이다.

사전 요구사항

사용 가능한 모델

특징

서버리스 배포

Claude는 Microsoft Foundry에서 서버리스로 배포된다. Anthropic이 인프라를 관리하고, 사용량에 따라 자동 확장된다.

Azure 통합

주의사항

구독 제한

Enterprise 또는 MCA-E 구독만 Claude 모델을 사용할 수 있다. 일반 Azure 구독에서는 사용할 수 없다.

스타트업 크레딧

Azure 스타트업 크레딧은 Claude 모델에 적용되지 않을 수 있다. 사전에 확인이 필요하다.

장점

단점

적합한 경우

접근 방법 선택 가이드

상황별 추천

개인 학습 및 테스트

claude.ai 웹 인터페이스를 추천한다. 무료로 시작할 수 있고 설치가 필요 없다.

개인 개발자

API 직접 호출을 추천한다. 최신 기능을 사용할 수 있고 비용도 사용한 만큼만 지불한다.

AWS 사용 기업

AWS Bedrock을 추천한다. 기존 AWS 인프라와 통합하고 IAM으로 접근 제어를 할 수 있다.

GCP 사용 기업

Google Vertex AI를 추천한다. GCP 서비스와 통합하고 글로벌 엔드포인트로 높은 가용성을 확보할 수 있다.

Azure 사용 기업 (Enterprise)

Microsoft Foundry를 추천한다. Azure 환경에서 Claude와 GPT를 함께 사용할 수 있다.

의사결정 플로우

  1. 코딩 없이 사용하고 싶다면 → claude.ai
  2. 코딩이 가능하고
    • 클라우드 플랫폼을 사용하지 않는다면 → API 직접 호출
    • AWS를 사용한다면 → Bedrock
    • GCP를 사용한다면 → Vertex AI
    • Azure Enterprise를 사용한다면 → Microsoft Foundry

정리

핵심 요점

  1. 다섯 가지 접근 방법: claude.ai, API, Bedrock, Vertex AI, Microsoft Foundry

  2. claude.ai: 가장 간단, 코딩 불필요, 일반 사용자에 적합

  3. API 직접 호출: 최신 기능, 개발자에 적합, 가장 유연

  4. 클라우드 플랫폼: 기존 인프라 통합, 기업 환경에 적합

확인해볼 링크

다음 단계

다음 섹션부터는 본격적으로 Claude Code를 설치하고 사용하는 방법을 학습한다. 에이전틱 코딩의 세계로 들어가 보자.

참고 자료

Previous Post
Claude Code란 무엇인가
Next Post
학생을 위한 Claude 무료 사용 방법