Claude Code 서드파티 공급업체 사용 가이드 - 심층 분석 및 최적 활용법

Claude Code 서드파티 공급업체 사용 가이드

서론

본 문서는 오랜 기간 동안 Claude Code를 사용해온 제 경험을 바탕으로, 서드파티 공급업체를 효율적으로 구성하는 방법과 흔히 발생하는 구성 함정을 피하는 실용적인 팁을 공유합니다. 공식 정보만을 전달하는 매체와는 달리, 여기에 소개된 내용은 실제로 검증된 실용적인 기술들입니다.

환경 변수 구성

기본 구성(대부분의 튜토리얼에서 언급됨)

ANTHROPIC_BASE_URL=귀하의 공급업체 API 주소
ANTHROPIC_AUTH_TOKEN=귀하의 인증 토큰
ANTHROPIC_MODEL=기본 모델 이름

ANTHROPIC_SMALL_FAST_MODEL은 이미 폐기되었으며, 대신 ANTHROPIC_DEFAULT_HAIKU_MODEL을 사용합니다.

고급 구성(덜 알려진 정보)

Claude Code는 현재 다양한 작업에 대해 서로 다른 모델을 선택할 수 있도록 지원합니다:

# 각 시리즈별로 모델을 별도로 구성
ANTHROPIC_DEFAULT_OPUS_MODEL=opus 시리즈 모델
ANTHROPIC_DEFAULT_SONNET_MODEL=sonnet 시리즈 모델
ANTHROPIC_DEFAULT_HAIKU_MODEL=haiku 시리즈 모델

# 서브 에이전트에서 사용하는 모델
CLAUDE_CODE_SUBAGENT_MODEL=서브 에이전트 모델
# 타임아웃 시간 설정
BASH_DEFAULT_TIMEOUT_MS=10000
# 불필요한 트래픽 차단
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
# 비용 경고 차단, 그렇지 않으면 Claude sonnet 기준으로 5달러마다 경고가 발생합니다
DISABLE_COST_WARNINGS=1
# 불필요한 모델 호출 차단
DISABLE_NON_ESSENTIAL_MODEL_CALLS=1
# 원격 측정 차단
DISABLE_TELEMETRY=1

자세한 구성 정보는 다음을 참조하세요: https://docs.claude.com/en/docs/claude-code/settings#environment-variables

Plan 모드 활용 팁

Claude Code의 Plan 모드는 AI가 파일을 직접 수정하기 전에 더 깊이 고민하도록 유도하는 매우 유용한 기능입니다. 이 모드는 특히 DeepSeek의 Reasoner 모델과 함께 사용할 때 효과적입니다. Plan 모드에서는 다음을 수행할 수 있습니다:

• 불필요한 파일 수정을 줄일 수 있습니다
• 보다 상세한 사고 과정을 제공합니다
• 복잡한 코드 검토 및 설계 결정에 적합합니다

서드파티 공급업체 빠른 전환

Claude Code Router 도구를 사용하여 서드파티 모델 공급업체를 Claude Code에 연결하려는 시도가 있었고, 환경 변수 전환기까지 개발된 사례가 있었습니다. 저는 이러한 추가 작업을 권장하지 않습니다. 정말로 필요로 하는 것은 VS Code settings를 열고 terminal.integrated.env를 검색하여 앞의 세 개 구성 항목을 설정하는 것입니다.

다음과 같이 구성합니다:

그 후 VS Code 내에서 새 터미널을 열 때마다 새로운 환경 변수가 적용됩니다. 추가적인 서드파티 도구를 사용할 필요 없이, 현재 사용 중인 VS Code만 적절히 구성하면 됩니다.

API 변환 도구 사용을 권장하지 않는 이유

많은 사용자들이 Claude Code를 편리하게 사용하기 위해 Claude Code Router나 변환 스크립트를 작성하는 방법을 시도하지만, 이러한 방법은 종종 VS Code와 API 인터페이스에 대한 이해 부족에서 비롯됩니다.

권장 사항: 변환 스크립트를 직접 작성하기보다는, 공식적으로 Anthropic API를 지원하는 공급업체를 선택하는 것이 좋습니다. 그 이유는 다음과 같습니다:

• Anthropic API 변환이 복잡하고 완벽한 적합을 달성하기 어렵습니다
• 공식 지원을 제공하는 공급업체가 보다 안정적인 서비스를 제공합니다
• 호환성 문제와 불필요한 디버깅 시간을 피할 수 있습니다

일반 API를 Anthropic API로 변환하는 것은 큰 차이가 있으며, 이는 DeepSeek 공식 변환 Anthropic API 호환성 표에서 확인할 수 있습니다: DeepSeek-anthropic_api#anthropic-api-호환성-세부사항

공식 변환조차도 이처럼 많은 비호환성을 가지고 있는데, 개인 변환이라면 더 말할 필요도 없습니다. 이러한 일에 시간을 낭비하지 않는 것이 좋습니다.

국내 Claude Code 지원 서드파티 공급업체

현재 국내에서 제가 알고 있는 Anthropic API를 원생으로 지원하는 공급업체는 다음과 같습니다:

• DeepSeek - 종합적으로 뛰어난 성능
• Z-AI - 우수한 API 지원 제공
• Moonshot - 파라미터 규모가 큼
• ModelScope - GLM-4.5만 원활하게 사용 가능

이들 모두 Claude Code를 완벽하게 지원하지는 않으며, 다양한 문제가 존재합니다. 예를 들어 DeepSeek는 subagent를 지원하지 않고, 네 공급업체 모두 이미지와 문서를 지원하지 않습니다. 완전한 Claude Code의 힘을 경험하고 싶다면, 20달러짜리 Pro가 아닌 최소 100달러짜리 Max가 입문门槛이며, 그 이유는 Pro는 Opus 모델을 사용할 수 없기 때문입니다.

DeepSeek

"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-reasoner",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-chat",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-chat",
"CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-reasoner",

Z-AI

"ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "glm-4.5",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "glm-4.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "glm-4.5-air",
"CLAUDE_CODE_SUBAGENT_MODEL": "glm-4.5",

Moonshot

"ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_MODEL": "kimi-k2-turbo-preview",

ModelScope

"ANTHROPIC_BASE_URL": "https://api-inference.modelscope.cn",
"ANTHROPIC_AUTH_TOKEN": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
"ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-ai/DeepSeek-R1-0528",
"ANTHROPIC_DEFAULT_SONNET_MODEL": "ZhipuAI/GLM-4.5",
"ANTHROPIC_DEFAULT_HAIKU_MODEL": "Qwen/Qwen3-Coder-480B-A35B-Instruct",
"CLAUDE_CODE_SUBAGENT_MODEL": "ZhipuAI/GLM-4.5",

결론

AI 관련 문서를 게시할 때마다 댓글에 광고가 붙는 경우가 종종 있습니다. 여기서는 절대 중계 API를 사용하지 말 것을 강력히 권고합니다. 엄청난 보안 위험이 존재합니다.

구체적인 보안 문제는 다음을 참조하세요: 모델 라우터 보안 위험 분석

• ←이전
• 다음→