Claude Code 는 그대로, 모델만 바꾸기

핵심 아이디어

하네스 엔지니어링 에서 설명한 것처럼, Claude Code 는 runtime harness 입니다. 모델은 교체 가능한 부품이에요. ANTHROPIC_BASE_URL 과 ANTHROPIC_MODEL 환경변수 두 개면 Claude Code 가 바라보는 백엔드를 통째로 바꿀 수 있습니다.

즉, 터미널 두 개를 띄워서 하나는 Opus, 하나는 GPT 로 돌리는 것도 됩니다. Claude Code 의 설정·CLAUDE.md·Hooks·Skills 는 전부 그대로 유지되고, 뒤에서 돌아가는 모델만 다른 거예요.

vibeProxy — 3분이면 끝나는 가장 쉬운 방법

vibeProxy 는 macOS 메뉴바 앱입니다. 이미 가지고 있는 ChatGPT Pro / Claude Max 구독을 다른 AI 툴에서 재활용할 수 있게 해줘요. API 키 없이 OAuth 로그인만 하면 됩니다.

세팅 (3분)

1. vibeProxy 설치 — /Applications 에 앱 넣기
2. 앱 실행 → OpenAI (또는 다른 서비스) 구독 로그인
3. 터미널에서:

ANTHROPIC_BASE_URL=http://localhost:8318 \
ANTHROPIC_MODEL=gpt-5.4 claude

이게 전부. 하네스 기능(Hooks, subagent 위임, CLAUDE.md 규칙)은 그대로 동작합니다. 단, Claude Code 는 모델 ID 서브스트링 매칭으로 기능을 감지하기 때문에 GPT 모델 ID 를 쓰면 extended thinking, 64K 출력 등 Claude 전용 기능은 비활성화됩니다.

더 세밀하게 제어하고 싶다면

vibeProxy 는 "구독 재활용 + GUI" 에 초점이 맞춰져 있어서, 역할별 라우팅(복잡한 건 Opus, 단순한 건 DeepSeek) 같은 건 안 돼요. 그런 게 필요하면:

OpenRouter 로 모델을 바꾸는 가장 단순한 예시:

export OPENROUTER_API_KEY="sk-or-v1-xxxxxxxxxxxx"
export ANTHROPIC_BASE_URL="https://openrouter.ai/api"
export ANTHROPIC_AUTH_TOKEN="$OPENROUTER_API_KEY"
export ANTHROPIC_API_KEY=""   # 반드시 비워야 함

claude

주의할 점

• Claude Code 는 Anthropic 모델에 가장 최적화돼 있어요. 다른 모델로 바꾸면 extended thinking · native tool use 포맷이 다르게 동작할 수 있습니다.
• 중요한 프로덕션 작업엔 Anthropic 직접 접속 유지를 권장합니다. "모델 교체" 는 개인 프로젝트·학습·실험·비용 민감한 작업에 쓰는 게 현실적이에요.
• 무료 모델 중 다수는 tool calling 미지원. Claude Code 가 오류 없이 "답변만 하고 파일은 안 건드리는" 상태가 되면 이걸 의심하세요.

다음에 읽을 글

• 하네스 엔지니어링이란? — "모델은 교체 가능, 하네스가 본체" 라는 관점의 원론
• Compact 활용법과 CLAUDE.md 메모리 전략 — 모델을 바꾸기 전에 먼저 해볼 수 있는 컨텍스트 비용 최적화

참고 자료

• automazeio/vibeproxy — vibeProxy 공식 레포 (MIT)
• musistudio/claude-code-router — 역할별 라우팅 프록시
• OpenRouter — Claude Code Integration — 환경변수 패턴 공식 출처
• BerriAI/litellm — 팀용 범용 프록시