펼쳐서 원하는 곳으로 바로 가기
새 노트북/PC를 받으면 개발에 필요한 도구를 하나하나 찾아 깔아야 합니다. 이 키트는 그걸 명령어 한 줄로 대신 해줍니다. 붙여넣고 Enter만 누르면:
- 자주 쓰는 CLI 도구(git, ripgrep, fzf, bat 등)
- 프로그래밍 런타임(Node.js, Python, Go, Rust)
- 예쁜 터미널/프롬프트(starship) + 자동완성
- 컨테이너(Docker) 준비
- AI 코딩 에이전트(Claude Code, gajae-code, codex 등)
까지 알아서 깔고, 제대로 깔렸는지 검증까지 합니다.
안심하세요. 이 키트는 당신 설정을 함부로 덮어쓰지 않습니다. 이미 있는 건 건너뛰고, 몇 번을 다시 돌려도 안전하며, 설치한 걸 되돌리는 제거 스크립트도 있습니다. 자세한 안전 설계는 아래 설치해도 안전한가요? 참고.
인터넷의 dotfiles·gist 스크립트는 대개 만든 사람 취향이고, 실행하면 내 컴퓨터에 뭘 바꾸는지 알기 어렵습니다. 이 킷은 세 가지가 다릅니다.
- 초보자 기준으로 썼습니다. 터미널을 처음 여는 사람도 그대로 따라 하도록 OS별 단계를 하나하나 적었어요.
- 안전을 설계로 증명합니다. 기존 설정을 덮어쓰지 않고(표시된 블록만 편집·자동 백업), 몇 번을 다시 돌려도 안전하며, 되돌리는 제거 스크립트가 있습니다.
- 말이 아니라 CI로 검증합니다. macOS·Windows·Ubuntu·Fedora·Arch·openSUSE에서 커밋마다 설치→검증→제거를 자동 테스트해요(2회 연속 설치·업그레이드 경로 포함).
실행이 걱정되면 언제든 먼저
--dry-run(맥/리눅스)·-DryRun(윈도우)으로 "무엇을 할지"만 볼 수 있어요.
| 내 컴퓨터 | 여기로 |
|---|---|
 Windows (회사 PC 대부분) |
→ Windows 설치 |
 Mac (맥북 등) |
→ macOS 설치 |
 Linux (우분투/페도라 등) |
→ Linux 설치 |
각 가이드는 터미널을 처음 여는 분 기준으로 썼어요. 그대로 따라만 하면 됩니다.
터미널이 이미 익숙하다면? 한 줄 복붙 모음 (클릭)
# macOS
curl -fsSL https://raw.githubusercontent.com/Heoooooon/lazy-starter-kit/main/install.sh | bash
# Linux (Ubuntu/Fedora/Arch/openSUSE — 자동 감지)
curl -fsSL https://raw.githubusercontent.com/Heoooooon/lazy-starter-kit/main/linux/install.sh | bash# Windows (PowerShell)
irm https://raw.githubusercontent.com/Heoooooon/lazy-starter-kit/main/windows/install.ps1 | iex실행 전 계획만 보려면 clone 후 --dry-run, 회사 PC는 --profile work,
상세 옵션은 고급 / 커스터마이즈.
각 OS는 폴더로 분리돼 있어요: windows/ · linux/ · macOS(최상위).
대상: Windows 10(1809 이상) 또는 Windows 11. 대부분의 회사 PC가 여기 해당합니다. 개발 경험이 전혀 없어도 아래만 그대로 따라 하면 됩니다.
- 키보드에서
Windows 키를 누르거나 화면 왼쪽 아래 시작 버튼을 클릭합니다. - 그대로
powershell이라고 타이핑합니다. - 목록에 뜨는 "Windows PowerShell" 을 클릭해서 엽니다. (파란색 또는 검은색 창이 떠요.)
더 좋은 경험을 원하면 "터미널"(Windows Terminal)에서 PowerShell을 열어도 됩니다. 없으면 그냥 Windows PowerShell로 충분해요.
아래 회색 상자 오른쪽 위의 복사 버튼(📋)을 누르세요. 그리고 PowerShell 창을 한 번 클릭한 뒤 마우스 오른쪽 버튼을 누르면 붙여넣기가 됩니다. 마지막으로 Enter.
irm https://raw.githubusercontent.com/Heoooooon/lazy-starter-kit/main/windows/install.ps1 | iexgit이 없어도 자동으로 깔아줍니다. (그냥 기다리면 돼요.)- 중간에 설치 진행 상황이 주르륵 올라갑니다. 컴퓨터/인터넷 속도에 따라 5~20분 걸릴 수 있어요. 창을 닫지 말고 기다리세요.
- 도중에 "Docker Desktop을 설치할까요?" 같은 질문이 뜨면 필요 없으면 그냥
n입력 후 Enter (회사 라이선스 이슈가 있어 기본은 설치 안 함). 뭔지 모르겠으면 전부 그냥 Enter — 안전한 기본값으로 진행됩니다.
"스크립트를 실행할 수 없습니다" 같은 빨간 오류가 뜨면? (클릭)
Windows 보안 정책 때문일 수 있어요. 아래 한 줄로 대신 실행하세요(복붙 → Enter):
powershell -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/Heoooooon/lazy-starter-kit/main/windows/install.ps1 | iex"설치가 끝나면 화면 맨 아래에 "Next steps" 안내가 나옵니다. 그대로 하면 돼요:
- PowerShell 창을 완전히 닫고 새로 여세요. (그래야 새 설정이 적용돼요.)
- 글꼴 설정 — 프롬프트 아이콘이 예쁘게 보이려면:
Windows Terminal → 설정(Settings) → 사용하는 프로필 → 모양(Appearance) →
글꼴(Font face) 을
JetBrainsMono Nerd Font로 바꾸세요. - GitHub 로그인(선택) — 화면에
gh auth login안내가 나오면 한 번 실행해서 GitHub 계정에 로그인하세요. (git 이름/이메일도 자동으로 맞춰줍니다.)
자동완성 써보기: 새 창에서 명령어를 치기 시작하면 회색 글씨로 뒷부분을 미리 제안해줍니다. 마음에 들면 오른쪽 화살표(→) 를 눌러 그대로 채워요. (zsh의 autosuggestions 같은 기능이에요.) 안 뜨면 PowerShell 7을 쓰는 게 확실합니다:
winget install Microsoft.PowerShell후 재시작.
| 증상 | 해결 |
|---|---|
winget을 찾을 수 없다 |
Microsoft Store에서 "앱 설치 관리자(App Installer)" 설치 후 다시 실행 |
| 일부 도구가 "MISS"로 빠짐 | 관리자 권한(UAC) 이 필요한 패키지예요. 관리자 PowerShell에서 .\install.ps1 -Only packages 재실행하거나 사내 소프트웨어 포털 이용 |
| 회사 프록시 뒤라 다운로드 실패 | PowerShell에서 $env:HTTPS_PROXY="http://프록시주소:포트" 설정 후 재실행 |
| 회사 정책(AppLocker 등)으로 스크립트 자체 차단 | 정책상 실행 불가 — IT 담당자 문의 |
💡 회사 PC라면 처음부터 가볍게 깔 수도 있어요:
.\install.ps1 -Profile work(Docker 등 무거운 것 제외). 리눅스 환경(WSL2)까지 원하면.\install.ps1 -Only wsl(베타).
📖 Windows 상세 문서: windows/README.md
대상: Apple Silicon 맥(M1/M2/M3/M4…). 새 맥에 최적화돼 있어요.
Command(⌘) + Space → 터미널 또는 Terminal 입력 → Enter.
curl -fsSL https://raw.githubusercontent.com/Heoooooon/lazy-starter-kit/main/install.sh | bashgit이 없는 완전 새 맥이면 먼저 Xcode Command Line Tools 설치 창이 뜹니다. "설치" 를 누르고, 끝나면 위 명령어를 한 번 더 실행하세요.- 중간에 Mac 비밀번호를 한 번 물을 수 있어요(Homebrew 설치 시). 정상입니다.
- 새 터미널을 열거나
source ~/.zshrc실행. - 안내에 따라
gh auth login(GitHub 로그인), 터미널 글꼴을JetBrainsMono Nerd Font로 설정.
실행 전에 무엇을 하는지 먼저 보고 싶다면(권장):
git clone https://github.com/Heoooooon/lazy-starter-kit.git cd lazy-starter-kit ./install.sh --dry-run # 아무것도 안 바꾸고 계획만 출력 ./install.sh # 실제 적용
지원: Debian/Ubuntu, Fedora/RHEL, Arch, openSUSE (glibc 배포판). 패키지 매니저를 자동 감지합니다.
⚠️ Alpine(musl)은 미지원 — 업스트림 도구(node/ast-grep/bun)에 musl 빌드가 없어요.
curl -fsSL https://raw.githubusercontent.com/Heoooooon/lazy-starter-kit/main/linux/install.sh | bash- 시스템 패키지 설치에 sudo(관리자) 비밀번호를 물을 수 있어요. (sudo가 없으면 시스템 패키지만 건너뛰고 유저 도구는 정상 설치됩니다.)
- Docker는 물어볼 때 동의해야만 설치됩니다(무거워서 기본은 건너뜀).
- 새 터미널을 열거나
source ~/.zshrc. - Docker를 깔았다면 로그아웃 후 다시 로그인(또는
newgrp docker)해야 권한이 적용돼요.
📖 Linux 상세 문서: linux/README.md
이 키트는 한 번 쓰고 버리는 스크립트가 아니에요. 계속 곁에 두고 쓰세요.
(윈도우는 --flag 대신 -Flag 형태)
- 뭔가 안 될 때 →
./install.sh --doctor어떤 도구가 잘 깔렸는지(✓), 빠졌는지(✗), 깔렸는데 터미널이 못 찾는 건지(!)를 한눈에 보여주고 고치는 명령까지 알려줍니다. - 새 버전이 나왔을 때 →
./install.sh --update키트 최신 버전을 받아온 뒤 알아서 다시 실행해요. - 다시 실행하고 싶을 때 → 그냥
./install.sh이미 된 건 건너뛰고 빠진 것만 채웁니다. 몇 번을 돌려도 안전해요. - 골라 깔고 싶을 때 →
--profile minimal(도구+런타임+셸만) /--profile work(회사 PC용) /--only agents(특정 단계만)
이름이 낯설어도 괜찮아요 — 전부 전 세계 개발자들이 매일 쓰는 검증된 도구들입니다.
| 계층 | 도구 |
|---|---|
| CLI 기본 | git, gh(GitHub CLI), jq, ripgrep(rg), fd, fzf, bat, tree, ast-grep |
| 셸/프롬프트 | zsh + oh-my-zsh + 자동완성·구문강조, starship 프롬프트, JetBrainsMono Nerd Font (Windows는 PowerShell 프로필 + PSReadLine 자동완성) |
| 런타임 | mise → Node(LTS)·Python·Go · rustup → Rust + rust-analyzer · uv · bun |
| 컨테이너 | macOS=Colima, Linux=Docker Engine(선택), Windows=Docker Desktop(선택·라이선스 주의) 또는 WSL2 |
| Git/GitHub | 계정 신원(이메일), HTTPS 자격증명, 합리적 기본값 |
| AI 에이전트 | Claude Code(claude), gajae-code(gjc), codex, lazycodex(OmO) (+ macOS/Linux는 Hermes) |
| WSL2 (Windows, 베타) | WSL2 + Ubuntu 활성화 후 그 안에 Linux 킷 자동 설치 (-Only wsl) |
세부 목록·OS별 차이는 각 OS 상세 문서에 있어요.
이 킷은 AI 코딩 에이전트를 깔아줍니다. 하지만 에이전트의 진짜 힘은 거기에 붙여 쓰는 스킬·MCP·플러그인에서 나와요. 뭘 붙일지 고르는 것도 또 다른 삽질이라, 따로 큐레이션해 뒀습니다.
→ cmore.dev 도구 생태계 분야별(문서·행정·법률·게임·디자인·코딩 에이전트 등) 도구를, 직접 써보고 쓴 에디터 리뷰 + 솔직한 한계와 함께 모았습니다(대부분 오픈소스, 일부는 무료로 쓰는 공식 도구). 설치 명령까지 바로 복사할 수 있어요.
킷이 기본으로 깔아주는 에이전트는 이렇습니다:
| 에이전트 | 한 줄 소개 |
|---|---|
Claude Code (claude) |
내 프로젝트 안에서 직접 코드를 읽고 고치는 Anthropic 에이전트 |
Codex (codex) |
터미널에서 도는 OpenAI 코딩 에이전트 |
gajae-code (gjc) |
인터뷰·검토된 계획·검증까지 갖춘 자율 코딩 러너 |
| lazycodex (OmO) | 복잡한 코드베이스를 위한 Codex 하네스 |
| Hermes (macOS·Linux) | 경험에서 스킬을 만들고 세션 너머로 나를 학습하는 자율 에이전트 |
에이전트 이름을 누르면 각 도구의 자세한 에디터 리뷰·설치법으로 바로 갑니다.
네. 안전을 최우선으로 설계했고, 말로만이 아니라 테스트로 증명합니다.
- 덮어쓰지 않음: 이미 깔린 도구/설정은 건너뜁니다. 당신이 만든 파일은 보존돼요.
- 몇 번을 다시 돌려도 안전: CI가 매 커밋 두 번 연속 설치해서 확인합니다(멱등).
- 표시된 블록만 편집: 설정 파일(
~/.zshrc, PowerShell 프로필 등)에는# >>> lazy-starter-kit ... >>>로 명확히 표시된 구역만 넣고, 재실행 시 그 구역만 교체합니다(중복 없음). 손으로 쓴 줄은 안 건드려요. 처음 고치기 전엔 자동 백업(.bak)을 만들고, 마커가 손상돼 있으면 수정을 거부합니다. - git 신원 보호: 이름/이메일이 비어 있을 때만 채우고, 있으면 절대 안 바꿉니다.
- 데이터 삭제 없음: 설치 과정에서 당신 데이터를 지우지 않습니다.
- 되돌리기 제공: 아래 제거로 깔끔히 원복.
- 공급망(supply chain) 정직 고지: 이 키트는 Homebrew·oh-my-zsh·Docker·Hermes 등 업스트림 프로젝트의 공식 설치 스크립트를 HTTPS로 내려받아 실행하고, npm/bun 패키지는 최신 버전으로 설치합니다. 즉 그 업스트림들을 신뢰하는 셈이니, 걱정되면 각 프로젝트를 먼저 확인하세요. 보안 범위·신고는 SECURITY.md 참고.
정말 걱정되면 먼저
--dry-run(맥/리눅스) 또는-DryRun(윈도우) 으로 "무엇을 할지"만 확인하세요. 남의/회사 메인 PC라면 여분 PC나 가상머신(VM)에서 먼저 테스트하는 걸 권합니다.
검증: macOS·Windows(Server 2025)·Ubuntu·Fedora·openSUSE·Arch 모두 커밋마다 설치→검증→제거(end-to-end)를 자동 테스트(CI)로 돌립니다. 두 번 연속 설치(멱등성)와 이전 릴리스→최신 업그레이드 경로도 테스트에 포함돼요.
| 등급 | 플랫폼 | 보증 |
|---|---|---|
| Tier 1 | macOS 14+ (Apple Silicon) · Windows 11/Server 2025 · Ubuntu 24.04 · Fedora · Arch · openSUSE Tumbleweed | 매 커밋마다 CI가 실제로 설치→검증→제거 (+ 2회 연속 설치, 업그레이드 경로) |
| Tier 2 | Windows 10 1809+ · Debian 12+ · RHEL 9/Rocky · openSUSE Leap · WSL2 · Intel Mac | 같은 코드라 동작 예상 — 문제 제보 시 우선 수정 |
| 미지원 | Alpine(musl) · 32bit | 업스트림 도구에 빌드가 없음 |
자세한 정책(무엇이 semver로 보호되는지)은 VERSIONING.md 참고.
이 키트가 세팅 시간을 아껴줬다면 ⭐ 스타 하나가 다음 개선의 큰 힘이 됩니다!
설치한 것을 의존성 역순으로 되돌립니다. (위험한 항목은 물어보고 진행)
macOS
cd lazy-starter-kit && ./uninstall.sh # 물어보며 제거
./uninstall.sh --yes # 다 자동 수락Linux
cd lazy-starter-kit/linux && ./uninstall.shWindows (PowerShell)
cd lazy-starter-kit\windows; .\uninstall.ps1- git 신원, git 자체, 폰트, Homebrew/빌드도구는 자동으로 안 지웁니다.
- gajae-code(
gjc)는 보존 — 지우려면--with-gajae(맥/리눅스) /-WithGajae(윈도우).
Q. 이미 Node/Python이 깔려 있어요. 충돌 안 나요?
지우지 않습니다. mise가 자기 버전을 깔고 PATH로 우선시켜요(shadow). 기존 것은 그대로 남습니다.
확인: 맥/리눅스 which -a node, 윈도우 Get-Command node -All.
Q. 설치가 중간에 실패했어요.
대부분 네트워크/권한 문제예요. 다시 실행해도 안전합니다(이미 된 건 건너뜀).
뭐가 빠졌는지는 --doctor로 확인하고, 특정 단계만 다시는 --only <단계>(맥/리눅스), -Only <단계>(윈도우).
Q. 관리자 권한이 없어요(회사 PC). Windows는 가능한 건 사용자 범위로 설치하고, 관리자가 필요한 것만 끝에 목록으로 알려줍니다. Linux는 sudo가 없으면 시스템 패키지는 건너뛰고 사용자 도구는 정상 설치돼요.
Q. 특정 버전으로 고정해서 설치하려면?
STARTER_KIT_BRANCH=v0.7.0 bash -c "$(curl -fsSL https://raw.githubusercontent.com/Heoooooon/lazy-starter-kit/v0.7.0/install.sh)"- 모든 플래그:
--dry-run,--yes,--only,--skip,--profile,--doctor,--update,--list,--version(윈도우는-Only처럼 대시 하나). - 설치 도구 편집: 각 OS의
Brewfile(맥) /scripts/02-packages.*/scripts/03-runtimes.*. - 프롬프트/셸 블록:
config/starship.toml,config/zshrc.block.sh(맥/리눅스),config/profile.block.ps1(윈도우). - 자세한 옵션·문제해결은 각 OS 상세 문서를 보세요.
이 키트는 훌륭한 오픈소스들을 엮은 것뿐입니다. 원작 프로젝트에 ⭐를 눌러주세요: Homebrew · mise · starship · rustup · bun · uv · Oh My Zsh · ripgrep · fd · bat · fzf · ast-grep · Colima · Claude Code · gajae-code · Codex · lazycodex / OmO · Hermes Agent
MIT — LICENSE 참고.