OpenClaude: GPT와 Ollama를 위한 무료 CLI 에이전트

OpenClaude: Claude Code CLI 에이전트의 오픈 포크, 모든 LLM 지원

2026년 3월 31일 — Anthropic의 Claude Code CLI 에이전트 소스 코드가 npm 패키지의 소스 맵에서 유출되었습니다. 몇 시간 만에 GitHub에 OpenClaude가 등장했습니다 — OpenAI 호환 프로바이더를 갖춘 포크입니다. 이를 통해 Claude Code 도구 스택(bash, 파일 작업, grep, MCP, 에이전트)을 GPT-4o, DeepSeek, Gemini, Ollama를 통한 Llama와 같은 모델과 함께 사용할 수 있습니다.

OpenClaude는 원래 아키텍처를 유지합니다: 난독화된 Node.js/TypeScript 코드가 소스 맵에서 재구성되었습니다. Anthropic API 호출을 OpenAI Chat Completions로 리디렉션하는 심 프로바이더가 추가되었습니다. Claude 모델 자체는 유출되지 않았습니다 — 외부 LLM이 사용됩니다.

아키텍처 및 주요 구성 요소

시스템은 ReAct 패턴을 기반으로 구축되었습니다: 에이전트가 작업을 분석하고, 도구를 선택하며, 작업을 실행하고, 결과를 처리하며, 사이클을 반복합니다.

핵심 도구

• Bash: 셸 명령어 실행
• FileRead/FileWrite/FileEdit: 파일 읽기, 쓰기, 편집
• Grep/Glob: 패턴 및 파일 검색
• WebFetch/WebSearch: 인터넷 접근
• Agent: 하위 작업을 위한 하위 에이전트
• MCP (Model Context Protocol): 외부 서버 연결
• Tasks: 다단계 작업 계획
• LSP (Language Server Protocol): 코드 탐색

모델 프로바이더는 환경 변수를 통해 구성됩니다. 구성 예시:

# GPT-4o
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=sk-your-key
export OPENAI_MODEL=gpt-4o

# DeepSeek
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=sk-your-key
export OPENAI_BASE_URL=https://api.deepseek.com/v1
export OPENAI_MODEL=deepseek-chat

# Ollama 로컬
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_BASE_URL=http://localhost:11434/v1
export OPENAI_MODEL=llama3.3:70b

# OpenRouter
export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=sk-or-your-key
export OPENAI_BASE_URL=https://openrouter.ai/api/v1
export OPENAI_MODEL=google/gemini-2.5-pro

세션 컨텍스트는 마크다운 파일에 저장되어 실행 간 메모리를 보장합니다.

설치 및 실행

Bun이 필요합니다(Node.js도 가능하지만 느림):

git clone https://github.com/Gitlawb/openclaude.git
cd openclaude
bun install
bun run build

빠른 시작을 위한 프로필:

# 프로바이더 자동 감지
bun run profile:init

# Ollama
bun run profile:init -- --provider ollama --model llama3.1:8b

# OpenAI
bun run profile:init -- --provider openai --api-key sk-...

# 실행
bun run dev:profile

Ollama의 경우: ollama pull llama3.3:70b를 실행하고 서버를 시작하세요.

모델 테스트 결과

| 모델 | 도구 호출 | 속도 | 에이전트 품질 | 참고 사항 |

|--------|--------------|----------|-----------------|------------|

| GPT-4o | 네이티브 | 높음 | 높음 | 원본에 가까움 |

| DeepSeek Chat | 중간 | 높음 | 중간 | 체인에서 중단됨 |

| Llama 3.3 70B (Ollama) | 지원됨 | 낮음 | 평균 이하 | 단순 작업용 |

| 7-8B 모델 | 약함 | 중간 | 낮음 | 에이전트에 부적합 |

원래 슬래시 명령어가 유지됩니다:

• /commit — 커밋 메시지 생성
• /review — 코드 리뷰
• /compact — 컨텍스트 압축
• /diff — 변경 사항 보기
• /doctor — 프로젝트 진단

컴퓨터 비전을 위한 MCP 서버 및 비전 모델 지원.

법적 측면 및 대안

Claude Code 소스 코드는 Anthropic의 소유입니다. 포크는 교육용 프로젝트로 포지셔닝됩니다. OpenAI 심은 퍼블릭 도메인입니다. Anthropic의 이용약관 위반 위험은 남아 있습니다.

법적 대안:

• claude-code-proxy: 코드 유출 없이 Anthropic API를 OpenAI로 변환
• Aider: 네이티브 LLM 지원 오픈 소스 에이전트
• Continue.dev: 모든 모델용 IDE 플러그인
• OpenClaw: 메신저 에이전트

핵심 요약

• OpenClaude는 Claude Code의 내부 아키텍처를 드러냅니다: ReAct 사이클, 도구, 컨텍스트 관리
• GPT-4o로 최상의 결과; 로컬 모델(Llama 70B)은 단순 작업에 적합
• Bun을 통한 설치, OPENAI_* 변수를 통한 구성
• 슬래시 명령어와 MCP를 유지하지만 법적 위험 존재
• 대안: 법적 문제 없는 Aider, Continue.dev

— Editorial Team