macOS에 Cowork Island 다운로드 및 설치.

1. CoworkIsland-1.1-b143.dmg를 열고 Cowork Island를 응용 프로그램 폴더로 드래그하세요.
2. 응용 프로그램 폴더에서 Cowork Island를 여세요. macOS가 인터넷에서 다운로드한 앱을 열 것인지 확인하도록 요청할 수 있습니다.
3. 아일랜드는 화면 상단에 나타납니다. 노치 아래에 표시되며, 외장 모니터를 포함해 노치가 없는 디스플레이에서는 위쪽 가장자리에 표시됩니다.
4. Cowork Island에는 Dock 아이콘이 없습니다. 기본적으로 메뉴 막대 항목도 없습니다. 아일랜드에 포인터를 올려 펼친 다음 톱니바퀴를 클릭해 설정을 여세요.

macOS에서 앱이 손상되었다거나 개발자를 확인할 수 없다고 표시되면 진행을 멈추고, 정확한 메시지와 함께 지원팀에 문의하세요. 이 가이드를 따르기 위해 Gatekeeper를 끌 필요는 없습니다.

손쉬운 사용

‘바로 이동’(세션을 클릭해 해당 윈도우, 탭 또는 분할 창으로 이동하는 기능) 중에 Cowork Island가 최소화된 윈도우를 복원하고 Warp에서 세션의 탭으로 전환할 수 있게 합니다. 사용할 수 있는 동작은 원본 앱에 따라 다릅니다.

접근 권한을 부여하거나 거부한 뒤 다시 허용하려면 시스템 설정 > 개인정보 보호 및 보안 > 손쉬운 사용을 열고 Cowork Island를 켜세요. 목록에 없으면 +를 클릭하고 응용 프로그램에서 Cowork Island를 추가하세요.

자동화

Cowork Island가 지원되는 터미널 앱의 윈도우 및 탭 제목을 읽고, 세션으로 이동할 때 그 앱을 제어할 수 있게 합니다. 제어되는 앱마다 macOS가 따로 권한을 요청합니다.

터미널 앱의 ‘자동화’ 권한을 거부했다면 시스템 설정 > 개인정보 보호 및 보안 > 자동화에서 다시 켜세요.

훅 기반 상태 업데이트는 이러한 윈도우 제어 권한과 별개입니다. 특정 ‘바로 이동’ 동작을 사용할 수 없어도 세션은 활동을 보고할 수 있습니다.

손쉬운 사용 및 자동화에 관한 Apple 안내. 출처 확인일: 2026년 9월 20일.

이제 앱이 Mac에서 찾은 도구는 자동으로 연결됩니다. Codex, Cline, 그리고 직접 추가한 도구는 켜기 전까지 꺼져 있습니다. 이런 도구는 설정 > 에이전트에서 켜세요. 연동은 설정에서 끌 수 있습니다. Claude Cowork와 Claude Chat의 스위치는 Cowork, Chat 및 Codex에 있습니다.

훅이나 플러그인을 사용하는 연동의 경우, 아일랜드가 세션 업데이트를 받을 수 있도록 Cowork Island가 해당 도구의 설정에 훅이나 플러그인을 추가합니다. 이 항목은 기존 훅과 공존합니다.

다시 설치는 켜 둔 연동을 복구합니다. 제거는 Cowork Island의 훅을 지우고 그 연동을 끕니다.

사용 가능한 동작은 연동마다 다릅니다. 세션이 보인다고 해서 모든 승인이나 질문에 아일랜드에서 응답할 수 있는 것은 아닙니다.

지원되는 요청 중 확인이 필요한 요청은 확인 필요에 표시됩니다. 현재 지원 범위는 지원 도구와 제품 FAQ에서 확인할 수 있습니다.

로컬 터미널의 SSH 세션만으로는 원격 에이전트를 보고할 수 없습니다. ‘설정’ > ‘원격’에서 호스트 또는 SSH 별칭을 추가하고 연결하세요. Cowork Island가 그 컴퓨터에 원격 훅을 설치하고, 지원되는 이벤트를 SSH로 Mac의 아일랜드에 전달합니다. 이를 위해서는 정상 작동하는 비대화형 SSH 인증, 원격 호스트의 Python 3, 그리고 해당 훅을 설치할 권한이 필요합니다. 내장 원격 설치 프로그램은 Claude Code, Qoder, Codex, CodeBuddy, TraeCli, OpenCode를 지원합니다. 원격 세션에서는 ‘바로 이동’과 세션 폴더를 여는 버튼을 사용할 수 없습니다.

무료 요금제는 기한이 없으며 한 번에 세션 하나를 보여 줍니다. 선택 사항인 Pro 7일 체험에는 결제 정보가 필요 없고, 체험이 끝나면 앱은 무료 요금제로 돌아갑니다. Pro는 Mac 1대, 2대 또는 3대용 일회 결제 상품입니다. Early Bird €5 할인이 적용된 가격은 Mac 1대 €9.99, Mac 2대 €14.99, Mac 3대 €19.99입니다. 세금은 구매 전에 표시됩니다. 무료와 Pro 전체 비교 보기.

1. 앱이 아직 설치되어 있을 때 설정 > 에이전트 > 관리를 열고 제거를 선택하세요. 훅이 제거되었습니다라는 메시지가 나타날 때까지 기다리세요. 설정 파일이 실패로 표시되면 지원 파일을 삭제하기 전에 그 오류를 해결하세요.
2. Pro 라이선스가 있고 이 Mac의 활성화를 해제하려면 설정 > 라이선스 > 이 Mac 비활성화를 사용하세요.
3. Cowork Island를 종료한 다음 응용 프로그램 폴더에서 휴지통으로 옮기세요.

앱은 로컬 지원 파일도 ~/.perch/에 보관합니다. 훅을 제거하고 앱을 종료한 뒤에는, 남은 Cowork Island 데이터 중 더 이상 필요 없는 것을 삭제하기 전에 Finder에서 이동 > 폴더로 이동 메뉴로 그 폴더를 확인할 수 있습니다. 앱만 삭제해서는 훅이나 이 폴더가 제거되지 않습니다.

원격 호스트는 따로 정리해야 합니다. 앱에서 호스트를 삭제하면 연결이 끊기지만, 해당 원격 컴퓨터에 이미 기록된 파일은 제거되지 않습니다. 다른 훅에 영향을 주지 않고 이 항목을 제거하는 데 도움이 필요하면 지원팀에 문의하세요.

이 가이드는 Cowork Island를 만든 사람이 작성했습니다. 설치 문제나 수정할 내용이 있으면 support@coworkisland.com으로 메일을 보내거나 GitHub에 이슈를 등록하세요.