저비용 AI 백엔드 연동

이 별첨에서는 Claude Code와 호환되는 저비용 AI 백엔드 — DeepSeek, GLM/ZhipuAI, LiteLLM —의 설정 방법을 설명합니다.

왜 저비용 백엔드인가

Claude Code는 Anthropic의 Claude 모델을 기본으로 사용합니다. Claude Pro 구독은 월 $20이며, 정액제로 매월 일정 횟수의 질문을 할 수 있습니다. 하지만 프로젝트를 많이 진행하거나 대량의 코드 생성이 필요한 경우, 비용이 부담될 수 있습니다.

API 기반 저비용 백엔드를 사용하면 사용량만큼만 과금되므로, 적게 사용하면 Claude Pro보다 훨씬 저렴합니다. 특히 Claude Code CLI는 환경 변수만 변경하면 다른 AI 백엔드로 쉽게 전환할 수 있는 유연성을 제공합니다.

저비용 백엔드가 적합한 경우

• 대량 작업(배치 처리) — 수십 개의 에이전트 작업을 연달아 실행할 때(예: 핸드북의 여러 장 생성) 종량 과금이 정액제 구독보다 훨씬 저렴합니다.
• 실험과 프로토타이핑 — 새로운 하네스를 프로토타이핑하거나 에이전트 설정을 테스트할 때는 시행착오 과정에서 많은 토큰을 소모할 수 있습니다. 저비용 백엔드는 실험 비용을 줄여줍니다.
• 팀 또는 교실 사용 — 여러 사람이 하나의 작업 공간을 공유할 때, Claude Pro 좌석 하나를 나눠 쓰는 대신 각자 자신의 저비용 API 키를 사용할 수 있습니다.
• 비용 통제 — 종량제에서는 지출 한도를 엄격하게 설정할 수 있습니다. 에이전트 루프가 무한히 돌아도 API 키 잔액을 초과해 청구되지 않습니다.

DeepSeek 백엔드

DeepSeek이란?

DeepSeek은 중국의 저비용 고성능 AI 플랫폼입니다. DeepSeek-V3와 같은 최신 모델은 코드 생성, 수학 추론, 다국어 이해 등 다양한 분야에서 뛰어난 성능을 보여줍니다. Claude와 호환되는 API를 제공하므로 Claude Code에서 환경 변수만 변경하면 바로 사용할 수 있습니다.

주요 특징

• Claude 호환 API — Anthropic API 형식을 그대로 지원하므로 Claude Code와 원활하게 연동
• 저렴한 가격 — Claude Pro 월 $20보다 적은 사용량에서 훨씬 저렴
• 극저비 요금 — DeepSeek-V3 기준 100만 입력 토큰당 약 $0.27, 100만 출력 토큰당 약 $1.10
• 강력한 코드 생성 — 프로그래밍 언어 이해와 코드 작성 능력이 우수
• 오픈 소스 모델 — DeepSeek-V3/R1 계열 등 오픈 소스 모델도 제공

설정 방법

1단계: DeepSeek API 키 발급

https://platform.deepseek.com 에 접속하여 계정을 생성하고 API 키를 발급받습니다. 무료 크레딧 제공 여부는 플랫폼 정책에 따라 달라질 수 있습니다.

2단계: 환경 변수 설정

macOS / Linux의 경우:

export ANTHROPIC_API_KEY="your-deepseek-api-key"
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

Windows (PowerShell)의 경우:

$env:ANTHROPIC_API_KEY="your-deepseek-api-key"
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

3단계: Claude Code 실행

환경 변수를 설정한 후, Claude Code를 일반적으로 실행합니다:

claude

GLM/ZhipuAI 백엔드

GLM/ZhipuAI이란?

ZhipuAI는 중국의 AI 연구 기업으로, GLM(General Language Model) 시리즈를 개발하고 있습니다. GLM-4는 최신 모델로 다국어 처리 능력이 뛰어나며, 특히 한국어 처리 능력이 우수하여 한국어 프로젝트에 적합합니다. DeepSeek과 마찬가지로 Claude 호환 API를 제공합니다. ZhipuAI는 글로벌 영어 개발자 플랫폼인 Z.ai도 함께 운영합니다.

주요 특징

• Claude 호환 API — Anthropic API 형식을 지원하여 Claude Code와 직접 연동
• 다국어 지원 — 한국어, 일본어, 중국어 등 아시아 언어 처리 능력이 우수
• 한국어 최적화 — 한국어 명령어와 응답에 높은 품질을 제공
• 종량제 과금 — 사용량에 따른 비용 산정으로 비용 효율적
• 무료 티어 제공 — GLM-4-Flash는 무료 티어가 있으며, 유료 기준으로도 100만 입력 토큰당 약 $0.10 수준의 경쟁력 있는 가격

설정 방법

1단계: ZhipuAI API 키 발급

https://z.ai/model-api (Z.ai, ZhipuAI의 글로벌 영어 개발자 플랫폼) 에 접속하여 계정을 생성하고 API 키를 발급받습니다.

2단계: 환경 변수 설정

macOS / Linux의 경우:

export ANTHROPIC_AUTH_TOKEN="your-zai-api-key"
export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"

Windows (PowerShell)의 경우:

$env:ANTHROPIC_AUTH_TOKEN="your-zai-api-key"
$env:ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"

3단계: Claude Code 실행

환경 변수 설정 후 Claude Code를 실행합니다. DeepSeek과 동일한 방식입니다:

claude

요금제: 종량제 API와 정액제 GLM Coding Plan

GLM 백엔드는 두 가지 방식으로 사용할 수 있습니다. 위에서 설정한 종량제 API는 토큰 사용량만큼 과금되며, z.ai/model-api 에서 발급한 API 키를 사용합니다. 반면 GLM Coding Plan은 Claude Code, Cline, OpenCode와 호환되는 월 정액제 구독으로, 크레딧이 5시간 단위와 주 단위로 초기화됩니다.

크레딧은 토큰 기반이며 모델별 배율이 적용되고, 5시간마다 그리고 매주 초기화됩니다. 모든 플랜에는 GLM-5.3, GLM-5-Turbo, GLM-4.7 모델과 Vision, Web Search, Web Reader, Zread MCP 서버가 포함됩니다. 최신 가격은 구독 페이지에서 확인하세요. 피크 시간대(월-금 14:00-18:00, UTC+8) 외 사용 시 50% 할인이 적용됩니다.

# macOS / Linux
export ANTHROPIC_AUTH_TOKEN="your-zai-api-key"
export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"

# Windows (PowerShell)
$env:ANTHROPIC_AUTH_TOKEN="your-zai-api-key"
$env:ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"

설정을 자동화하려면 npx @z_ai/coding-helper 를 실행하는 방법도 있습니다. 필요하면 ANTHROPIC_DEFAULT_SONNET_MODEL 같은 환경 변수로 기본 모델을 지정할 수 있습니다.

자세한 내용은 GLM Coding Plan 구독 페이지, 공식 요금제 문서, Claude Code 연동 가이드를 참조하세요.

모델 선택 가이드

LiteLLM 프록시

LiteLLM이란?

LiteLLM은 다중 AI 백엔드를 하나의 통합 API로 관리할 수 있는 오픈 소스 프록시입니다. 여러 AI 제공자(OpenAI, Anthropic, DeepSeek, ZhipuAI 등)의 API를 하나의 엔드포인트로 통합하며, 자동 장애 조치(failover) 기능도 제공합니다.

장점

• 다중 백엔드 통합 — 하나의 API 엔드포인트로 여러 AI 제공자 사용
• 자동 장애 조치 — 한 백엔드가 응답하지 않으면 자동으로 다른 백엔드로 전환
• 모델별 라우팅 — 요청마다 서로 다른 백엔드/모델로 라우팅 가능
• 부하 분산 — 여러 제공자에 걸쳐 요청을 자동으로 분산
• 비용 추적 — 요청별 토큰 사용량과 비용을 내장 로그로 기록
• 무료 오픈 소스 — LiteLLM 자체는 무료 (각 백엔드의 API 비용은 별도)

설치

Python 환경이 필요합니다. 다음 명령어로 설치합니다:

pip install litellm
# 또는 격리된 환경을 선호하는 경우
pipx install litellm

구성 파일 작성

프로젝트 디렉토리에 litellm_config.yaml 파일을 생성합니다:

model_list:
  - model_name: claude-sonnet
    litellm_params:
      model: deepseek/deepseek-chat
      api_key: os.environ/DEEPSEEK_API_KEY
  - model_name: claude-opus
    litellm_params:
      model: zhipu/glm-4
      api_key: os.environ/ZHIPU_API_KEY

프록시 시작

litellm --config litellm_config.yaml

프록시가 http://localhost:4000 에서 실행됩니다.

마지막으로 Claude Code가 이 프록시를 사용하도록 환경 변수를 설정하고 실행합니다:

export ANTHROPIC_API_KEY="any-key"
export ANTHROPIC_BASE_URL="http://localhost:4000"
claude

백엔드 비교

각 백엔드의 특징을 한눈에 비교해봅시다.

실습: 백엔드 전환

이 실습에서는 Claude Code의 백엔드를 Claude Pro에서 DeepSeek으로 전환하는 전체 과정을 단계별로 진행합니다. 환경 변수 설정만으로 백엔드를 전환할 수 있다는 것을 직접 확인해봅시다.

claude --version

export ANTHROPIC_API_KEY="sk-your-deepseek-key"
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

$env:ANTHROPIC_API_KEY="sk-your-deepseek-key"
$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"

claude

# macOS / Linux
export ANTHROPIC_AUTH_TOKEN="your-zai-api-key"
export ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"

# Windows (PowerShell)
$env:ANTHROPIC_AUTH_TOKEN="your-zai-api-key"
$env:ANTHROPIC_BASE_URL="https://api.z.ai/api/anthropic"