DAO-Code 설치 튜토리얼: 5분 만에 macOS 실행하기 (2026)

처음 맥에서 DAO-Code를 실행하는 개발자를 위한 시간순 설치 안내입니다. 공식 설치 스크립트와 npx, 소스 설치의 차이를 비교하고, 딥시크 API 연결과 첫 작업 검증까지 설명합니다.

판정: 처음 설치한다면 공식 설치 스크립트로 원생 바이너리를 설치하는 편이 가장 적합합니다. 잠깐 체험할 때는 npx, DAO-Code 코드를 수정할 때는 소스 설치로 바꾸면 됩니다. DAO-Code 자체에는 도커, 엑스코드, 메탈 기반의 로컬 모델 환경이 필요하지 않습니다.

이 글은 처음 맥에서 DAO-Code를 설치하는 개발자를 위한 안내입니다. 깨끗한 맥에서 에이전트 환경을 재현하려는 테스트 담당자, 아이폰이나 맥 프로젝트를 원격 환경에서 다루려는 개발자도 대상입니다.

최종 업데이트: 2026년 9월 3일. 공식 저장소, 설치 스크립트, 릴리스 자산, 개발 브랜치의 패키지 정보, 딥시크 API 문서를 기준으로 확인했습니다.

설치 경로 선택

DAO-Code 공식 README에는 원생 바이너리, npx, npm, 소스 설치 경로가 함께 안내되어 있습니다. 처음 실행하는 경우에는 설치 스크립트가 가장 짧습니다. 릴리스 페이지에서는 정식 릴리스와 운영체제별 실행 자산을 확인할 수 있습니다. 공식 README의 설치 안내와 공식 릴리스 목록을 먼저 열어 두십시오.

• 원생 바이너리: 반복해서 사용할 개발자에게 적합합니다. 공식 스크립트가 설치 과정을 처리합니다.
• npx: 설치 흔적을 줄이고 짧게 시험할 때 적합합니다. 지속적인 개발 환경으로 쓰기에는 매번 실행 조건을 확인해야 합니다.
• 소스 설치: DAO-Code 자체를 수정하거나 개발 브랜치를 확인할 때만 선택합니다. 정식 릴리스와 동작이 다를 수 있습니다.

버전 표기는 특히 조심해야 합니다. 릴리스 페이지는 v0.4.7을 최신 정식 릴리스로 표시하지만, master의 package.json에는 0.4.17이 보입니다. 두 값을 같은 안정 버전으로 설명하면 안 됩니다. master의 패키지 정보를 기준으로 개발 브랜치 여부를 따로 기록하십시오.

설치 경로 결정 체크리스트

아래 조건에서 하나만 선택하면 됩니다. 여러 항목에 해당하면 위에서 아래 순서로 우선순위를 적용하십시오.

• [ ] 오늘 바로 반복 사용해야 합니다 → 공식 설치 스크립트로 원생 바이너리를 설치합니다. 실행 파일이 고정되어 PATH와 버전을 관리하기 쉽습니다.
• [ ] 기능을 잠깐 확인하고 삭제할 예정입니다 → npx를 사용합니다. 별도 설치를 줄일 수 있지만, 실행할 때마다 패키지와 환경을 다시 확인합니다.
• [ ] DAO-Code의 소스나 설치 동작을 수정해야 합니다 → 소스 설치를 선택합니다. 정식 릴리스가 아니라 개발 브랜치 상태일 수 있으므로 버전을 별도로 기록합니다.
• [ ] 도커, 엑스코드, 로컬 모델 환경을 추가해야 하는지 고민 중입니다 → DAO-Code만 실행할 목적이면 설치하지 않습니다. 공식 문서에 없는 필수 조건은 다른 도구의 요구 사항과 구분합니다.
• [ ] 아이폰 또는 맥 앱을 빌드해야 합니다 → DAO-Code와 별도로 엑스코드 기반 개발 환경을 준비합니다.
• [ ] 현재 맥을 계속 켜 둘 수 없습니다 → 먼저 로컬에서 최소 검증을 끝낸 뒤 같은 폴더와 승인 절차를 원격 맥에서 재현합니다.

따라서 첫 설치자의 기본 선택은 원생 바이너리입니다. 임시 사용이면 npx로 되돌리고, 코드 수정이 필요해지는 순간에만 소스 설치로 이동하면 됩니다.

설치 전 맥 상태 확인

먼저 터미널을 열고 아래 명령을 순서대로 실행합니다.

sw_vers
echo "$SHELL"
uname -m
printf '%s\n' "$PATH"
node --version

uname -m 결과가 arm64이면 애플 실리콘 맥입니다. x86_64이면 인텔 맥입니다. 애플은 유니버설 맥 바이너리 문서에서 애플 실리콘용 아키텍처를 arm64로 설명합니다. 애플의 맥 바이너리 아키텍처 문서와 릴리스 자산 이름을 대조하면 잘못된 파일을 고르는 실수를 줄일 수 있습니다.

Node.js가 없거나 프로젝트가 요구하는 버전보다 낮으면 Node.js 공식 다운로드 페이지에서 설치한 뒤 새 터미널을 열어 다시 확인합니다. node --version의 결과만 보고 정식 릴리스와 개발 브랜치의 호환성을 단정하지는 마십시오. README의 현재 요구 조건을 우선합니다.

이 단계에서 PATH가 비어 있거나 오래된 경로를 가리키면 설치가 끝나도 dao: command not found가 발생합니다. 설치 전 결과를 기록해 두면 설치 후 문제와 기존 셸 설정 문제를 구분하기 쉽습니다.

공식 스크립트 실행 순서

공식 install.sh를 이용하더라도 원격 스크립트를 무조건 신뢰해서는 안 됩니다. 먼저 내용을 저장하고 읽은 뒤 실행합니다. 아래 주소는 공식 저장소의 설치 스크립트입니다.

curl -fsSL https://raw.githubusercontent.com/tigicion/dao-code/master/install.sh -o install.sh
sed -n '1,240p' install.sh
chmod +x install.sh
xattr -d com.apple.quarantine install.sh 2>/dev/null || true
./install.sh

sed 출력에서 다운로드 주소, 설치 디렉터리, 셸 설정 파일 변경 여부를 확인합니다. 확인하지 않고 파이프로 바로 실행하는 방식은 설치가 빠르더라도 무엇이 바뀌는지 알 수 없습니다. 공식 install.sh 원문과 실제 터미널 출력을 비교하십시오.

설치가 끝나면 새 터미널을 열고 다음을 실행합니다.

command -v dao
dao --version

command -v가 경로를 출력하지 않으면 설치 실패로 단정하지 말고 현재 셸의 PATH를 먼저 확인합니다. 설치 스크립트가 특정 셸 설정 파일에 경로를 추가했을 수 있습니다. 새 셸에서도 같은 현상이면 스크립트가 사용한 설치 위치를 확인한 뒤 공식 README의 PATH 안내를 적용합니다.

잠깐 실행만 하려면 공식 안내에 있는 npx 경로를 사용합니다.

npx dao-code

패키지 이름과 실행 방식은 저장소의 현재 README를 기준으로 확인해야 합니다. 명령 이름을 임의로 바꾸거나 검색 결과의 오래된 예제를 섞지 않는 것이 안전합니다.

첫 실행과 딥시크 API 연결

dao가 실행되면 초기 안내에 따라 딥시크 API 키를 입력합니다. API 키는 딥시크 공식 키 관리 화면에서 발급합니다. 키를 셸 기록, 공개 저장소, 이슈, 화면 캡처에 남기지 마십시오. API 인증 방식과 요청 형식은 딥시크 공식 API 문서를 기준으로 확인합니다.

DAO-Code는 공식 설명상 딥시크 V4를 대상으로 하는 다중 플랫폼 터미널 코딩 에이전트입니다. 이를 웹3 스마트 계약 도구로 설명하거나, 로컬 메탈 추론이 필수라고 설명할 공식 근거는 확인되지 않았습니다. 도커와 엑스코드도 DAO-Code의 필수 설치 항목이 아닙니다.

첫 실행 때 표시되는 설정 파일 경로와 저장 완료 메시지는 별도로 기록합니다. 버전에 따라 경로와 초기 설정 화면이 달라질 수 있으므로 문서에 고정 경로를 복사해 넣지 말고, 실행 화면과 현재 README를 함께 확인해야 합니다. 모델 이름도 예시 화면을 그대로 복제하지 말고 당일 공식 문서에 표시된 이름을 사용합니다.

첫 작업 검증 순서

설치 성공은 명령이 실행되는 것만으로 판단하지 않습니다. 다음 조건을 순서대로 확인합니다.

• 조건 1 — 읽기 전용 작업: 별도 테스트 폴더를 만들고 파일 목록이나 구조만 분석하게 합니다. 파일 생성과 수정이 일어나지 않는지 확인합니다.
• 조건 2 — 설명 생성: 작은 프로젝트를 대상으로 README 초안이나 폴더별 설명을 요청합니다. 출력 대상 폴더가 예상한 위치인지 확인합니다.
• 조건 3 — 제한된 명령 실행: 개발 서버 확인처럼 영향이 작은 명령만 요청합니다. 승인 화면 없이 명령이 실행되면 중단하고 권한 설정을 다시 확인합니다.
• 조건 4 — 기록 보존: DAO-Code 버전, 맥 아키텍처, 대상 디렉터리, 권한 요청, 승인 결과, 출력 내용을 기록합니다.

읽기 전용 작업은 통과했지만 승인 흐름이 없거나 대상 폴더가 다르면 설치 완료가 아닙니다. 반대로 API 응답은 정상이고 명령 승인만 실패한다면 설치보다 권한 또는 셸 설정을 먼저 점검해야 합니다.

상황별 개발 환경

장시간 아이폰 프로젝트를 다룰 계획이라면 원격 맥 개발 환경의 기본 조건을 먼저 비교해 보십시오. 한국에서 접속하는 팀은 한국 리전 클라우드 맥 대여 안내에서 접속 방식과 운영 조건을 확인할 수 있습니다.

DAO-Code만 시험하는 경우에는 현재 맥에서 설치와 최소 작업 검증을 끝내면 충분합니다. 반면 아이폰이나 맥 프로젝트를 빌드하거나, 에이전트를 장시간 실행하거나, 여러 저장소를 계속 전환하는 경우에는 별도 개발 환경이 필요합니다.

로컬 방식은 파일 접근이 빠르고 네트워크 지연이 없습니다. 대신 맥의 메모리와 저장 공간을 계속 점유하며, 장시간 온라인 상태와 운영체제 업데이트를 직접 관리해야 합니다. 원격 맥은 접속 지연과 네트워크 의존성이 생기지만, 환경을 초기화하고 같은 설치 절차를 다시 재현하기 쉽습니다.

자주 발생하는 오류 정리

command not found는 설치 파일보다 PATH 문제일 가능성이 큽니다. 새 터미널에서 command -v dao를 다시 실행하고, 설치 스크립트가 수정한 셸 설정을 확인합니다.

권한 오류가 발생하면 chmod +x install.sh가 적용되었는지 확인합니다. 격리 속성 때문에 실행이 막힌 경우에는 스크립트 내용을 다시 검토한 뒤 xattr 처리를 적용합니다. 검토 없이 보안 경고를 반복해서 무시하지 않습니다.

Node.js 버전 오류는 시스템에 여러 Node.js가 설치된 상황에서 자주 생깁니다. which node, node --version, echo "$PATH"를 함께 기록하고, README의 요구 버전과 비교합니다. 시스템 Node.js와 셸이 참조하는 Node.js가 다르면 새 터미널에서 다시 확인합니다.

설정은 끝났지만 승인 없이 명령이 실행되거나 예상하지 않은 폴더가 변경되면 사용을 중단합니다. 테스트 폴더를 새로 만들고 읽기 전용 작업부터 다시 시작하십시오. API 키가 셸 기록에 남았다면 즉시 폐기하고 새 키를 발급하는 편이 안전합니다.

완료한 환경을 장기간 유지해야 하는데 현재 맥의 메모리와 저장 공간이 부족하면, 로컬 설치를 반복하기보다 원격 맥에서 동일한 승인 테스트를 재현하는 편이 낫습니다. 단기 테스트나 임시 개발이라면 ZekVPS의 맥 환경을 비교해 보고, 물리 장치 연결이나 장기 고정 부하가 필요하면 직접 보유하는 방식이 더 적합합니다.

설치 직후에는 dao --version, 맥 아키텍처, 설정 파일 위치, 첫 작업 결과를 한곳에 기록해 두십시오. 이후 릴리스 자산이나 설치 스크립트가 바뀌면 같은 검증 순서를 다시 실행해야 합니다.