Mac을 준비하고 AI 팀을 연결한 뒤, 실행 범위를 직접 승인합니다. 기기 연결부터 실행 기록과 고급 기능까지 차근차근 안내합니다.
macOS 15 이상 · Apple Silicon 또는 Intel Mac
동반 앱의 설치 안내 또는 App Store 설명의 “연결 및 설치 안내”에서 완주단 Mac을 받습니다. DMG 안의 WanjuCrew.app을 응용 프로그램 폴더로 옮겨 실행하세요.
작업은 Mac에서, 확인과 승인은 어디서든.
완주단 Mac을 설치하고 실행한 뒤, 주소와 연결 코드로 연결합니다.
Mac 터미널에서 Codex CLI에 ChatGPT 계정으로 로그인해 둡니다. 완주단의 “AI 팀”에서 설치·로그인·모델 상태를 다시 확인하세요.
설치 여부, 로그인, 모델 응답은 서로 다른 상태로 확인합니다.
“홈”의 “새 작업”에 원하는 결과를 구체적으로 적습니다. “작업 폴더”의 “선택”으로 실제 작업할 폴더를 지정한 뒤 요청하세요.
원하는 결과를 알려주세요. AI 팀이 계획하고, 만들고, 확인합니다.
AI 팀 구성을 확인하고 승인하면 실행됩니다.
승인 카드의 위험 수준·이유·역할별 AI·모델·전송 대상을 읽습니다. 원하는 범위가 맞으면 실행을 승인하고, 다르면 거절하세요.
구독 CLI가 지정한 작업 폴더에서 파일을 읽고 구현합니다. 요청·관련 파일·앞 단계 결과가 선택한 AI 제공자에게 전송될 수 있습니다.
전송 대상: Anthropic (Claude), OpenAI (Codex), Anysphere (Cursor). 각 제공자의 계정·보관 정책이 적용됩니다.
“작업”에서 해당 작업을 열어 진행률·“역할 배치”·“실행 기록”을 읽습니다. 필요하면 “작업 중단”을 누르세요.
진행 중 · 예시 화면
iOS·iPadOS 18 이상 · watchOS 11 이상
App Store에서 완주단: 나의 AI 팀을 받습니다. 연결 전에는 예시 데이터를 살펴볼 수 있습니다.
실행 앱의 “설정 → 다른 기기 연결”을 엽니다. “주소”와 “연결 코드”를 확인하세요. 주소의 “<이 Mac의 IP>”는 자리 표시자입니다. macOS 네트워크 설정에서 실제 IP를 확인해 그 부분을 바꾸세요.
http://<이 Mac의 IP>:8787“연결” 탭에 Mac 주소와 연결 코드를 입력합니다. 처음 요청되는 로컬 네트워크 접근을 허용하세요. iPad·Mac 동반 앱은 사이드바의 “Mac 연결”을 엽니다.
작업은 Mac에서, 확인과 승인은 어디서든.
연결 정보 · Mac 주소홈의 “새 작업” 또는 “새 작업” 탭에서 제목·원하는 결과·Mac 작업 폴더의 전체 경로를 입력합니다. 요청 후에는 “승인” 탭에서 내용을 읽고 결정합니다.
원하는 결과를 적어주시면 AI 팀이 계획부터 확인까지 함께합니다.
1. 원하는 결과연결된 Mac에 있는 폴더의 전체 경로를 입력해 주세요.
AI 팀 구성을 확인하고 승인하면 작업이 시작됩니다.
동반 앱의 홈 새로고침 버튼이나 아래로 당기는 동작으로 상태를 갱신합니다. Apple Watch에서 “승인 대기” 항목을 열고 내용을 확인하세요.
실행할 내용과 영향을 확인하세요.
Mac 실행 앱과 같은 요청·승인·구매 상태를 사용하는 CLI
DMG의 install-cli.command를 실행하면 현재 사용자에게 wanju를 설치합니다. 셸의 PATH에 ~/.local/bin을 추가하세요.
# 셸 설정에서 사용자 실행 경로를 추가 export PATH="$HOME/.local/bin:$PATH" $ wanju help serve · status · submit · approvals approve · reject · cancel · logs improve · license
GUI가 켜져 있다면 wanju status로 연결합니다. 창 없이 쓰려면 Mac 앱을 종료한 뒤 wanju serve를 실행하세요.
# Mac 앱이 실행 중이면 $ wanju status # Mac 앱을 종료하고 창 없이 쓸 때 $ wanju serve
작업 폴더의 절대 경로와 원하는 결과를 지정합니다. submit은 자동 실행 없이 승인 대기까지 진행합니다.
$ wanju submit \ --workspace "$PWD" \ --prompt '테스트 실패 원인을 분석하고 수정해줘' $ wanju approvals $ WANJU_APPROVAL_ID='승인 목록의 UUID로 바꾸세요' $ wanju approve "$WANJU_APPROVAL_ID" # 거절할 때 $ wanju reject "$WANJU_APPROVAL_ID"
logs로 실행 기록을 확인하고, cancel로 중단을 요청합니다. 다른 기기의 실행 서버에 접속할 때에는 --server와 --token-stdin을 사용하세요.
$ WANJU_TASK_ID='작업 목록의 UUID로 바꾸세요' $ wanju logs "$WANJU_TASK_ID" $ wanju cancel "$WANJU_TASK_ID" # 주소와 연결 코드를 안전하게 지정할 때 $ WANJU_SERVER_URL='Mac의 실제 연결 URL로 바꾸세요' $ wanju status --server "$WANJU_SERVER_URL" \ --token-stdin
Mac 로컬 명령은 기본 기능 · SSH와 개발자용 앱 개선은 Pro
“AI 팀 → 로컬 서버 추가”에서 이름·서버 URL·정확한 모델 ID를 넣습니다.
“Mac 작업”에서 실행할 셸·AppleScript·설치 도구 명령과 작업 폴더를 지정합니다. 승인 요청 후 카드의 실행 범위를 읽고 직접 결정하세요.
실행할 명령을 미리 확인하고 승인합니다.
명령 미리보기동반 앱의 Pro 화면에서 구매 방식을 선택하거나 기존 구매를 복원합니다. 연결된 Mac에 구매를 동기화하세요.
AI 서비스 이용료는 별도입니다.
“원격 서버”에서 서버를 추가합니다. “승인 후 원격 명령 실행”의 서버를 고르고 명령을 적은 뒤 승인 카드에서 실행을 결정하세요.
개발자용 “앱 개선”에서 완주단 소스 폴더와 개선 요청을 지정합니다. 실행을 승인한 뒤 후보 폴더의 변경·검증 기록을 읽고, “완주단 개선안 원본 반영” 승인 카드에서 별도 반영 승인을 결정하세요.
별도 후보 소스에서 수정·검증한 후 원본 반영을 승인합니다.
완주단 소스 폴더오류 메시지와 확인할 항목을 함께 정리했습니다. 기본 연결·승인·알림 질문은 소개 페이지에서도 확인할 수 있습니다.
소개 페이지 FAQ →완주단 Mac 실행 상태, 같은 사설망/VPN 여부, Mac 주소와 8787 포트, 연결 코드를 차례로 확인하세요. iPhone의 로컬 네트워크 접근도 허용돼 있어야 합니다. 다른 기기의 localhost로는 Mac에 접속할 수 없습니다.
“로컬 작업에는 내용과 절대 경로가 필요합니다.”라는 메시지가 나오면 요청 내용을 입력하고 Mac의 폴더 전체 경로를 사용하세요. 동반 앱에서는 연결된 Mac에 실제로 존재하는 폴더여야 합니다.
승인 요청은 15분 뒤 만료됩니다. “승인이 만료되었습니다. 새 작업으로 다시 요청하세요.” 안내에 따라 새 작업을 요청하고 범위를 다시 확인합니다.
동반 앱에서 “구매 복원”을 누른 뒤 “Mac에 구매 동기화”를 실행하세요. Mac의 “설정 → Pro 구매”에서 구매 상태를 확인합니다. CLI는 wanju license로 확인합니다.
구독은 구독 기간 동안 최신 Mac Pro를 사용할 수 있습니다. 영구 구매는 한 번 결제하고 구매 후 1년 동안 출시된 Mac Pro 버전을 계속 사용합니다. 이후 새 버전 업데이트는 선택 사항이며 자동 결제되지 않습니다. 영구 구매가 기존 구독을 자동 해지하지 않으므로 Apple 계정에서 별도로 관리하세요.
“실행 기록”에서 실패한 역할과 메시지를 확인하세요. AI의 설치·로그인·모델 목록과 실제 응답은 별도로 확인해야 합니다. 앱 재시작으로 끊긴 작업을 성공으로 처리하지 않으며, 이미 바뀐 파일은 직접 살펴봐야 합니다.
삭제 위치와 절차는 App Store 앱 페이지에 연결된 개인정보 처리방침의 “삭제와 보관”을 확인하세요. 작업 자료를 먼저 백업하세요. 연결 코드·구매 캐시, Apple 결제 기록, AI 제공자에 이미 전달된 정보는 각각 별도로 관리됩니다.
완주단은 이미 로그인한 CLI 계정과 로컬 모델을 연결합니다. API 키를 요구하는 외부 유료 서버는 지원 범위가 아닙니다. AI 서비스 이용료는 별도입니다.
App Store 앱 페이지에 연결된 앱 지원 및 개인정보 처리방침에서 확인할 수 있습니다. Mac 설치는 동반 앱 “연결” 화면의 “완주단 Mac 설치 및 연결 안내”에서도 찾아볼 수 있습니다.
실행은 AI 팀이, 중요한 결정은 내가.