오픈소스 레포 리뷰 · 코딩 에이전트 CLI

OpenClaude 분석: 모델을 바꿔도 코딩 에이전트 루프를 유지할 수 있습니까?

Q: npm으로 바로 설치해서 써도 됩니까?

개인 테스트 저장소에서는 npm install -g @gitlawb/openclaude@latest 후 openclaude를 실행해 볼 수 있습니다. 회사 코드베이스에서는 라이선스와 보안 정책을 먼저 확인해야 합니다.

Gitlawb/openclaude는 오픈AI 호환 API, 제미니, 올라마, 깃허브 모델, 코덱스 계열 공급자를 하나의 터미널 워크플로 안에 묶으려는 타입스크립트 CLI입니다. 핵심은 모델 성능 비교보다 작업 흐름을 보존하는 데 있습니다.

소스 유형: GitHub 레포 카드뉴스: 8장 확인일: 2026-06-20 X-Ray 참고: 완료

공식 레포 주소

Gitlawb/openclaude

이 글의 기준이 되는 원본 저장소입니다. 카드뉴스와 해설을 읽기 전에 레포 주소를 먼저 확인하면, 라이선스·README·릴리스·이슈·커밋 상태를 직접 대조할 수 있습니다.

https://github.com/Gitlawb/openclaude github.com

OpenClaude provider 선택 패널과 멀티 모델 터미널 워크플로 카드뉴스 1

1/8 · 하나의 터미널 워크플로와 여러 공급자

OpenClaude npm 설치와 Read Edit Bash Grep MCP 작업 흐름 카드뉴스 2

2/8 · 터미널 하나가 작업대가 되는 구조

OpenClaude Ollama 로컬 모델과 클라우드 모델 프로파일 분리 카드뉴스 3

3/8 · 민감한 탐색과 무거운 수정을 나누는 방식

OpenClaude background session bg logs 리팩터링 카드뉴스 4

4/8 · 오래 걸리는 작업을 백그라운드로 보내는 방식

OpenClaude agentRouting Explore Plan verification 모델 라우팅 카드뉴스 5

5/8 · 역할별 모델 라우팅

OpenClaude gRPC TextChunk ToolCallStart ActionRequired FinalResponse 카드뉴스 6

6/8 · 커스텀 UI와 자동화 파이프라인

7/8 · VS Code Control Center

OpenClaude LICENSE SECURITY API key permission mode 체크리스트 카드뉴스 8

8/8 · 라이선스와 키 저장 방식 확인

좌우로 넘기거나 카드를 눌러 크게 볼 수 있습니다. 미리보기에서도 원본 이미지 전체가 보이도록 표시했습니다.

카드뉴스 8장은 어떤 흐름으로 읽어야 합니까?

상단 카드뉴스는 OpenClaude를 단순한 모델 목록이 아니라 코딩 에이전트 워크플로 보존 도구로 읽게 만듭니다. 아래 흐름대로 보면 기능 소개와 도입 전 체크포인트가 자연스럽게 연결됩니다.

1하나의 터미널 워크플로를 유지한 채 공급자를 바꿉니다./provider 선택 패널을 중심으로 오픈AI 호환 API, 제미니, 올라마, 코덱스, 깃허브 모델을 같은 CLI 안에서 다루는 출발점입니다.

2설치 후 터미널 하나가 작업대가 됩니다.파일 읽기, 수정, Bash, grep, MCP 호출이 대화 흐름 안에 쌓입니다. 모델을 바꿔도 도구 호출의 생활감은 유지됩니다.

3로컬 모델과 클라우드 모델을 상황별로 나눕니다.민감한 코드 탐색은 올라마 같은 로컬 경로로, 무거운 수정은 클라우드 모델로 보내는 운영 패턴을 제안합니다.

4긴 작업은 --bg 세션으로 보냅니다.리팩터링이나 테스트 수정처럼 오래 걸리는 작업을 분리하고 로그로 따라가는 흐름을 보여줍니다.

5역할별 모델 라우팅으로 비용과 성능을 나눕니다.Explore, Plan, verification 같은 에이전트 역할마다 다른 모델을 붙이는 구성이 핵심입니다.

6gRPC로 자체 UI와 자동화 파이프라인을 엽니다.TextChunk, ToolCallStart, ActionRequired, FinalResponse 이벤트가 외부 앱으로 흘러가는 확장 지점입니다.

7VS Code 사용자는 Control Center를 확인합니다.워크스페이스 프로파일, provider summary, launch cwd를 IDE 안에서 확인하고 터미널을 실행하는 보조 경로입니다.

8도입 전에는 LICENSE와 키 저장 방식을 먼저 봅니다.README 배지보다 LICENSE notice, SECURITY.md, provider별 툴 콜링 품질, 권한 모드를 먼저 확인해야 합니다.

핵심 결론

OpenClaude는 여러 모델을 비교하면서도 코딩 에이전트의 터미널 루프를 하나로 유지하려는 사용자에게 실험 가치가 큰 레포입니다.
2026년 6월 20일 확인 기준 Gitlawb/openclaude는 stars 29,196개, forks 8,787개, open issues와 PR 합산 138개를 가진 공개 레포입니다.
npm 최신 패키지는 @gitlawb/openclaude@0.19.0이며, 실행에는 Node.js >=22.0.0이 필요합니다.
README와 소스에서 /provider, --bg, agentRouting, gRPC, VS Code 확장 경로가 확인됩니다.
다만 LICENSE는 OpenClaude 기여 수정분만 가능한 범위에서 MIT로 제공한다고 설명하고, 기반 클로드 코드 파생 부분은 앤스로픽 저작권 대상이라고 고지합니다.

쉽게 이해하기

OpenClaude는 코딩 에이전트의 작업대는 그대로 두고, 뒤에 꽂는 모델 공급자만 바꾸게 해주는 터미널 도구입니다.

비유

하나의 멀티탭에 여러 충전기를 꽂는 장면과 비슷합니다. 노트북 자리, 케이블 정리, 전원 스위치는 그대로 두고, 필요한 기기만 바꾸어 꽂습니다. OpenClaude에서 멀티탭은 터미널 워크플로이고, 충전기는 오픈AI 호환 API, 제미니, 올라마, 깃허브 모델 같은 공급자입니다.

핵심은 모델 자체가 아니라 프롬프트, 파일 도구, Bash, MCP, slash command가 이어지는 작업 흐름입니다.
/provider로 프로파일을 저장하면 같은 저장소 안에서 로컬 모델과 클라우드 모델을 바꿔 쓸 수 있습니다.
agentRouting은 탐색, 계획, 검증 같은 역할마다 다른 모델을 붙이는 비용 관리 장치입니다.
회사 코드베이스에 넣기 전에는 라이선스, API 키 저장 방식, permission mode를 별도로 검토해야 합니다.

핵심 용어

OpenClaude여러 모델 공급자를 하나의 터미널 코딩 에이전트 루프에 붙이려는 타입스크립트 CLI입니다.

Provider오픈AI 호환 API, 제미니, 올라마, 깃허브 모델처럼 실제 모델 호출을 담당하는 백엔드입니다.

/provider공급자 설정과 자격 증명을 guided setup으로 저장하는 OpenClaude 내부 명령입니다.

Tool calling모델이 파일 읽기, 편집, Bash 실행 같은 도구 사용을 요청하고 결과를 다시 받아 이어가는 흐름입니다.

MCP모델과 외부 도구를 표준화된 방식으로 연결하는 Model Context Protocol입니다.

agentRouting에이전트 역할별로 모델과 공급자를 다르게 지정하는 설정입니다.

Background session긴 작업을 openclaude --bg로 별도 프로세스에 보내고 로그로 추적하는 기능입니다.

gRPCOpenClaude agent loop를 외부 앱, CI, 자체 UI에서 스트리밍으로 호출할 수 있게 하는 통신 경로입니다.

OpenClaude는 무엇을 하는 레포입니까?

OpenClaude는 클로드 코드식 터미널 경험을 여러 모델 공급자 위에서 유지하려는 코딩 에이전트 CLI입니다. README는 오픈AI 호환 API, 제미니, 깃허브 모델, 코덱스 OAuth, 코덱스, 올라마, Atomic Chat 등 여러 백엔드를 같은 터미널 우선 워크플로에 연결한다고 설명합니다GitHub.

제가 보기에는 이 레포의 가치는 모델을 하나 더 지원한다는 점보다, 파일 도구와 Bash, grep, glob, MCP, slash command, streaming output을 한 작업대에 묶는다는 점에 있습니다. AI 코딩 도구를 매번 바꾸면 프롬프트보다 주변 설정에서 시간이 많이 빠지기 때문입니다.

29,196깃허브 stars, 2026년 6월 20일 API 확인 기준입니다.

8,787깃허브 forks, 2026년 6월 20일 API 확인 기준입니다.

0.19.0최신 깃허브 release와 npm latest 버전입니다.

Node 22+npm 설치와 런타임에 필요한 Node.js 엔진 조건입니다.

어떻게 설치하고 같은 흐름으로 사용합니까?

README의 빠른 시작 경로는 npm 전역 설치 후 openclaude를 실행하는 방식입니다. 앱 안에서는 /provider로 공급자 설정과 저장 프로파일을 만들고, 깃허브 모델은 /onboard-github 경로를 사용합니다.

# npm 설치와 실행
npm install -g @gitlawb/openclaude@latest
openclaude

# OpenClaude 안에서 공급자 설정
/provider
/onboard-github

여기서 주의할 점은 .env 파일을 프로젝트에서 자동으로 읽지 않는다는 설명입니다. README는 /provider 명령을 권장하며, 환경변수를 쓰고 싶다면 명시적으로 export하거나 openclaude --provider-env-file .env를 사용하라고 안내합니다.

모델 라우팅과 백그라운드 세션은 왜 중요합니까?

코딩 에이전트 작업은 모두 같은 성격이 아닙니다. 코드 구조를 넓게 탐색하는 단계, 수정 계획을 세우는 단계, 마지막 검증 단계는 비용과 정확도 요구가 다릅니다. OpenClaude는 agentModels와 agentRouting을 통해 Explore, Plan, verification 같은 역할별 라우팅을 제공합니다.

{
  "agentModels": {
    "mini": { "model": "gpt-5-mini" },
    "gpt-4o": {
      "base_url": "https://api.openai.com/v1",
      "api_key": "sk-your-key"
    }
  },
  "agentRouting": {
    "Plan": "gpt-4o",
    "verification": "mini"
  }
}

긴 리팩터링과 테스트 수정은 --bg 세션으로 분리할 수 있습니다. README는 openclaude --bg --name auth-refactor "refactor auth middleware", openclaude logs auth-refactor -f, openclaude kill auth-refactor 같은 흐름을 제시합니다. 단, 로컬 background session의 full terminal reattach는 아직 구현되지 않았다고 밝힙니다.

팀 내부 도구로 확장할 수 있습니까?

개인 CLI를 넘어서려면 이벤트를 외부 시스템으로 내보낼 수 있어야 합니다. OpenClaude는 headless gRPC 서버 경로를 제공하며, src/proto/openclaude.proto에는 TextChunk, ToolCallStart, ToolCallResult, ActionRequired, FinalResponse가 정의되어 있습니다.

이 구조는 내부 코드 리뷰 UI, CI 파이프라인, 권한 승인 화면을 붙일 때 의미가 있습니다. 다만 gRPC 서버는 기본적으로 localhost:50051에서 시작하며, README는 0.0.0.0 바인딩을 인증 없이 외부 노출하는 것을 권장하지 않습니다.

VS Code

레포에는 VS Code 확장이 포함되어 있습니다. Control Center는 설치된 command, launch cwd, 워크스페이스 프로파일 존재 여부, provider summary를 보여준다고 설명합니다.

gRPC

외부 앱은 양방향 스트림으로 텍스트 청크, 툴 시작, 툴 결과, 사용자 승인 요청, 최종 응답을 받을 수 있습니다.

실무 도입 전 무엇을 먼저 확인해야 합니까?

두 번째는 공급자별 품질 차이입니다. README는 앤스로픽 전용 기능이 다른 공급자에 없을 수 있고, 툴 품질이 선택한 모델에 크게 좌우되며, 작은 로컬 모델은 긴 multi-step tool flow에서 어려움을 겪을 수 있다고 적습니다. 따라서 회사 코드베이스에 바로 붙이기보다 테스트 저장소에서 Read, Edit, Bash, grep, MCP 흐름을 먼저 검증해야 합니다.

도입 체크리스트

법무 검토 전에는 LICENSE notice를 먼저 확인해야 합니다. 보안 측면에서는 SECURITY.md, ~/.openclaude.json의 plaintext API key 가능성, --dangerously-skip-permissions 사용 금지 정책, provider별 툴 콜링 품질을 함께 봐야 합니다.

개발자 관심도는 어느 정도입니까?

레포 관심도는 높습니다. 2026년 6월 20일 깃허브 API 확인 기준으로 stars 29,196개와 forks 8,787개를 기록했습니다. subscribers_count는 221개이며, latest release는 v0.19.0으로 2026년 6월 16일 공개되었습니다.

다만 이 숫자를 곧바로 실무 안정성으로 해석하면 안 됩니다. X-Ray 결과도 신뢰도는 B, 오픈소스 성숙도는 C+로 봤습니다. 공식 GitHub, npm, release, CI, 소스 구조는 확인되지만, 라이선스와 provider별 장시간 실사용 검증은 별도의 판단 영역입니다.

강점	공급자 추상화, 설치 경로, npm 배포, release, background session, agent routing, gRPC, VS Code 확장이 문서와 소스에서 확인됩니다.
한계	LICENSE 고지, provider별 툴 콜링 품질 차이, 작은 로컬 모델의 장기 작업 안정성, plaintext key 설정 가능성은 도입 전 검증이 필요합니다.
적합한 사용자	여러 모델을 비교하면서 파일 수정, Bash, MCP, 검증 루프를 하나의 터미널 작업 방식으로 유지하려는 개인 개발자와 내부 도구 팀입니다.

자주 묻는 질문

OpenClaude는 클로드 코드 공식 도구입니까?

npm으로 바로 설치해서 써도 됩니까?

개인 테스트 저장소에서는 npm install -g @gitlawb/openclaude@latest 후 openclaude를 실행해 볼 수 있습니다. 회사 코드베이스에서는 라이선스와 보안 정책을 먼저 확인해야 합니다.

로컬 올라마와 클라우드 모델을 함께 쓸 수 있습니까?

README는 올라마를 로컬 inference와 no API key 경로로 안내하며, 오픈AI 호환 API와 여러 클라우드 provider도 지원한다고 설명합니다. 실제 품질은 모델과 provider별 툴 콜링 성능에 따라 달라집니다.

agentRouting은 언제 유용합니까?

탐색은 저렴한 모델, 계획은 강한 모델, 검증은 작은 모델처럼 역할별 비용과 성능을 나누고 싶을 때 유용합니다. 단, api_key가 plaintext 설정에 들어갈 수 있으므로 파일 권한과 secret 관리가 필요합니다.

이 글의 카드뉴스 이미지는 실제 앱 캡처입니까?

아닙니다. 상단 이미지는 커뮤니티 카드뉴스용으로 제작된 설명 이미지입니다. 실제 UI 캡처로 제시하지 않았으며, 본문은 README, GitHub API, npm registry, LICENSE, 소스 파일과 X-Ray 결과를 기준으로 작성했습니다.

출처

확인일은 2026년 6월 20일입니다. 수치와 기능 설명은 공식 또는 1차 출처, 그리고 제공된 X-Ray 결과를 기준으로 정리했습니다.

Gitlawb/openclaude GitHub 레포 공개 레포, README, provider, background session, agent routing, gRPC, VS Code 설명 확인.
GitHub API repository metadata stars, forks, open issues와 PR 합산, license NOASSERTION, 최신 push 확인.
GitHub release v0.19.0 최신 release tag와 공개일 확인.
npm registry latest JSON @gitlawb/openclaude@0.19.0, Node.js engine, CLI bin 확인.
LICENSE OpenClaude contributors 수정분 MIT와 앤스로픽 derived code notice 확인.
SECURITY.md latest release 지원 범위와 취약점 신고 경로 확인.
src/proto/openclaude.proto gRPC stream 이벤트 정의 확인.
src/services/api/agentRouting.ts agent routing, model-only route, cross-provider override 처리 확인.
src/cli/bg.ts background session launch, logs, kill parsing 경로 확인.
VS Code extension README Control Center와 workspace profile 설명 확인.
Paper/Repo X-Ray 결과 제공된 X-Ray HTML의 검증 판정과 등급을 참고했습니다.

#OpenClaude #Gitlawb #코딩에이전트 #AI코딩 #터미널CLI #오픈소스리뷰 #LLM #오픈AI호환API #제미니 #올라마 #깃허브모델 #코덱스 #MCP #agentRouting #gRPC #VSCodeExtension #Nodejs #npm #개발도구 #AC리서치

본 글은 공개 레포와 제공된 X-Ray 결과를 바탕으로 작성한 정보 제공용 리뷰이며, 법률·보안·투자 조언이 아닙니다. 수치는 확인 시점 기준입니다.