클라우드와 로컬 AI 모델을 하나의 터미널에서 자유롭게 오가는 코딩 에이전트
터미널에 명령어를 입력하면, 선택한 AI 모델이 코드를 읽고 수정하며 웹 검색까지 수행하는 장면을 상상해 보세요. OpenClaude는 OpenAI, Gemini, Ollama 등 다양한 AI 서비스와 로컬 모델을 하나의 인터페이스로 묶어 주는 오픈소스 CLI 도구입니다. 특정 클라우드에 종속되지 않고, 내 컴퓨터에 설치된 모델이나 여러 API를 상황에 따라 골라 쓸 수 있습니다.
하나의 터미널, 다양한 AI 엔진
OpenClaude는 OpenAI 호환 API, Gemini, GitHub Models, Codex, Ollama 등 다양한 백엔드를 지원합니다. /provider 명령어를 실행하면 안내에 따라 제공자를 설정하고 프로필을 저장할 수 있어, 복잡한 환경 변수 설정을 직접 하지 않아도 됩니다. 클라우드 API와 로컬 모델 서버를 모두 지원하므로, 인터넷 연결이 필요 없는 로컬 추론부터 최신 클라우드 모델까지 하나의 워크플로우 안에서 전환할 수 있습니다. 특히 Ollama를 사용할 때는 컨텍스트 윈도우를 자동으로 조정하여 대화 이력이 잘리지 않도록 처리합니다.
코딩 에이전트로서의 기능
이 도구는 단순한 채팅이 아니라 실제 코딩 작업을 수행하는 에이전트입니다. Bash 실행, 파일 읽기/쓰기/편집, grep, glob, 웹 검색, MCP(모델 컨텍스트 프로토콜) 등 다양한 도구를 호출하며 다단계 작업을 처리합니다. 스트리밍 출력을 통해 토큰 생성과 도구 실행 진행 상황을 실시간으로 확인할 수 있습니다. 또한 저장소의 구조를 PageRank 중요도로 매핑한 'Repo Map' 기능을 통해 코드베이스의 핵심 구조를 컨텍스트에 자동으로 주입할 수 있습니다. VS Code 확장 프로그램도 포함되어 있어 에디터와의 연동과 테마 지원을 제공합니다.
세션 관리와 배경 실행
긴 작업이 필요한 경우 --bg 옵션을 사용해 터미널에서 분리된 배경 세션으로 실행할 수 있습니다. openclaude ps로 실행 중인 세션을 확인하고, openclaude logs로 로그를 추적하며, openclaude kill로 세션을 종료할 수 있습니다. 기존 대화를 세션 ID로 복원하거나, --fork-session을 사용해 대화 히스토리를 분기하여 새로운 세션으로 이어갈 수도 있습니다. 이 기능들은 로컬 자식 프로세스로 동작하며, 별도의 데몬이나 네트워크 서비스를 시작하지 않습니다.
설치와 요구 사항
OpenClaude를 설치하려면 Node.js >=22.0.0이 필요합니다. npm을 통해 npm install -g @gitlawb/openclaude@latest 명령으로 설치할 수 있으며, Arch Linux 사용자는 AUR 패키지를 통해 설치할 수도 있습니다. 설치 후 ripgrep가 없으면 시스템에 설치해야 합니다. 소스 빌드나 로컬 개발을 위해서는 Bun 1.3.13 이상도 필요합니다. 기본 설정은 ~/.openclaude 디렉터리에 저장되며, 기존 Claude Code 설정(~/.claude)을 자동으로 읽지 않으므로 독립적으로 사용할 수 있습니다.
사용 전 확인 사항
OpenClaude는 Anthropic과 무관한 독립적인 커뮤니티 프로젝트이며, Claude Code 코드베이스에서 파생되어 수정된 것입니다. 라이선스는 MIT이지만, 파생된 Claude Code 부분은 Anthropic의 소유입니다. 모든 제공자에서 동일한 기능을 보장하지는 않으며, 특히 Anthropic 고유 기능은 다른 제공자에서 작동하지 않을 수 있습니다. 작은 로컬 모델은 긴 다단계 도구 흐름에서 어려움을 겪을 수 있으므로, 도구 호출 기능이 강한 모델을 사용하는 것이 좋습니다. 또한 웹 검색은 Exa의 무료 티어를 기본으로 사용하지만, 제한이 있으므로 API 키를 설정하거나 다른 백엔드를 선택할 수 있습니다.