이 글의 핵심
- macOS / Linux:공식 권장
curl -fsSL …/install.sh | sh. Node 불필요. 바이너리는~/.local/bin/dao에 설치. - Windows:
npm i -g dao-code(Node ≥ 20)또는 Releases에서dao-windows-x64.exe다운로드. install.sh는 Windows 미지원. - 5분 검수:
dao --version→ 첫dao실행 시 DeepSeek Key 입력 → 프로젝트에서/init으로DAO.md생성. - 선택 기준:국내 직결 + 저비용 종량제면 DAO-Code. Anthropic 생태계와 Opus 모델이면 Claude Code——진입점과 청구가 분수령.
- 장시간 작업:
dao --goal자율 모드는 7×24 호스트용. 노트북 덮개를 닫으면 세션 끊김. 글 하단 클라우드 Mac 운영 참고.
결론 먼저:DAO-Code 설치 문턱은 Claude Code보다 낮다——macOS/Linux는 curl 한 줄, Windows는 npm 또는 exe. 진짜 차이는 「설치 가능 여부」가 아니라 Anthropic 구독료를 낼지, Agent를 7×24 상주시킬지에 있다.
1. 왜 별도의 터미널 Agent 설치 경로가 필요한가
2026년 터미널 AI 코딩 도구는 두 갈래로 나뉜다:폐쇄형 구독(Claude Code, Codex CLI)와 오픈소스 + 모델 자체 선택(DAO-Code, OpenCode, Aider 등). 많은 사람이 「DAO-Code 설치」를 검색하는 이유는 curl을 모르기 때문이 아니라:
- Claude Code는 Anthropic 계정과 Pro 구독이 필요하고, 국내 네트워크에서는 추가 손이 간다;
- GLM Coding Plan 등 국산 플랜은 할당이 빡빡해 CI 머신에서 재현하기 어렵다;
- 팀은 감사 가능한 오픈 Agent와 토큰 종량·국내 직결을 원한다.
DAO-Code(명령어 dao)는 tigicion이 MIT로 공개한 터미널 코딩 Agent. DeepSeek V4(1M 컨텍스트) 대상, 중국어 우선. Claude Code의 settings.json, SKILL.md, hooks.json 형식과 호환. GitHub 800+ Star, v0.3.0부터 멀티플랫폼 바이너리와 npm 패키지 dao-code 제공.
Claude Code Skills/MCP 자산을 이미 쓰고 있다면 DAO-Code 이전 비용은 비교적 낮다——다만 OS마다 설치 경로가 다르다. 이 글에서 한 번에 정리한다.
2. DAO-Code란:설치 전 알아둘 포지셔닝
명령어를 복사하기 전에 DAO-Code가 내 시나리오에 맞는지 확인한다:
| 차원 | DAO-Code | Claude Code | 설명 |
|---|---|---|---|
| 진입 | 터미널 dao | 터미널 claude | 둘 다 TUI. IDE 플러그인 아님 |
| 모델 | DeepSeek V4 Pro/Flash | Claude Opus/Sonnet | DAO는 캐시 히트로 비용 절감 강조 |
| 인증 | DeepSeek API Key(종량) | Anthropic 구독/API | 청구 구조가 완전히 다름 |
| 오픈 | MIT, fork 가능 | 폐쇄 | 엔터프라이즈 컴플라이언스에서 차이 큼 |
| 설정 호환 | CC Skills/Hooks 읽기 | 네이티브 | 이전 마찰 감소 |
DAO-Code는 「싼 Claude 카피」가 아니다——캐시 엔지니어링 + 리플렉션 레이어 fork + 세션 간 메모리 검증이라는 다른 기술 경로. 설치는 첫걸음. 실행 후 /init, /cost, /skills 등 slash 명령을 쓴다. 공식 문서는 GitHub README 중국어판.
3. 3가지 설치 방식 비교(스크립트 / npm / 수동 바이너리)
전편 5축 비교표로 선택을 돕는다:
| 설치 방식 | 대상 플랫폼 | 명령 / 동작 | Node 필요 | 자동 업데이트 | 적합 대상 | |
|---|---|---|---|---|---|---|
| A. 원클릭 스크립트(권장) | macOS, Linux | curl -fsSL …/install.sh \ | sh | 아니오 | 스크립트 재실행 | 대부분 개발자 |
| B. npm 글로벌 | Win / macOS / Linux | npm i -g dao-code | ≥ 20 | npm update -g | Windows 사용자, Node 설치됨 | |
| C. 수동 바이너리 | 전 플랫폼 | Releases에서 asset 다운로드 | 아니오 | 수동 다운로드 | 폐쇄망 오프라인, CI 사전 배치 | |
| D. 소스 빌드 | 개발자 | git clone + npm run build | ≥ 20 | git pull | 기여자, 커스텀 fork | |
| E. npx 체험 | 전 플랫폼 | npx dao-code | ≥ 20 | 매번 최신 pull | 제로 설치 체험 |
모델 성능이 분수령이 아니다. 워크플로 진입점과 청구 모델이——DAO-Code는 DeepSeek 종량, Claude Code는 구독. 설치 전 어떤 돈을 낼지 정한다.
시스템 요구사항(공식)
| OS | 최소 버전 | 아키텍처 | 비고 |
|---|---|---|---|
| macOS | 10.15+ | arm64 / x64 | 스크립트가 자동 xattr 격리 해제 |
| Linux | 주류 glibc 배포판 | arm64 / x64 | Ubuntu 20.04+ 문제없음 |
| Windows | 10 1809+ | x64 | npm 또는 dao-windows-x64.exe |
4. macOS와 Linux:5분 원클릭 설치
4.1 공식 권장 명령
터미널을 연다(macOS는 Terminal / iTerm, Linux는 기본 shell), 실행:
curl -fsSL https://raw.githubusercontent.com/tigicion/dao-code/master/install.sh | sh
스크립트는 다음을 수행한다:
darwin/linux와arm64/x64감지;- GitHub Releases에서
dao-{os}-{arch}다운로드; ~/.local/bin/dao에 설치(DAOINSTALLDIR로 커스텀 가능);- macOS에서
xattr -d com.apple.quarantine로 Gatekeeper 격리 해제.
4.2 PATH 설정(흔한 막힘)
설치 후 dao: command not found면 ~/.local/bin이 PATH에 없다:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc # macOS 기본 zsh
source ~/.zshrc
# Linux bash 사용자는 ~/.bashrc에 추가
검증:
dao --version
which dao
4.3 Apple Silicon과 Intel
아키텍처 수동 선택 불필요——스크립트가 uname -m으로 dao-darwin-arm64 또는 dao-darwin-x64 자동 매칭. M4 Mac mini 클라우드 호스트에도 동일. Agent를 노트북이 아닌 원격 머신에 상주시키기에 적합.
4.4 Linux 배포판 참고
Ubuntu / Debian / Fedora / Arch 등 주류 배포판 OK. Alpine 등 musl 환경에서 동적 링크 문제 시 install.sh를 억지로 돌리지 말고 npm 설치 또는 정적 바이너리 수동 다운로드 우선.
5. Windows:npm과 exe 두 경로
install.sh는 Windows에서 즉시 오류 종료(npm 또는 exe 사용 안내). Windows 사용자를 위한 성숙한 경로는 두 가지:
5.1 경로 1:npm 글로벌(권장)
Node.js ≥ 20 확인:
node --version
DAO-Code 설치:
npm i -g dao-code
명령어도 dao. 검증:
dao --version
제로 설치 체험(글로벌에 쓰지 않음):
npx dao-code
5.2 경로 2:exe 다운로드
- Releases 열기;
dao-windows-x64.exe다운로드;- 고정 디렉터리(예
C:\Tools\dao\)에 두고 시스템 PATH 추가; - 또는 PowerShell에서 전체 경로 실행.
5.3 Windows와 WSL 선택
- 네이티브 Windows:PowerShell + npm 또는 exe. 일상 개발용;
- WSL2:Linux 서브시스템에서 install.sh 실행. macOS/Linux와 동일 경험. WSL을 주력 터미널로 쓰는 개발자용.
Git Bash에서 install.sh 실행은 비권장——공식 호환 보장 없음. PowerShell 또는 WSL이 안정적.
6. 설치 검증과 최초 DeepSeek API 설정
설치 성공 후 임의 프로젝트 디렉터리로:
cd ~/your-project
dao
최초 실행에 API Key가 없으면 DeepSeek API Key 붙여넣기를 안내하고 ~/.dao/config.json에 저장. 비대화형으로도 전달 가능:
dao --api-key sk-xxxxxxxx --provider deepseek "이 프로젝트를 한 문장으로 소개해줘"
6.1 5분 검수 4단계
| 단계 | 명령 | 기대 결과 |
|---|---|---|
| ① 버전 | dao --version | 버전 번호(예 v0.3.x) |
| ② 대화 | dao | Ink TUI 진입, 프롬프트 입력 가능 |
| ③ 프로젝트 컨텍스트 | /init | DAO.md 프로젝트 개요 생성 |
| ④ 비용 가시화 | /cost | 토큰과 캐시 히트율 표시 |
자주 쓰는 slash 명령:/help 목록, /model로 Pro/Flash 전환, /plan 읽기 전용 플랜 모드, /yolo 또는 dao --yolo 자동 승인(신중히).
권한과 보안:파일 쓰기·shell 실행은 기본 승인 게이트 [y] once [a] remember [n] deny. .dao/settings.json에서 allow/ask/deny 규칙 설정 가능. 문법은 Claude Code와 유사.
7. 시나리오 매트릭스:어떤 설치법을 쓸까
| 당신은 | 권장 설치 | 보충 |
|---|---|---|
| macOS 일상 개발 | A 원클릭 스크립트 | 가장 빠름. PATH 확인 |
| Linux 서버 / CI | A 스크립트 또는 C 바이너리 | CI에서 바이너리 artifact 캐시 |
| Windows 10/11 | B npm 글로벌 | Node 20 LTS 먼저 |
| 폐쇄망 오프라인 | C 수동 바이너리 | 해당 arch 사전 다운로드 |
| 그냥 써보기 | E npx dao-code | 글로벌 찌꺼기 안 남김 |
| Claude Code에서 이전 | A/B + .claude 설정 복사 | Skills/Hooks 형식 호환 |
| 7×24 장시간 작업 | 클라우드 Mac/Linux + A + dao --goal | 아래 체크리스트 참고 |
8. 권장 스택(Stack)
개인 개발자(로컬):
install.sh → dao → /init → .dao/settings.json 설정 → 필요 시 MCP
팀 CI(읽기 전용 리뷰):
Releases 바이너리 → DAO_AUTO_APPROVE=1(샌드박스만)→ dao "review diff" 일회성
Claude Code 듀얼 운용:
로컬 claude로 일상 → 클라우드 Mac에서 dao --goal 장작업 / worktree 서브에이전트
멀티 Agent 병렬 레이아웃은 원격 Mac + worktree 단기 임대 참고. MCP 배치 경계는 MCP Server는 어느 머신에 둘까? 참고.
9. 5가지 흔한 오해
- 「Windows에서도 pipe install.sh 가능」 — 스크립트는 Windows 미지원. npm 또는 exe 사용.
- 「설치하면 Claude Code 전부 대체」 — 모델과 생태계가 다름. DAO-Code는 DeepSeek 비용과 캐시가 강점. Opus 래핑이 아님.
- 「npm과 스크립트 이중 설치하면 충돌」 —
dao두 개 공존 가능.which dao로 우선순위 확인, 하나만 남김. - 「YOLO 모드는 프로덕션용」 —
dao --yolo는 승인 스킵. 신뢰 샌드박스만. 프로덕션은 기본 승인 유지. - 「노트북 덮어도 장작업 무관」 —
dao --goal자율 모드는 호스트 온라인 필수. 장시간은 클라우드 Mac 또는 서버. 클라우드 Mac 듀얼 AI 에이전트 아키텍처(DAO-Code에도 동일 적용).
10. 7단계 런칭 체크리스트
- 설치 방식 선택:macOS/Linux → 스크립트;Windows → npm 또는 exe.
- 설치 실행 후
dao --version확인. - PATH 설정(command not found 시).
- DeepSeek API Key 발급(플랫폼 공식 가입·종량).
- 프로젝트 내
dao+/init으로DAO.md생성. - 필요 시 CC 설정 이전:Skills, Hooks, MCP를
.dao/로. - 장작업 검수:
dao --goal "작업 설명"30분 실행 후/cost캐시 히트율 관찰. 7×24 필요 시 클라우드 Mac 일일 PoC.
11. FAQ
Q:DAO-Code와 Claude Code 공존 가능?
가능. 명령이 다름(dao vs claude), 설정 디렉터리도 다름(~/.dao vs ~/.claude). 같은 터미널 세션에서 승인 규칙 혼동 주의.
Q:install.sh 안전한가?
스크립트는 install.sh에 오픈. 습관적으로 curl로 받아 검토 후 실행, 또는 Releases에서 수동 바이너리——엔터프라이즈는 후자 + 해시 검증 권장.
Q:최신 버전 업데이트 방법?
스크립트 설치:install.sh 재실행으로 바이너리 덮어쓰기. npm:npm update -g dao-code. dao --version과 Releases 대조.
Q:소스 설치는 누구용?
Agent 로직 수정·2차 개발 기여자용:
git clone https://github.com/tigicion/dao-code.git && cd dao-code
npm install && npm run build && npm link
12. 요약
DAO-Code 설치는 어렵지 않다:macOS/Linux는 공식 스크립트 한 줄, Windows는 npm 한 줄 또는 exe 하나. 5분 안에 버전 검증과 최초 API 설정까지 가능. 미리 결정할 것:DeepSeek 종량 청구 수용 여부, 기존 Claude Code 자산 호환 필요 여부, Agent를 클라우드 7×24 장작업으로 돌릴지.셋 모두 「예」면 DAO-Code는 2026 터미널 Agent 스택의 주력 또는 보조 호스트로 가치 있다. 설치 후 /init + /cost로 실제 소규모 요구를 돌려보는 것이 리뷰 10편보다 설득력 있다.