Wavefunction: 내 모델로 쓰는 Mac AI 코딩 도구

Wavefunction은 Mac에서 쓰는 오픈 소스 AI 코딩 도구입니다. 프로젝트 파일과 대화, 개발 명령 실행, 병렬 작업을 데스크톱 앱에 모았습니다. 작업 중에도 요구 사항을 보태고, 완료 후 코드 변경과 테스트 결과를 확인할 수 있습니다.

쉽게 설명하면 어떤 사이트인가요?

이 사이트는 앱 다운로드와 소스 코드로 연결하는 안내 페이지입니다. 실제 작업은 설치한 앱에서 진행합니다. 프로젝트 폴더를 지정하고 기능 추가나 버그 수정을 요청하면 에이전트가 코드를 편집하고 개발 명령을 실행할 수 있습니다. 기존 청구서 화면에 월별 필터와 테스트를 추가하는 작업이 한 예입니다.

모델을 직접 선택하고 결과를 검토하려는 개발자에게 맞습니다. 설치와 모델 연결 설정이 필요하므로, 도입 전에 자신의 프로젝트 작업 방식과 맞는지 살펴볼 수 있습니다.

클라우드 계정과 로컬 모델 선택

공식 사이트는 ChatGPT Plus/Pro 로그인, Anthropic·Google Gemini·OpenAI·OpenRouter·Vercel AI Gateway API 키, Ollama 및 LM Studio 같은 OpenAI 호환 서비스를 안내합니다. 대화마다 모델을 선택하고 바꿀 수 있습니다. 연결만으로 별도 구독이나 API 잔액이 제공되지는 않습니다. 실제 성능과 사용 한도는 모델과 서비스 설정에 따라 달라집니다.

병렬 코딩과 실행 중 방향 수정

각 대화는 모델, 폴더, 기록을 갖습니다. Git의 새 대화는 기본적으로 별도 브랜치와 checkout에서 시작합니다. 보조 에이전트는 부모의 작업 폴더를 공유하거나 독립 worktree를 받을 수 있습니다. 폴더가 분리되어도 통합 단계의 논리적 충돌까지 없어지는 것은 아닙니다.

실행 중 메시지를 보내면 현재 작업을 조정하고, Queue follow-up은 다음 작업으로 미룹니다. 보조 에이전트를 확인하거나 중단할 수 있고, 메시지에서 대화를 분기하거나 저장된 시점으로 되돌릴 수 있습니다. Rewind는 모든 중간 버전의 백업이 아닙니다. 예약 루틴은 앱이 열려 있어야 동작합니다.

첫 프로젝트 변경을 진행하는 순서

1. 공식 다운로드에서 DMG를 받아 앱을 Applications로 옮깁니다. 공식 요구 사항은 Apple Silicon과 macOS 11 이상입니다.
2. 공급자 또는 로컬 모델 서비스를 연결하고 모델과 프로젝트를 설정합니다.
3. 프로젝트 폴더를 엽니다. 별도 Git checkout이 필요하면 New worktree를 켜 둡니다. 끄면 원래 프로젝트 폴더를 사용합니다.
4. 변경 내용, 제약, 확인 조건을 전달합니다. 예를 들어 API 형식을 유지하면서 필터와 테스트를 추가하도록 요청할 수 있습니다.
5. diff와 명령 출력을 검토한 뒤 변경을 받아들입니다. 완료 메시지만으로 정확성을 판단하지 않습니다.

Docker 안의 별도 데스크톱

computer use는 로컬 Docker 컨테이너의 자체 데스크톱에서 실행됩니다. 공식 설명에 따르면 Mac 포인터를 움직이거나 키보드에 입력하거나 호스트 화면을 녹화하지 않습니다. 관찰하거나 직접 제어를 넘겨받을 수 있으며, 비공개 로그인 때는 에이전트가 멈춥니다. 파일은 명시적으로 추가하거나 허용된 폴더로 전달받습니다.

Docker Desktop과 이미지를 이해하는 모델이 필요합니다. 별도 데스크톱은 외부 웹사이트나 클라우드 모델에 보낸 데이터의 전송까지 차단하지 않습니다.

MCP와 프로젝트 규칙 재사용

사이트는 현재 70개 이상의 준비된 MCP 커넥터와 자체 MCP 서버 추가를 안내합니다. 실제 접근 범위는 각 서비스 권한에 달려 있습니다. AGENTS.md와 SKILL.md를 통해 프로젝트 지침을 재사용할 수 있지만, 지침 파일이 권한 제어나 코드 검토를 대신하지는 않습니다.

무료 범위와 모델 비용

2026년 11월 5일 확인 기준으로 앱은 MIT 라이선스의 무료 소프트웨어입니다. 연결한 모델 계정과 API의 요금·한도는 공급자 조건을 따릅니다. 모든 모델에 공통으로 적용되는 무료 할당량은 문서화되어 있지 않습니다. 의존성과 서비스에도 각각의 조건이 있습니다.

Settings → Analytics는 공급자가 보고한 토큰, 캐시, 실행 횟수, 작업 시간과 USD 비용을 모델별 및 최근 14일 기준으로 보여 줍니다. 보고되지 않은 비용을 0으로 계산하지 않으므로 최종 청구는 공급자에서 확인해야 합니다.

개인정보와 접근 권한

대화, 스킬, 설정은 Mac에 저장됩니다. 그러나 호스팅 모델과 커넥터는 전송된 입력을 받습니다. 키는 시스템 사용자만 읽도록 제한된 로컬 파일이며, 공식 문서에는 암호화되지 않았다고 명시되어 있습니다.

Require zero data retention은 OpenRouter와 Vercel AI Gateway의 라우팅에 적용되며 다른 공급자는 계정 설정이 필요합니다. 명령은 기본적으로 macOS 샌드박스에서 실행되고 외부 폴더는 허가가 필요합니다. Full access의 승인 변경과 되돌릴 수 없는 명령 감지의 한계는 보안 정책에서 확인할 수 있습니다.

자주 묻는 질문

무료 앱에 모든 모델 사용량이 포함되나요?

공통 할당량은 안내되지 않습니다. 앱은 무료지만 모델 접근, 한도와 요금은 공급자가 정합니다.

Ollama나 내 API를 쓸 수 있나요?

네. 안내된 클라우드 서비스 외에 Ollama와 OpenAI 호환 엔드포인트가 지원됩니다. 작업에 적절한 모델과 설정이 필요합니다.

코드가 항상 Mac 안에만 있나요?

로컬 저장만으로 보장되지는 않습니다. 외부 모델과 커넥터는 보낸 입력을 받으며 로컬 키 파일도 암호화되지 않습니다.

어떤 기기와 추가 소프트웨어가 필요한가요?

문서상 앱 요구 사항은 Apple Silicon과 macOS 11 이상입니다. computer use에는 Docker Desktop과 시각 모델이 추가로 필요합니다. Windows·Linux 배포판은 여기서 추정하지 않습니다.

공식 자료

• 공식 저장소와 README: 설치, 구조와 기여 안내.
• GitHub Issues: 일반 오류 보고. 취약점은 보안 정책의 비공개 경로를 사용하세요.