███╗ ███╗██╗███╗ ██╗██╗ ██████╗██╗ █████╗ ██╗ ██╗██████╗ ███████╗
████╗ ████║██║████╗ ██║██║ ██╔════╝██║ ██╔══██╗██║ ██║██╔══██╗██╔════╝
██╔████╔██║██║██╔██╗ ██║██║ ██║ ██║ ███████║██║ ██║██║ ██║█████╗
...
中文 | English
원본 Claude Code에서 92,000행의 클라우드 서비스/텔레메트리(Telemetry)/협업 코드를 제거하여 탄생한 것이 MiniClaude입니다.
경량화— 100% 핵심 개발 기능은 유지하고, 모든 클라우드 서비스 의존성을 제거함
안전— 텔레메트리(Telemetry), 추적, 동기화가 없으며 코드는 완전히 로컬에서 처리됨
빠름— 단일 바이너리 파일로, bun run build && ./cli 명령만으로 즉시 실행 가능
완전함— AI 대화, 코드 생성, 파일 조작, Git, MCP, 플러그인, 스킬 시스템 지원
git clone https://github.com/txl16095/MiniClaude.git && cd MiniClaude
bun install
bun run build
MiniClaude는 Claude Code의 설정 체계와 완전히 호환되며, ~/.claude/settings.json에서 집중적으로 관리하는 것을 권장합니다.
| 설정 방식 | 경로 | 적용 시나리오 |
|---|
| settings.json (권장) | ~/.claude/settings.json | 전역 설정, 여러 Provider 간의 핫 스위칭 (Hot Switching) |
| .env | 프로젝트 루트 디렉토리의 .env | 개발 디버깅, 임시 덮어쓰기 |
권장: settings.json
템플릿을 복사하여 편집하세요:
cp settings.example.json ~/.claude/settings.json
# Linux/macOS: ~/.claude/settings.json
# Windows: C:\Users\<사용자명>\.claude\settings.json
최소 설정 (DeepSeek 예시):
{
"env": {
"ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
...
상세 템플릿은 settings.example.json을 참조하세요. 여러 Provider, MCP, 플러그인, 권한 등을 포함한 완전한 설정을 제공합니다.
대안: .env (개발 모드)
# .env.example을 복사하고 키를 입력하세요
cp .env.example .env
bun run dev
...
Windows 사용자는 start.bat를 더블 클릭하여 개발 모드를 바로 실행할 수 있습니다.
/provider # 사용 가능한 Provider 확인
/provider deepseek # DeepSeek으로 전환 (전역 적용, 모든 창에 적용)
/provider kiro --session # 현재 창에서만 전환, 다른 세션(Session)에 영향을 주지 않음
Provider 설정 또한 settings.json의 providers 블록에 작성되므로, 재시작 없이 전환할 수 있습니다.
| 카테리 | 기능 |
|---|
| AI 능력 | 지능형 대화 · 코드 생성 · 프로젝트 이해 · 멀티 모델 · 멀티 Provider 핫 스위칭 |
| ... | |
| Claude Code | MiniClaude |
|---|
| 핵심 개발 기능 | ✓ |
| ... | |
제거된 모듈 상세 (클릭하여 확장)
클라우드 서비스 (7K 행) — OAuth, 텔레메트리 (Telemetry), 설정 동기화, 정책 제한
협업 (24K 행) — 팀 협업, 브리지 모드 (Bridge Mode), 원격 제어
속도 제한 (48K 행) — 속도 제한 시스템, 사용량 분석, 파일 클라우드 저장소
실험/통합 (5K 행) — 음성, 데스크톱, Teleport, 자동 업데이트
명령어 간소화 — 42개의 권한/실험/내부 명령어 제거
전체 사용 가이드는 공식 문서를 방문해 주세요:
| 분류 | 내용 |
|---|
| 빠른 시작 | 설치 및 실행, 환경 변수, 제3자 모델, 전역 사용, FAQ |
| ... | |
git checkout -b feat/amazing-feature
git commit -m 'feat: add amazing feature'
git push origin feat/amazing-feature
...
MIT License © 2026 txl16095
free-code를 기반으로 개조됨 · 원본 코드의 저작권은 Anthropic PBC에 있습니다.
⚠ 본 프로젝트는 Anthropic의 공식 프로젝트가 아니며, 오직 학습 및 연구 목적으로만 사용됩니다.