Gitlawb/openclaude

runs anywhere. uses anything

GitHub에서 열기 ↗ aiai-agentai-toolsclicoding

29,919

GitHub 스타

8,869

포크

TypeScript

언어

NOASSERTION

라이선스

2026.07.10

최근 푸시

2026.05.10

별표한 날

AI 분석

설치 난이도: 보통

큐레이터 노트

OpenClaude는 다양한 AI 모델 제공자를 통합한 강력한 코딩 에이전트 CLI로, 특히 여러 백엔드를 오가며 작업해야 하는 개발자에게 적합합니다. 로컬 및 클라우드 모델을 모두 지원하며, 확장 가능한 도구 체계를 갖추고 있어 장기적으로 참고하거나 도입할 가치가 있습니다.

강점

다양한 클라우드 및 로컬 모델 제공자를 단일 CLI로 통합하여 유연성이 뛰어납니다.
코딩 에이전트 워크플로우(bash, 파일 도구, MCP 등)를 내장하여 생산성을 높입니다.
백그라운드 세션, 대화 포크, VS Code 확장 등 고급 기능을 제공합니다.

약점

일부 제공자(예: Anthropic)의 고유 기능이 다른 제공자에서는 지원되지 않을 수 있습니다.
작은 로컬 모델은 복잡한 다단계 도구 흐름에서 성능이 저하될 수 있습니다.
백그라운드 세션의 전체 터미널 재연결(attach)이 아직 구현되지 않았습니다.

주의사항

프로젝트 .env 파일을 자동 로드하지 않으므로 제공자 설정 시 /provider 명령어 사용을 권장합니다.
Gitlawb Opengateway는 새 설치 시 기본 제공자이지만 API 키가 필요하며, 기본 URL을 잘못 고정하지 않도록 주의해야 합니다.
GitHub Copilot 하위 에이전트 최적화 변수는 기본적으로 동기식 실행을 강제하므로, 병렬 실행이 필요한 경우 명시적으로 활성화해야 합니다.

시작 가이드

Node.js >=22.0.0이 설치되어 있는지 확인하고 npm install -g @gitlawb/openclaude@latest로 설치합니다.
빠른 시작 가이드에 따라 OpenAI 또는 Ollama 등 원하는 제공자를 설정하고 /provider 명령어로 프로필을 저장합니다.
백그라운드 세션 및 대화 포크 기능을 테스트하여 워크플로우에 통합할 방법을 탐색합니다.

README 한국어 번역

이 번역은 AI가 원문 README를 옮긴 것입니다. 원문이 항상 우선합니다.

OpenClaude

OpenClaude는 클라우드 및 로컬 모델 제공자를 위한 오픈소스 코딩 에이전트 CLI입니다.

OpenAI 호환 API, Gemini, GitHub Models, Codex OAuth, Codex, Ollama, Atomic Chat 및 기타 지원되는 백엔드를 사용하면서 하나의 터미널 우선 워크플로우(프롬프트, 도구, 에이전트, MCP, 슬래시 명령어, 스트리밍 출력)를 유지할 수 있습니다.

OpenClaude는 GitLawb에도 미러링되어 있습니다: gitlawb.com/node/repos/z6MkqDnb/openclaude

스폰서

<table align="center"> <tr> <td align="center" width="150" height="80"> <a href="https://gitlawb.com"> <img src="https://gitlawb.com/logo.png" alt="GitLawb 로고" width="72"> </a> </td> <td align="center" width="150" height="80"> <a href="https://bankr.bot"> <img src="https://bankr.bot/favicon.svg" alt="Bankr.bot 로고" width="72"> </a> </td> <td align="center" width="150" height="80"> <a href="https://atomic.chat/"> <img src="docs/assets/atomic-chat-logo.png" alt="Atomic Chat 로고" width="72"> </a> </td> <td align="center" width="150" height="80"> <a href="https://mimo.mi.com"> <img src="https://mimo.xiaomi.com/mimo-v2-pro/assets/logo.svg" alt="Xiaomi MiMo 로고" width="136"> </a> </td> <td align="center" width="150" height="80"> <a href="https://www.atlascloud.ai/"> <img src="docs/assets/atlas-cloud-banner.png" alt="Atlas Cloud 로고" width="136"> </a> </td> </tr> <tr> <td align="center"><a href="https://gitlawb.com">GitLawb</a></td> <td align="center"><a href="https://bankr.bot">Bankr.bot</a></td> <td align="center"><a href="https://atomic.chat/">Atomic Chat</a></td> <td align="center"><a href="https://mimo.mi.com">Xiaomi MiMo</a></td> <td align="center"><a href="https://www.atlascloud.ai/">Atlas Cloud</a></td> </tr> </table>

Star History

왜 OpenClaude인가

하나의 CLI로 클라우드 API와 로컬 모델 백엔드를 사용
/provider 명령어로 앱 내에 제공자 프로필 저장
OpenAI 호환 서비스, Gemini, GitHub Models, Codex OAuth, Codex, Ollama, Atomic Chat 및 기타 지원 제공자와 함께 실행
코딩 에이전트 워크플로우를 한 곳에서 유지: bash, 파일 도구, grep, glob, 에이전트, 태스크, MCP, 웹 도구
번들된 VS Code 확장으로 실행 통합 및 테마 지원 사용

빠른 시작

설치

OpenClaude는 npm 설치 및 런타임에 Node.js >=22.0.0이 필요합니다. Bun은 소스 빌드 및 로컬 개발에만 필요합니다.

npm install -g @gitlawb/openclaude@latest

Arch Linux를 사용하는 경우 커뮤니티 유지 AUR 패키지에서 OpenClaude를 설치할 수 있습니다:

paru -S openclaude

설치 후 ripgrep not found가 보고되면 시스템 전체에 ripgrep을 설치하고 OpenClaude를 시작하기 전에 동일한 터미널에서 rg --version이 작동하는지 확인하세요.

설치된 버전 확인/문제 해결:

openclaude --version
npm view @gitlawb/openclaude dist-tags
npm install -g @gitlawb/openclaude@latest

시작

openclaude

OpenClaude 내부에서:

/provider 실행: 안내 제공자 설정 및 저장된 프로필
/onboard-github 실행: GitHub Models 온보딩

참고: OpenClaude는 프로젝트 .env 파일을 자동으로 로드하지 않습니다. 설정에는 /provider 명령어를 사용하는 것이 좋습니다. 이 명령어는 제공자 프로필과 자격 증명을 .openclaude-profile.json에 저장합니다. 환경 변수를 선호하는 경우 명시적으로 내보내거나 제공자/설정 변수를 위해 openclaude --provider-env-file.env를 실행하세요. 런타임/디버그 설정은 셸 또는 실행기에서 내보내세요.

대화 재개 또는 포크

세션 ID로 기존 대화를 재개하거나 현재 디렉토리에서 가장 최근 대화를 계속합니다:

openclaude --resume <session-id>
openclaude --continue

--fork-session을 추가하면 원본 대화록을 재사용하는 대신 대화 기록을 새 세션 ID로 분기합니다:

openclaude --resume <session-id> --fork-session
openclaude --continue --fork-session

포크는 대화 분기만 수행합니다. 파일 시스템 격리, 작업 트리 복사 또는 git worktree 분기를 생성하지 않습니다.

백그라운드 세션

현재 터미널에서 분리하여 긴 비대화형 프롬프트를 실행합니다:

openclaude --bg "fix failing tests"
openclaude --bg --name auth-refactor "refactor auth middleware"
openclaude ps
openclaude logs auth-refactor
openclaude logs auth-refactor -f
openclaude kill auth-refactor

백그라운드 세션은 로컬 자식 프로세스입니다. OpenClaude는 데몬이나 네트워크 서비스를 시작하지 않으며, 권한/제공자/모델/설정 플래그는 포그라운드 --print 실행과 동일하게 자식 프로세스에 전달됩니다. 세션 메타데이터와 로그는 확인된 OpenClaude 설정 디렉토리(보통 ~/.openclaude/bg-sessions/) 아래에 저장됩니다. OPENCLAUDECONFIGDIR은 OpenClaude가 다른 위치를 가리키도록 할 수 있으며, CLAUDECONFIGDIR은 여전히 레거시 대체 경로로 지원됩니다. 세션 이름은 이전 세션이 종료 상태에 도달한 후 재사용할 수 있습니다. 동일한 이름의 이전 로그를 검사하려면 세션 ID를 사용하세요.

openclaude attach <id-or-name>은 현재 일치하는 세션을 보고하고 openclaude logs <id> -f를 가리킵니다. 전체 터미널 재연결은 아직 로컬 백그라운드 세션에 대해 구현되지 않았습니다.

가장 빠른 OpenAI 설정

macOS / Linux:

export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_API_KEY=sk-your-key-here
export OPENAI_MODEL=gpt-4o

openclaude

Windows PowerShell:

$env:CLAUDE_CODE_USE_OPENAI="1"
$env:OPENAI_API_KEY="sk-your-key-here"
$env:OPENAI_MODEL="gpt-4o"

openclaude

가장 빠른 로컬 Ollama 설정

macOS / Linux:

export CLAUDE_CODE_USE_OPENAI=1
export OPENAI_BASE_URL=http://localhost:11434/v1
export OPENAI_MODEL=qwen2.5-coder:7b

openclaude

Windows PowerShell:

$env:CLAUDE_CODE_USE_OPENAI="1"
$env:OPENAI_BASE_URL="http://localhost:11434/v1"
$env:OPENAI_MODEL="qwen2.5-coder:7b"

openclaude

설정 가이드

초보자 친화적인 가이드:

비기술적 설정
Windows 빠른 시작
macOS / Linux 빠른 시작

고급 및 소스 빌드 가이드:

고급 설정
Android 설치

지원 제공자

제공자	설정 경로	참고 사항
OpenAI 호환	`/provider` 또는 환경 변수	OpenAI, OpenRouter, DeepSeek, Groq, Mistral, LM Studio 및 기타 호환 `/v1` 서버와 작동
Z.AI GLM Coding Plan	`/provider` 또는 OpenAI 호환 환경 변수	`https://api.z.ai/api/coding/paas/v4`에서 `OPENAIAPIKEY` 사용, 기본 모델 `glm-5.2`
Hicap	`/provider` 또는 OpenAI 호환 환경 변수	`api-key` 인증 사용, 인증되지 않은 `/models`에서 모델 검색, `gpt-` 모델에 대해 Responses 모드 지원
Fireworks AI	`/provider` 또는 환경 변수	276개의 큐레이션된 모델(DeepSeek, Qwen, Llama, Gemma 등)을 갖춘 일급 제공자; `FIREWORKSAPIKEY` 사용
Gemini	`/provider` 또는 환경 변수	API 키만 지원
GitHub Models	`/onboard-github`	저장된 자격 증명으로 대화형 온보딩
Codex OAuth	`/provider`	브라우저에서 ChatGPT 로그인을 열고 Codex 자격 증명을 안전하게 저장
Codex	`/provider`	기존 Codex CLI 인증, OpenClaude 보안 저장소 또는 환경 자격 증명 사용
Gitlawb Opengateway	시작 기본값, `/provider` 또는 환경 변수	`https://opengateway.gitlawb.com/v1`의 스마트 게이트웨이; https://gitlawb.com/opengateway/keys에서 API 키 필요, `OPENAI_MODEL`로 Xiaomi MiMo 및 GMI Cloud 파트너 모델 라우팅
OpenCode Zen	`/provider` 또는 환경 변수	종량제 AI 게이트웨이(48개 모델); `https://opencode.ai/zen/v1`에서 `OPENCODEAPIKEY` 사용; OpenCode Go와 공유 키
OpenCode Go	`/provider` 또는 환경 변수	오픈 모델(13개 모델)에 대해 월 $10 구독; `https://opencode.ai/zen/go/v1`에서 `OPENCODEAPIKEY` 사용; OpenCode Zen과 공유 키
Xiaomi MiMo	`/provider` 또는 환경 변수	`https://mimo.mi.com`의 OpenAI 호환 API; `MIMOAPIKEY` 사용, 기본 모델 `mimo-v2.5-pro`
NEAR AI	`/provider` 또는 환경 변수	통합 게이트웨이(Claude, GPT, Gemini + TEE 오픈 모델); `https://cloud-api.near.ai/v1`에서 `NEARAIAPIKEY` 사용
Ollama	`/provider` 또는 환경 변수	API 키 없이 로컬 추론
Atomic Chat	`/provider`, 환경 변수 또는 `bun run dev:atomic-chat`	로컬 모델 제공자; 로드된 모델 자동 감지
Bedrock / Vertex / Foundry	환경 변수	Anthropic 계열 클라우드 경로; Vertex는 임의의 Model Garden 모델이 아닌 Claude on Vertex AI용

작동하는 기능

도구 기반 코딩 워크플로우: Bash, 파일 읽기/쓰기/편집, grep, glob, 에이전트, 태스크, MCP 및 슬래시 명령어
스트리밍 응답: 실시간 토큰 출력 및 도구 진행 상황
도구 호출: 모델 호출, 도구 실행 및 후속 응답을 포함한 다단계 도구 루프
이미지: 비전을 지원하는 제공자를 위한 URL 및 base64 이미지 입력
제공자 프로필: 안내 설정 및 저장된 사용자 수준 제공자 프로필 지원
로컬 및 원격 모델 백엔드: 클라우드 API, 로컬 서버 및 Apple Silicon 로컬 추론

제공자 참고 사항

OpenClaude는 여러 제공자를 지원하지만 모든 제공자에서 동작이 동일하지는 않습니다.

Anthropic 특화 기능은 다른 제공자에 존재하지 않을 수 있습니다.
도구 품질은 선택한 모델에 크게 의존합니다.
작은 로컬 모델은 긴 다단계 도구 흐름에 어려움을 겪을 수 있습니다.
일부 제공자는 CLI 기본값보다 낮은 출력 제한을 부과하며, OpenClaude는 가능한 경우 적응합니다.
Gitlawb Opengateway는 새 설치 시작 기본값이며 https://gitlawb.com/opengateway/keys에서 API 키가 필요합니다. 하나의 OpenAI 호환 기본 URL을 사용합니다. /model로 mimo-*와 google/gemini-3.1-flash-lite-preview 사이를 전환하고, 기본 URL을 /v1/xiaomi-mimo로 고정하지 마십시오.
Z.AI GLM Coding Plan은 기본적으로 https://api.z.ai/api/coding/paas/v4와 glm-5.2를 사용합니다. 향상된 추론을 위해 glm-5.2?reasoning=high, Z.AI reasoning_effort=max를 요청하려면 glm-5.2?reasoning=xhigh, 더 빠른 직접 답변을 위해 glm-5.2?thinking=disabled를 사용하세요.
Xiaomi MiMo는 직접 OpenAI 호환 경로에서 api-key 헤더 인증을 사용하며, 현재 OpenClaude에서 /usage 보고를 지원하지 않습니다.

GitHub Copilot 하위 에이전트 최적화

CLAUDECODEUSEGITHUB=1일 때 OpenClaude는 GitHub Copilot Premium Request 소비를 줄이기 위해 하위 에이전트 실행을 직렬화합니다. 기본 동작은 GITHUBCOPILOTMAXSUBAGENTS=1(동기식, 한 번에 하나의 하위 에이전트)입니다. 조정 변수(모두 선택 사항):

	변수	효과
	GITHUBCOPILOTMAX_SUBAGENTS=0	하위 에이전트를 완전히 억제(하위 에이전트가 오류를 발생시킴).
	GITHUBCOPILOTMAX_SUBAGENTS=1	동기식 실행 강제. 기본값.
	GITHUBCOPILOTMAX_SUBAGENTS=2..10	구문 분석/제한되지만 =1과 다르게 강제되지 않음(양수 제한 = 동기식).
	GITHUBCOPILOTALLOW_SUBAGENTS=1	제한을 무시하고 병렬/백그라운드 하위 에이전트를 다시 활성화.
	GITHUBCOPILOTFORCESYNCSUBAGENTS=1	제한에 관계없이 동기식 실행 강제.
	GITHUBCOPILOTOPTIMIZATION_DISABLED=1	위의 모든 것을 비활성화; 하위 에이전트는 이 기능 이전처럼 실행.

tenguagenttoolselected 이벤트와 에이전트 메타데이터에 보고된 isasync 필드는 이제 최종 실행 모드를 반영합니다(즉, 동기식이 강제되면 false). 전체 설명은 .env.example을 참조하세요.

최상의 결과를 위해 강력한 도구/함수 호출 지원을 갖춘 모델을 사용하세요.

에이전트 라우팅

OpenClaude는 설정 기반 라우팅을 통해 다른 에이전트를 다른 모델로 라우팅할 수 있습니다. 이는 [...]

원본 저장소: Gitlawb/openclaude

라이선스: NOASSERTION

게재 제외를 원하시면 삭제 요청을 보내주세요.