OpenClaude 소개: 모든 AI 코딩 모델을 위한 하나의 터미널

AI 코딩 관련 소식을 따라오고 있다면, 매주 새로운 CLI 도구가 나오는 것을 눈치챘을 것입니다. 어떤 도구는 OpenAI와 잘 작동하고, 어떤 도구는 Anthropic에서만 작동하며, 일부는 단일 클라우드 공급자에 묶여 있습니다. OpenClaude는 이러한 파편화를 끝내고자 합니다. OpenClaude는 클라우드와 로컬 모델 공급자를 하나의 터미널 우선 워크플로우로 통합하는 오픈소스 코딩 에이전트 CLI입니다.

OpenClaude란 무엇인가?

OpenClaude는 클라우드 및 로컬 모델 공급자 모두를 위해 만들어진 오픈소스 코딩 에이전트 CLI입니다. OpenAI 호환 API, Gemini, GitHub Models, Codex OAuth, Codex, Ollama, Atomic Chat 및 기타 지원되는 백엔드를 동일한 프롬프트, 도구, 에이전트, MCP, 슬래시 명령, 스트리밍 출력으로 사용할 수 있습니다. 공급자별 도구가 필요 없습니다.

한 가지 중요한 점: OpenClaude는 Claude Code에서 시작되었지만 여러 공급자를 지원하도록 대폭 수정되었습니다. 이는 독립적인 커뮤니티 프로젝트이며 Anthropic과 관련이 없습니다. 또한 자체 구성은 ~/.openclaude에 저장하며 ~/.claude나 Claude Code 자격 증명을 읽지 않으므로 완전히 깨끗한 상태에서 시작할 수 있습니다.

몇 분 만에 시작하기

OpenClaude는 Node.js >= 22.0.0이 필요합니다. 전역으로 설치하세요:

그런 다음 실행하기만 하면 됩니다:

CLI 안에서 /provider를 실행하면 안내에 따라 공급자를 설정할 수 있고, /onboard-github를 실행하면 GitHub Models 온보딩을 진행할 수 있습니다. 설정 과정에서 프로필과 자격 증명이 .openclaude-profile.json에 저장됩니다.

가장 빠른 OpenAI 설정을 원하시나요? 환경 변수 세 개를 설정하세요:

로컬 모델을 선호하시나요? Ollama를 지정하면 됩니다:

그게 전부입니다. 동일한 워크플로우에 완전히 다른 모델 백엔드를 사용할 수 있습니다. Arch Linux에서는 AUR에서 설치할 수도 있습니다: paru -S openclaude.

지원되는 공급자는?

OpenClaude는 긴 목록의 공급자를 지원합니다:

각 공급자는 /provider를 통한 안내 설정 경로를 제공하므로 모든 API 형태를 외울 필요가 없습니다.

무엇을 할 수 있나요?

OpenClaude는 단순한 채팅 래퍼가 아니라 완전한 코딩 에이전트 워크플로우입니다:

다음은 백그라운드 사용의 간단한 예시입니다:

에이전트를 서로 다른 모델로 라우팅하기

가장 눈에 띄는 기능 중 하나는 에이전트 라우팅입니다. 비용이나 성능에 따라 서로 다른 에이전트를 서로 다른 모델로 지정할 수 있고, maxSteps로 하위 에이전트 도구 단계를 제한할 수 있습니다. 예를 들어, 저렴한 모델은 탐색 작업을 처리하게 하고 더 강력한 모델은 중요한 코드 리뷰를 담당하게 할 수 있습니다. 이 모든 것은 ~/.openclaude/settings.json의 agentModels와 agentRouting으로 구성할 수 있습니다.

웹 검색 및 Fetch 기본 내장

기본적으로 WebSearch는 DuckDuckGo를 사용하여 Anthropic이 아닌 모델에서 작동하므로, GPT-4o, DeepSeek, Gemini, Ollama 및 기타 OpenAI 호환 공급자는 별도 설정 없이 무료 웹 검색 경로를 얻을 수 있습니다. JavaScript로 렌더링되는 사이트를 위해 더 안정적인 스크래핑이 필요하다면 Firecrawl API 키를 설정하면 OpenClaude가 대신 Firecrawl의 검색 및 스크래핑 엔드포인트를 사용합니다.

커스텀 통합을 위한 헤드리스 gRPC 서버

OpenClaude를 자체 앱이나 CI/CD 파이프라인에 내장하고 싶으신가요? 양방향 스트리밍을 지원하는 헤드리스 gRPC 서비스로 실행할 수 있습니다. npm run dev:grpc로 시작하고 src/proto/openclaude.proto에서 클라이언트를 생성하세요. 에이전트 코어를 중심으로 커스텀 UI나 자동화를 구축하는 팀에게 매우 유용한 탈출구입니다.

VS Code 확장 프로그램 포함

저장소에는 실행 통합, 공급자 인식 Control Center, 에디터 내 채팅, 테마 지원을 갖춘 VS Code 확장 프로그램이 포함되어 있습니다. 선택적으로 Microsoft Foundry / Azure OpenAI 구성을 지원하며, 시작된 터미널에 엔드포인트, 배포, API 키 설정을 주입합니다.

그리고 픽셀 아트 버디도 받을 수 있습니다

이 기능이 OpenClaude를 기억에 남게 만듭니다. /buddy를 실행하면 프롬프트 옆에서 함께 살아가는 트루컬러 픽셀 아트 히어로가 나타나며, 대기하고, 눈을 깜빡이고, Enter 키를 누를 때마다 시그니처 동작을 사용합니다. 파이터를 선택할 수 있습니다:

컴패니언은 prefersReducedMotion을 존중하며, 저색상 터미널에서는 라인 아트로 자연스럽게 전환되고, /buddy mute로 음소거할 수 있습니다. 솔직히 말해, 터미널에서 코딩하는 경험이 조금 더 생동감 있게 느껴집니다.

시도해 볼 만한가요?

여러 AI CLI 도구를 함께 사용하는 데 지쳤거나, GPT-4o 같은 클라우드 모델을 사용하든 qwen2.5-coder 같은 로컬 모델을 사용하든 일관된 워크플로우를 원한다면 OpenClaude를 사용해 볼 만합니다. 오픈소스이며 MIT 라이선스로 제공되고, 활발히 유지 관리되며, Discord와 GitHub Discussions에 친근한 커뮤니티가 있습니다.

한 가지 유의할 점: 모든 공급자가 동일하게 작동하지는 않습니다. Anthropic 고유 기능은 다른 백엔드에는 없을 수 있고, 도구 품질은 선택한 모델에 크게 좌우되며, 더 작은 로컬 모델은 긴 다단계 도구 흐름에서 어려움을 겪을 수 있습니다. 최상의 결과를 얻으려면 강력한 도구/함수 호출을 지원하는 모델을 사용하세요.

한 줄로 설치하고 /provider를 실행해 모든 LLM을 위한 하나의 터미널이 얼마나 편리한지 직접 확인해 보세요.