Twigpine/openclaude

OpenClaude – 오픈소스 코딩 에이전트 CLI

정의 – OpenClaude는 터미널 우선의 명령줄 인터페이스로, 다양한 대규모 언어 모델 백엔드(OpenAI, Gemini, Ollama, GitHub Models, 많은 상용 게이트웨이 등)와 대화하고 모델을 코딩 어시스턴트로 사용할 수 있게 합니다. bash 실행, 파일 읽기/쓰기, grep/glob, 웹 검색, 사용자 지정 에이전트 등의 도구 세트와 간단한 세션 시스템을 포함하여 대화를 유지, 재개 또는 분기할 수 있습니다.

주요 기능

• 다양한 공급자를 위한 단일 CLI – /provider 명령 또는 환경 변수를 통해 OpenAI 호환 API, Gemini, Ollama 또는 나열된 파트너 게이트웨이를 구성할 수 있습니다.
• 코딩 에이전트 워크플로 – 셸 명령 실행, 파일 편집, 코드베이스 검색, 사용자 지정 에이전트 또는 "스킬" 호출을 위한 내장 도구.
• 세션 관리 – 채팅 세션 저장, 목록, 재개, 삭제 또는 포크 가능. 백그라운드 세션은 터미널에서 분리된 비대화형 프롬프트를 실행할 수 있습니다.
• VS Code 확장 – 편집기에서 OpenClaude를 시작하고 테마 지원을 받을 수 있습니다.
• 크로스 플랫폼 – macOS, Linux, Windows(Node ≥ 22)에서 작동합니다. Arch Linux용 AUR 패키지도 제공됩니다.
• 확장 가능 – 사용자 지정 슬래시 명령, 스마트 자동 라우팅, gRPC 서버 모드, 리포지토리 맵 인텔리전스, Android 설치를 지원합니다.

설치

# 전역 npm 설치 (Node >= 22)
npm install -g @twigpine/openclaude@latest

이전에 이전 @gitlawb/openclaude 패키지를 설치했다면 먼저 제거하세요. Arch Linux에서는 paru -S openclaude도 사용할 수 있습니다. 설치 후 openclaude를 실행하여 REPL을 시작합니다.

일반적인 워크플로

1. 공급자 구성 – REPL 내에서 /provider를 실행(또는 환경 변수 설정)하여 클라우드 API 키, 모델, 엔드포인트를 선택합니다.
2. 세션 시작 – 프롬프트를 입력하기만 하면 됩니다. 예: Write a function that validates an email address.
3. 도구 사용 – 슬래시 명령으로 bash 실행, 파일 편집, grep, 웹 검색(/search)을 호출할 수 있습니다.
4. 세션 관리 – /sessions로 저장된 채팅을 나열하고, openclaude --resume <id> 또는 --continue로 재개하며, --fork-session으로 대화의 새 분기를 만듭니다.
5. 백그라운드 작업 – openclaude --bg "fix failing tests"로 프롬프트를 백그라운드에서 실행하고, openclaude ps, logs, kill로 작업을 관리합니다.

지원 백엔드(일부) – OpenAI, OpenRouter, DeepSeek, Mistral, Gemini, Ollama(로컬), GitHub Models, Codex, Fireworks AI, LongCat, Cloudflare Workers AI, Bedrock/Vertex, 그리고 많은 파트너 게이트웨이(AI/ML API, Novita, ApiSmart, Concentrate, Exa, GMI Cloud, Xiaomi MiMo 등). CLI는 각 공급자에서 사용 가능한 모델을 자동으로 발견합니다.

커뮤니티 및 생태계

• 토론 및 Discord – 도움말, 기능 아이디어, 문제 해결을 위한 활성 채널.
• VS Code 확장 – 편집기에서 OpenClaude를 시작하고 픽셀 아트 "히어로" 컴패니언을 받을 수 있습니다.
• 방대한 문서 – 비기술 사용자를 위한 빠른 시작 가이드, Windows/macOS/Linux 특정 사항, 고급 주제(스마트 라우팅, 리포지토리 맵, gRPC 서버, Android 설치).
• 오픈소스 – MIT 라이선스, npm에 게시되고 공개 Git 리포지토리에 미러링됩니다.

OpenClaude는 본질적으로 LLM 기반 코딩 지원을 위한 통합 프런트엔드로, 개발자가 별도의 SDK나 CLI를 다루지 않고 클라우드와 로컬 모델을 전환하면서 터미널에 머물 수 있게 합니다.