OpenClaude: Claude Code UI로 200개 이상 모델을 쓰는 오픈소스 대안

2026년 3월 31일, Anthropic의 Claude Code 소스 코드가 npm 소스맵을 통해 노출되는 사건이 발생했다. 이 사건을 계기로 탄생한 OpenClaude는 Claude Code의 터미널 기반 AI 코딩 환경을 OpenAI 호환 API 심(shim)을 통해 200개 이상의 모델에서 쓸 수 있게 만든 오픈소스 프로젝트다.

탄생 배경

Gitlawb이라는 개발자가 노출된 소스 코드를 기반으로 OpenAI 호환 API 심을 추가해, Anthropic의 Claude뿐 아니라 GPT-4o, Gemini, DeepSeek, Llama, Mistral 등 다양한 모델을 Claude Code의 UI에서 사용할 수 있도록 구현했다.

핵심 변경 사항은 6개 파일에 걸쳐 786줄의 코드가 추가된 것이며, 외부 의존성은 단 하나도 추가되지 않았다. 가장 중요한 파일은 724줄 규모의 src/services/api/openaiShim.ts로, OpenAI 호환 API 요청을 처리하는 심 계층이다.

구조: 기존 도구 체계 + API 심

OpenClaude는 기존 Claude Code의 도구 체계를 그대로 유지하면서, API 통신 계층에 OpenAI 호환 심을 삽입하는 구조를 택했다.

⤢✕

API 라우팅의 핵심은 client.ts에서 환경 변수 OPENCLAUDE_PROVIDER가 설정되어 있으면 OpenAI 호환 심으로 요청을 전달하고, 그렇지 않으면 기존 Anthropic 네이티브 API를 사용하는 분기 처리에 있다.

도구 호환성

OpenClaude의 가장 큰 강점은 Claude Code의 모든 내장 도구를 어떤 모델에서든 동일하게 쓸 수 있다는 점이다.

기능	Claude Code	OpenClaude	비고
Bash 실행	O	O	터미널 명령 실행
파일 읽기/쓰기/편집	O	O	코드베이스 직접 조작
Grep/Glob 검색	O	O	패턴 기반 검색
에이전트/태스크	O	O	하위 에이전트 위임
MCP 서버 연동	O	O	외부 도구 통합
Anthropic 전용 모델	O	X	Claude 모델만 지원
OpenAI 호환 모델	X	O	200개 이상 모델 지원
Ollama 로컬 모델	X	O	인터넷 없이 사용 가능
Apple Silicon 로컬 추론	X	O	Atomic Chat 연동

설치와 설정

OpenClaude는 npm 패키지로 배포되며, 설치 후 환경 변수 설정만으로 바로 쓸 수 있다.

# 글로벌 설치
npm install -g @gitlawb/openclaude

# 환경 변수 설정 (OpenAI 예시)
export OPENCLAUDE_PROVIDER=openai
export OPENAI_API_KEY=sk-your-key

# Ollama 로컬 모델 사용 시
export OPENCLAUDE_PROVIDER=ollama
export OPENCLAUDE_MODEL=llama3.1:70b

# 실행
openclaude

설치된 CLI 명령은 openclaude이며, 기존 Claude Code와 동일한 터미널 인터페이스를 제공한다.

다른 대체재와 비교

2026년 현재 Claude Code의 오픈소스 대체재는 여러 프로젝트가 경쟁하고 있다.

프로젝트	GitHub Stars	지원 모델 수	UI 방식	핵심 차별점
OpenClaude	빠르게 증가 중	200+	터미널 (Claude Code UI)	Claude Code 완전 호환
OpenCode	112K+	75+	터미널	독자 설계, 높은 안정성
Cline	높음	다수	VS Code 확장	IDE 통합
Aider	높음	다수	터미널	Git 통합 특화

OpenClaude의 핵심 차별화 요소는 Claude Code의 UI와 도구 체계를 그대로 유지한다는 점이다. OpenCode가 독자적으로 설계된 터미널 AI 코딩 도구인 반면, OpenClaude는 Claude Code의 검증된 워크플로를 다른 모델에서도 쓸 수 있게 해준다.

법적, 윤리적 리스크

OpenClaude는 소스 코드 유출을 기반으로 탄생했기 때문에 법적 리스크가 존재한다. Anthropic의 서비스 약관(ToS)은 리버스 엔지니어링을 명시적으로 금지하고 있으며, 소스맵을 통한 코드 복구가 이에 해당하는지에 대한 법적 해석은 아직 확정되지 않았다. 프로덕션 환경에서 도입할 때는 이 리스크를 충분히 인지하고 판단해야 한다.

786줄의 코드 추가와 제로 의존성이라는 최소한의 변경으로 최대한의 모델 호환성을 달성한 것이 OpenClaude의 기술적 핵심이다. 다만 소스 코드 유출 기반이라는 태생적 한계와 법적 리스크가 남아 있으므로, 실무 도입 시에는 이 두 가지를 함께 저울질해야 한다.