OpenCoworkAI/open-cowork: 오픈 소스 Claude Cowork 및 원클릭 설치

• 오픈 소스 Claude Cowork • 원클릭 설치

중문 문서 • 주요 기능 • 데모 • 다운로드 • 빠른 시작 • 기술 라이브러리 (Skills Library)

Open Cowork는 Windows 및 macOS를 위한 무료 오픈 소스 AI 에이전트 데스크톱 애플리케이션입니다. 이 애플리케이션은 Claude Code, OpenAI, Gemini, DeepSeek 및 기타 AI 모델을 코딩 없이 원클릭 설치가 가능한 사용자 친화적인 GUI (그래픽 사용자 인터페이스)로 통합합니다. 주요 기능으로는 VM (가상 머신) 수준의 샌드박스 격리 (Windows의 WSL2, macOS의 Lima), PPTX, DOCX, XLSX 및 PDF 문서를 생성하기 위한 내장 기술 (Skills) 시스템, 브라우저, Notion 및 기타 데스크톱 앱과 연결하기 위한 MCP (Model Context Protocol) 통합, 컴퓨터 사용 (computer use)을 통한 GUI 자동화, 그리고 Feishu (Lark) 및 Slack을 통한 원격 제어가 포함됩니다. Open Cowork는 Claude Cowork의 오픈 소스 구현체로, AI 기반의 데스크톱 자동화를 모든 사람이 쉽게 사용할 수 있도록 설계되었습니다.

Open Cowork는 Claude Cowork의 오픈 소스 구현체로, Windows 및 macOS를 위한 원클릭 설치 프로그램을 제공하며 코딩이 필요하지 않습니다.

이 프로그램은 AI가 파일을 관리하고, 내장된 기술 (Skills) 시스템을 통해 전문적인 결과물 (PPTX, DOCX, XLSX 등)을 생성하며, 더 나은 협업을 위해 MCP를 통해 데스크톱 앱과 연결 (브라우저, Notion 등)할 수 있는 샌드박스화된 작업 공간을 제공합니다.

경고

면책 조항 (Disclaimer): Open Cowork는 AI 협업 도구입니다. 특히 파일 수정 또는 삭제를 승인할 때 운영에 주의를 기울여 주십시오. 당사는 VM 기반의 샌드박스 격리를 지원하지만, 일부 작업에는 여전히 위험이 따를 수 있습니다.

| MCP & 기술 (Skills) | 원격 제어 (Remote Control) | GUI 조작 (GUI Operation) | |
|---|---|---| |
| Claude Cowork | ✓ | ✗ | ✗ | |
| ... | |

원클릭 설치, 즉시 사용 가능 (One-Click Install, Ready to Use): Windows 및 macOS용 사전 빌드된 설치 프로그램을 제공하여 별도의 환경 설정 없이 다운로드 후 바로 사용할 수 있습니다.

유연한 모델 지원 (Flexible Model Support): Claude, OpenAI 호환 API (OpenAI-compatible APIs), 그리고 GLM, MiniMax, Kimi와 같은 중국 모델을 지원합니다. OpenRouter, Anthropic 또는 기타 API 키를 유연한 설정으로 사용할 수 있습니다. 더 많은 모델이 곧 추가될 예정입니다!

원격 제어 (Remote Control): Feishu (Lark) 및 기타 원격 서비스와 같은 협업 플랫폼에 연결하여 워크플로와 교차 플랫폼 작업을 자동화합니다.

GUI 조작 (GUI Operation): 컴퓨터의 다양한 데스크톱 GUI 애플리케이션을 제어하고 상호작용합니다. 최적의 GUI 이해 및 제어를 위해 Gemini-3-Pro 모델을 권장합니다.

스마트 파일 관리 (Smart File Management): 워크스페이스 내에서 파일을 읽고, 쓰고, 정리합니다.

기술 시스템 (Skills System): PPTX, DOCX, PDF, XLSX 생성 및 처리를 위한 내장된 워크플로를 제공합니다. 사용자 정의 기술(custom skill)의 생성 및 삭제를 지원합니다.

MCP 외부 서비스 지원 (MCP External Service Support): **MCP 커넥터 (MCP Connectors)**를 통해 브라우저, Notion, 사용자 정의 앱 등을 통합하여 AI 기능을 확장합니다.

멀티모달 입력 (Multimodal Input): 원활한 멀티모달 상호작용을 위해 파일과 이미지를 채팅 입력창에 직접 드래그 앤 드롭할 수 있습니다.

실시간 추적 (Real-time Trace): 추적 패널(Trace Panel)에서 AI의 추론 및 도구 실행 과정을 관찰할 수 있습니다.

보안 워크스페이스 (Secure Workspace): 모든 작업은 선택한 워크스페이스 폴더 내로 제한됩니다.

VM 레벨 격리 (VM-Level Isolation): WSL2 (Windows) 및 Lima (macOS) VM 격리를 지원합니다. 모든 명령은 호스트 시스템을 보호하기 위해 격리된 VM 내에서 실행됩니다.

UI 개선 (UI Enhancements): 아름답고 유연한 UI 디자인, 시스템 언어 전환, 포괄적인 MCP/기술(Skills)/도구(Tools) 호출 표시를 제공합니다.

Open Cowork의 작동 모습을 확인하세요:

document_organization.mp4

ppt_generation.mov

xlsx_generation.mov

GUi_opeeration.mov

feishu_operation.mp4

brew tap OpenCoworkAI/tap
brew install --cask --no-quarantine open-cowork

--no-quarantine

플래그는 macOS Gatekeeper를 우회하므로, "Apple에서 이 앱을 확인할 수 없습니다"라는 경고가 나타나지 않습니다.

Releases Page에서 최신 버전을 받으세요.

플랫폼	파일 유형
Windows	.exe
macOS (Apple Silicon)	.dmg

코드베이스에 기여하거나 수정하고 싶은 개발자를 위한 안내:

git clone https://github.com/OpenCoworkAI/open-cowork.git
cd open-cowork
npm install
...

로컬에서 설치 프로그램을 빌드하려면: npm run build

Open Cowork는 시스템을 안전하게 보호하기 위해 **다단계 샌드박스 보호 (multi-level sandbox protection)**를 제공합니다:

단계	플랫폼	기술	설명
Basic	모든 플랫폼	Path Guard	파일 작업이 워크스페이스 폴더로 제한됨
Enhanced	Windows	WSL2	명령어가 격리된 Linux VM에서 실행됨
Enhanced	macOS	Lima	명령어가 격리된 Linux VM에서 실행됨

Windows (WSL2): WSL2가 감지되면 모든 Bash 명령어가 자동으로 Linux VM으로 라우팅됩니다. 워크스페이스는 양방향으로 동기화됩니다. macOS (Lima): Lima가 설치되어 있으면 (brew install lima), /Users가 마운트된 Ubuntu VM에서 명령어가 실행됩니다. Fallback (대체 방식): 사용 가능한 VM이 없는 경우, 경로 기반 제한과 함께 명령어가 네이티브로 실행됩니다.

설정 (선택 사항, 권장)

• Windows: WSL2가 설치되어 있으면 자동으로 감지됩니다. WSL2를 설치하세요.
• macOS: Lima가 설치되어 있으면 자동으로 감지됩니다. 설치 명령어:

brew install lima
# Open Cowork가 'claude-sandbox' VM을 자동으로 생성하고 관리합니다

에이전트를 구동하려면 API 키가 필요합니다. 저희는 OpenRouter, Anthropic, 그리고 다양한 가성비 좋은 **중국 모델 (Chinese Models)**을 지원합니다.

Provider	Get Key / Coding Plan	Base URL (필수)	추천 모델
OpenRouter	OpenRouter	https://openrouter.ai/api	claude-4-5-sonnet
Anthropic	Anthropic Console	(기본값)	claude-4-5-sonnet
Zhipu AI (GLM)	GLM Coding Plan (⚡️중국 모델 특가)	https://open.bigmodel.cn/api/anthropic	glm-4.7, glm-4.6
MiniMax	MiniMax Coding Plan	https://api.minimaxi.com/anthropic	minimax-m2
Kimi	Kimi Coding Plan	https://api.kimi.com/coding/	kimi-k2

• 앱을 열고 왼쪽 하단에 있는 ⚙️ 설정(Settings) 아이콘을 클릭합니다. - API 키를 붙여넣습니다. 주의사항: 표에 따라 **기본 URL(Base URL)**을 설정해야 합니다 (특히 Zhipu/MiniMax 등). - 사용하려는 모델(Model) 이름을 입력합니다.

작업 공간 선택(Select a Workspace): Claude가 작업할 수 있도록 폴더를 선택합니다. 프롬프트 입력(Enter a Prompt): "이 폴더에 있는 financial_report.csv 파일을 읽고 5개 슬라이드의 PowerPoint 요약본을 만드세요."와 같이 입력합니다.

macOS 설치: DMG를 직접 다운로드한 경우 (Homebrew를 통하지 않은 경우) 보안 경고가 나타나면 **시스템 설정 > 개인 정보 보호 및 보안(System Settings > Privacy & Security)**으로 이동하여 **열기(Open Anyway)**를 클릭합니다. 또는 완전히 피하려면 Homebrew를 통해 설치하세요: brew tap OpenCoworkAI/tap && brew install --cask --no-quarantine open-cowork

네트워크 액세스: WebSearch와 같은 도구의 경우, 연결을 보장하기 위해 프록시 설정에서

상세한 계획은 전체 ROADMAP.md를 참조하세요.

완료됨: 핵심 설치 프로그램 (Core installers) · 파일 시스템 샌드박싱 (Filesystem sandboxing) · VM 격리 (VM isolation, WSL2/Lima) · 스킬 (Skills, PPTX/DOCX/PDF/XLSX) · MCP 커넥터 (MCP connectors) · 멀티 모델 지원 (Multi-model support) · 풍부한 입력 (Rich input) · 국제화 (i18n)

다음 예정: 메모리 최적화 (Memory optimization) · Linux 지원 (Linux support) · 플러그인 시스템 (Plugin system) · 컴퓨터 사용 (Computer use) · 안정화 버전 (Stable release)

Open Cowork란 무엇인가요?
Open Cowork는 로컬 AI 에이전트 작업 공간을 제공하는 무료 오픈 소스 데스크톱 애플리케이션입니다. 이 애플리케이션은 AI 모델(Claude, GPT, Gemini, DeepSeek 등)을 GUI로 감싸며, Windows 및 macOS용 원클릭 설치 프로그램을 제공하여 터미널이나 코딩 지식이 전혀 필요하지 않습니다.

Open Cowork는 Claude Cowork와 어떻게 다른가요?
Open Cowork는 Claude Cowork의 오픈 소스 구현체입니다. 멀티 모델 지원(Claude뿐만 아니라 다른 모델 포함), 컴퓨터 사용(computer use)을 통한 GUI 자동화, Feishu/Slack을 통한 원격 제어, 그리고 VM 수준의 샌드박스 격리(sandbox isolation) 기능을 추가했습니다. 자세한 내용은 기능 비교표를 참조하세요.

Open Cowork는 어떤 AI 모델을 지원하나요?
Claude (Anthropic 또는 OpenRouter를 통해), OpenAI 호환 API, 그리고 GLM (Zhipu AI), MiniMax, Kimi를 포함한 중국 모델들을 지원합니다. OpenAI 호환 API 엔드포인트를 제공하는 모든 프로바이더는 설정이 가능합니다.

Open Cowork는 무료인가요?
네. Open Cowork 자체는 MIT 라이선스에 따라 완전히 무료이며 오픈 소스입니다. 사용자는 선택한 프로바이더의 AI 모델 API 사용료만 지불하면 됩니다.

Open Cowork는 Linux에서 작동하나요?
현재 Open Cowork는 Windows 및 macOS용 사전 빌드된 설치 프로그램만 제공합니다. Linux 사용자는 소스에서 직접 빌드할 수 있습니다. '소스에서 빌드하기 (Build from Source)' 섹션을 참조하세요.

샌드박스 격리(sandbox isolation)는 어떻게 작동하나요?
Open Cowork는 다단계 보호를 제공합니다. 모든 플랫폼에서 기본적으로 경로 기반 제한을 적용하며, WSL2 (Windows) 또는 Lima (macOS)를 사용하여 강화된 VM 수준의 격리를 제공합니다. VM을 사용할 수 있는 경우, 모든 명령은 격리된 Linux 환경 내부에서 실행되어 호스트 시스템을 보호합니다.

Skill(스킬)이란 무엇이며, 커스텀 스킬은 어떻게 만드나요?
Skill(스킬)은 PPTX, DOCX, PDF 또는 XLSX 파일을 생성하는 것과 같은 특정 작업을 위한 내장된 워크플로 (Workflow)입니다. Open Cowork는 .claude/skills/ 경로에 기본 Skill(스킬)을 포함하여 제공하며, 사용자가 직접 커스텀 Skill(스킬)을 구축할 수 있도록 돕는 skill-creator 도구를 포함하고 있습니다.

MCP란 무엇이며 어떻게 작동하나요?
MCP (Model Context Protocol)는 AI가 외부 도구 및 서비스에 연결할 수 있게 해줍니다. Open Cowork는 브라우저, Notion 및 기타 데스크톱 앱을 위한 MCP 커넥터 (Connector)를 지원하여, AI의 능력을 단순한 파일 관리 및 코드 작성을 넘어 확장합니다.

Feishu 또는 Slack을 통한 원격 제어는 어떻게 설정하나요?
Open Cowork는 Feishu (Lark) 및 Slack 연동을 통한 원격 제어를 지원하여, 협업 플랫폼에서 명령을 보내고 결과를 받을 수 있습니다. 원격 제어 설정을 위해 앱 설정을 확인하세요.

내 데이터는 안전한가요? Open Cowork가 데이터를 외부 서버로 전송하나요?
Open Cowork는 사용자의 로컬 머신에서 실행됩니다. 사용자의 파일은 워크스페이스 (Workspace) 내에 머무릅니다. 유일한 외부 통신은 사용자가 구성한 AI 모델 API (예: Anthropic, OpenRouter)와의 통신뿐입니다. Open Cowork 서버로는 어떠한 데이터도 전송되지 않습니다.

기여를 환영합니다! 새로운 Skill(스킬), UI 수정, 또는 보안 개선 사항 등 무엇이든 좋습니다:

• 저장소 (Repo)를 포크 (Fork)하세요.
• 브랜치 (Branch)를 생성하세요 (git checkout -b feature/NewSkill).
• PR (Pull Request)을 제출하세요.

지원 및 토론을 위해 커뮤니티에 참여하세요:

Discord: 실시간 채팅, 지원 및 개발 토론을 위해 Discord 서버에 참여하세요.
WeChat: 아래 QR 코드를 스캔하여 WeChat 그룹 (중국어 커뮤니티)에 참여하세요.

MIT © Open Cowork Team

Made with ❤️ by the Open Cowork Team with the help of opus4.5