Claude Max 구독을 OpenAI API처럼 사용하는 방법

좋은 모델을 쓰고 싶지만 API 비용이 부담될 때가 많아요. 이미 유료 구독 서비스를 이용하고 있는데도 정작 개발 도구에서는 별도의 API 키와 사용량에 따른 비용을 요구해서 이중으로 지출하게 되는 상황, 개발자라면 누구나 한 번쯤 겪어보셨을 거예요.

claude-max-api-proxy는 Claude Max 또는 Pro 구독을 OpenAI 호환 API 엔드포인트로 바꿔주는 커뮤니티 도구예요. 이 프록시를 사용하면 평소 사용하던 개발 도구에서 구독 모델을 그대로 활용할 수 있습니다.

필요한 것

시작하기 전에 다음 항목이 준비되었는지 확인해 주세요.

• Node.js 20 버전 이상
• Claude Code CLI (로그인 및 인증 완료 상태)
• Claude Max 또는 Pro 구독 계정

빠른 시작

5분 안에 프록시 서버를 설정하고 테스트하는 방법입니다.

1. 설치 및 인증 확인

먼저 npm을 통해 패키지를 설치하고 Claude CLI가 잘 인증되어 있는지 확인합니다.

# 패키지 설치
npm install -g claude-max-api-proxy

# Claude CLI 인증 상태 확인
claude --version

2. 서버 실행

다음 명령어를 입력하면 로컬 서버가 시작됩니다.

claude-max-api
# 서버는 기본적으로 http://localhost:3456 에서 실행됩니다.

3. API 테스트

서버가 정상적으로 작동하는지 curl 명령어로 확인해 보세요.

# 헬스체크
curl http://localhost:3456/health

# 모델 목록 확인
curl http://localhost:3456/v1/models

# 채팅 답변 테스트
curl http://localhost:3456/v1/chat/completions \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-opus-4",
    "messages": [{"role": "user", "content": "Hello!"}]
  }'

Available Models

프록시에서 사용할 수 있는 모델 ID와 매핑 정보입니다.

Model ID	Maps To
claude-opus-4	Claude Opus 4
claude-sonnet-4	Claude Sonnet 4
claude-haiku-4	Claude Haiku 4
claude-3-5-sonnet	Claude 3.5 Sonnet

OpenClaw와 함께 사용하기

OpenClaw 설정에서 커스텀 OpenAI 엔드포인트로 프록시를 지정할 수 있습니다.

{
  env: {
    OPENAI_API_KEY: "not-needed",
    OPENAI_BASE_URL: "http://localhost:3456/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-opus-4" },
    },
  },
}

macOS 자동 실행 설정

컴퓨터를 켤 때마다 프록시가 자동으로 실행되도록 LaunchAgent를 설정할 수 있습니다.

cat > ~/Library/LaunchAgents/com.claude-max-api.plist << 'EOF'
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
  <key>Label</key>
  <string>com.claude-max-api</string>
  <key>RunAtLoad</key>
  <true/>
  <key>KeepAlive</key>
  <true/>
  <key>ProgramArguments</key>
  <array>
    <string>/usr/local/bin/node</string>
    <string>/usr/local/lib/node_modules/claude-max-api-proxy/dist/server/standalone.js</string>
  </array>
  <key>EnvironmentVariables</key>
  <dict>
    <key>PATH</key>
    <string>/usr/local/bin:/opt/homebrew/bin:~/.local/bin:/usr/bin:/bin</string>
  </dict>
</dict>
</plist>
EOF

launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.claude-max-api.plist

문제 해결

문제가 발생하면 다음 사항을 점검해 보세요.

• Claude CLI 인증: 프록시는 Claude CLI를 통해 작동하므로, CLI에서 로그인이 되어 있어야 합니다.
• Node.js 버전: 반드시 Node.js 20 이상의 버전이 필요합니다.
• 로컬 실행: 이 프록시는 로컬에서만 실행되며 외부 서버로 데이터를 보내지 않습니다.
• 스트리밍 지원: 답변이 끊겨서 나온다면 스트리밍 기능이 활성화되어 있는지 확인하세요. (기본 지원)

설정 과정에서 도움이 필요하신가요? AI Setup Assistant에게 물어보세요!

다음 단계

• Anthropic provider: API 키를 직접 사용하는 네이티브 연동 방법
• OpenAI provider: OpenAI 및 Codex 구독자를 위한 가이드