Claude Code 구독을 REST API로 바꿔버렸다

요즘 AI 코딩 어시스턴트 없이는 개발이 안 될 것 같다. 그중에서도 나는 Claude Code를 메인으로 쓰고 있는데, 쓰면 쓸수록 "이걸 어디서든 쓸 수 있으면 좋겠다"는 생각이 자꾸 들었다.

문제는 돈이었다

Anthropic 공식 API는 토큰당 과금이다. 조금만 써도 금방 비용이 쌓인다. 근데 나는 이미 Claude Code Max 구독을 쓰고 있었다. 구독료는 내고 있는데, 모바일이나 다른 서비스에서 Claude를 쓰려면 또 API 비용을 내야 한다는 게 뭔가 이상하게 느껴졌다.

"구독은 이미 했으니까, CLI만 어떻게 감싸면 API처럼 쓸 수 있지 않을까?"

이게 claude-api-bridge의 시작이었다.

어떻게 만들었나

핵심 아이디어는 단순하다. Claude Code CLI를 서버에서 자식 프로세스로 실행하고, 그 결과를 REST API로 내보내는 것.

외부 앱 → HTTPS → Cloudflare Tunnel → 내 맥 → Claude CLI

처음에는 그냥 express 서버 하나에 child_process.spawn으로 claude CLI 실행하면 되겠지 했는데, 생각보다 신경 쓸 게 많았다.

요청 큐 문제: Claude CLI는 한 번에 하나씩만 처리된다. 동시에 여러 요청이 들어오면 순서대로 처리해야 했다. FIFO 큐를 직접 구현했고, 서버가 죽었다가 살아나도 처리 중이던 요청을 자동으로 재시도하도록 했다.

외부 접근 문제: 내 맥에서 돌아가는 서버를 외부에서 어떻게 접근하게 할까? 포트 포워딩? DDNS? 이것저것 고민하다가 Cloudflare Tunnel을 선택했다. 설정 없이 자동으로 HTTPS URL이 생긴다. 심지어 cloudflared 바이너리도 없으면 자동으로 다운로드해서 쓴다.

인증 문제: 외부에 열려있는 서버니까 토큰 인증은 필수. SHA256 해시로만 저장해서 DB가 털려도 실제 토큰은 안전하게. 어드민 토큰과 일반 토큰을 나눠서 토큰 관리 권한도 분리했다.

데이터베이스는 SQLite. 외부 DB 없이 ~/.claude-api-bridge/bridge.db 하나로 모든 게 해결된다.

결국 한 줄이 됐다

npx claude-api-bridge start

이걸 실행하면:

1. Claude CLI가 설치돼 있는지 확인
2. 어드민 토큰 자동 생성
3. Express 서버 실행
4. Cloudflare Tunnel 연결 → HTTPS URL 발급

도메인도 없고, 포트 포워딩도 없고, 복잡한 설정도 없다. URL 하나 받아서 바로 쓰면 된다.

오픈소스로 공개한 이유

나만 쓰기엔 아깝다는 생각이 들었다. Claude Code 구독자라면 누구나 같은 답답함을 느낄 수 있을 것 같았고, 내가 만든 게 누군가에게 도움이 될 수 있다면 더 좋겠다 싶었다.

GitHub에서 바로 써볼 수 있다: github.com/smy383/claude-api-bridge

Claude Code 구독 있고, 다른 서비스에서도 Claude를 쓰고 싶다면 한번 시도해봐도 좋을 것 같다.