Gitlawb/openclaude

OpenClaude – 오픈소스이자 터미널 중심의 코딩 에이전트 CLI

무엇인가요

• 다양한 LLM 프로바이더(OpenAI 호환 API, Gemini, GitHub Models, Ollama, Atomic Chat 등)에 단일 터미널 창에서 접근할 수 있는 Node.js 기반 명령줄 인터페이스입니다.
• 코딩 에이전트 기능을 통합: bash 실행, 파일 읽기/쓰기, grep/glob, 다단계 도구 호출, 그리고 현재 코드베이스의 구조적 뷰를 프롬프트에 삽입하는 "리포지터리 맵"을 제공합니다.
• 터미널의 분위기를 살리기 위해 피크셀 아트 "동료"를 불러올 수도 있습니다.

주요 기능 (README에 기술됨)

• 통합된 프로바이더 관리 – /provider 명령어로 설정을 안내하며 프로필을 ~/.openclaude-profile.json에 저장합니다. OpenAI, Gemini, Fireworks AI 등 수십 가지 클라우드 게이트웨이와 Ollama 같은 로컬 백엔드를 지원합니다.
• 도구 기반 워크플로우 – bash, 파일 편집, glob, 사용자 정의 에이전트용 내장 명령어를 제공합니다. CLI는 토큰 단위로 스트리밍 출력을 제공하며, 한 대화 내에서 도구를 반복 호출할 수 있습니다.
• 백그라운드 세션 – 터미널에서 분리된 비대화형 프롬프트를 실행합니다 (openclaude --bg …), ps로 목록을 확인하고 로그를 확인하거나 종료할 수 있습니다. 모든 세션 데이터는 ~/.openclaude/bg-sessions/에 저장됩니다.
• 리포지터리 맵 – 자동 생성된 리포지터리 그래프(페이지랭크 순위)를 REPO_MAP 플래그를 통해 컨텍스트에 삽입할 수 있습니다 (/repomap로 확인 가능).
• VS Code 확장 – 포함된 확장 기능을 통해 에디터에서 OpenClaude를 시작하고 테마 지원을 제공합니다.
• 동료 캐릭터 – 선택적 진짜 색상의 피크셀 아트 캐릭터로, 입력된 메시지에 반응합니다 (/buddy).

일반적인 사용 사례

• 터미널을 벗어나지 않고 LLM에게 코드 생성, 리팩터링, 디버깅을 요청합니다.
• 모델이 쉘 명령어나 파일 편집을 실행하도록 결정하는 다단계 자동화를 실행합니다.
• 개인정보 보호가 중요한 작업에는 로컬 모델(Ollama)을 사용하거나, 더 큰 모델을 위해 클라우드 프로바이더로 전환합니다.
• 장시간 실행 작업(예: 실패한 테스트 수정)을 백그라운드에서 실행하면서 다른 작업을 계속할 수 있습니다.
• 리포지터리 맵을 활용해 모델이 대규모 코드베이스에 대한 인식을 갖도록 합니다.

설치 및 빠른 시작

# Node ≥22 필요
npm install -g @gitlawb/openclaude@latest   # Arch에서는 AUR를 통해 설치 가능
openclaude                                 # REPL 시작

• /provider를 실행하여 백엔드를 설정합니다(API 키, 기본 URL, 기본 모델).
• GitHub Models는 /onboard-github를 사용하거나, OpenAI의 경우 OPENAI_API_KEY 및 OPENAI_MODEL와 같은 환경 변수를 설정합니다.
• --resume <id> / --continue 및 --fork-session으로 대화를 재개하거나 복제합니다.
• 백그라운드 작업: openclaude --bg "fix failing tests".

지원되는 프로바이더 (요약)

프로바이더	설정 방법	비고
OpenAI 호환 (OpenAI, OpenRouter, DeepSeek, Groq, LM Studio 등)	/provider 또는 환경 변수	표준 /v1 채팅 엔드포인트 사용
Gemini	/provider 또는 환경 변수	API 키만 필요
Ollama	/provider 또는 환경 변수	로컬 추론, API 키 없음
GitHub Models	/onboard-github	인터랙티브 온보딩
Atomic Chat, Bedrock, Vertex 등	/provider 또는 환경 변수	다양한 클라우드 게이트웨이
여러 파트너 게이트웨이 (AI/ML API, Novita AI, Concentrate, Exa 등)	/provider	각 서비스에서 모델을 자동 탐지

에코시스템 및 커뮤니티

• 디스커션 & Discord – GitHub Discussions 및 공개 Discord 서버 링크는 배지 바에 포함되어 있습니다.
• VS Code 확장 – 에디터에서 OpenClaude를 시작하고 테마 통합을 제공합니다.
• 파트너 통합 – GitLawb, Bankr.bot, Atomic Chat, Xiaomi MiMo, Atlas Cloud 등 파트너들은 OpenClaude가 라우팅할 수 있는 API 키 또는 게이트웨이를 제공합니다.
• 보안 및 라이선스 – MIT 라이선스, SECURITY.md 파일 및 공식 보안 정책 포함.

성숙도

• 활발히 유지 관리 중 (버튼은 최근 일일/월간 트렌드시프트 통계, PR 검사용 CI 버튼, npm 다운로드 버튼을 표시).
• 광범위한 프로바이더 지원과 리포지터리 맵, 백그라운드 세션, gRPC 서버(문서 참조)와 같은 고급 기능을 갖추고 있습니다.
• README에는 프로바이더별 특이사항(예: Anthropic 기능이 다른 곳에서는 누락될 수 있음, 작은 로컬 모델은 어려움)이 기재되어 있어 실제 사용자 피드백을 반영하고 있습니다.

결론 OpenClaude는 LLM 기반 코딩 지원을 터미널에 가져오며, 유연한 백엔드 지원, 도구 호출 루프, 선택적 UI 기능을 갖춘 진정한 오픈소스 CLI입니다. 문서가 잘 정비되어 있으며 확장 가능하며, 여러 LLM 서비스에 대한 단일 스크립터블 인터페이스를 원하는 개발자에게 적합합니다.