<p align="center">
<img src="https://raw.githubusercontent.com/chadbyte/clay/HEAD/lib/public/icon-192.png" width="120" alt="Clay Studio symbol" pick /><br>
<img src="https://raw.githubusercontent.com/chadbyte/clay/HEAD/lib/public/clay-studio-wordmark.svg" width="280" alt="Clay Studio" />
</p>
<h2 align="center">지성이 함께 일하는 곳(Where minds work together).</h2>
<p align="center">
사람들과 코딩 에이전트가 프로젝트, 세션, 제공업체 전반에 걸쳐 협업할 수 있는 자체 호스팅 작업 공간입니다.<br>
</p>
<p align="center">
<a href="https://www.npmjs.com/package/clay-server"><img src="https://img.shields.io/npm/v/clay-server" alt="npm version" /></a>
<a href="https://www.npmjs.com/package/clay-server"><img src="https://img.shields.io/npm/dw/clay-server" alt="npm downloads" /></a>
<a href="https://github.com/chadbyte/clay"><img src="https://img.shields.io/github/stars/chadbyte/clay" alt="GitHub stars" /></a>
<a href="https://github.com/chadbyte/clay/blob/main/LICENSE"><img src="https://img.shields.io/badge/License-AGPL--3.0--only-blue.svg" alt="License: AGPL-3.0-only" /></a>
</p>
Clay Studio는 로컬 코딩 에이전트를 공유되고 지속적인 팀으로 변환합니다. 하나의 브라우저 작업 공간에서 다양한 에이전트를 실행하고, 팀원의 라이브 세션에 참여하며, 대화 간 프로젝트 지식을 유지하고, 작업을 다른 클라우드에 맡기지 않고 자동화할 수 있습니다.
빠른 시작 (Quick start)
필수 조건: Node.js 20 이상 및 지원되는 코딩 에이전트 CLI를 최소 하나 설치하고 인증해야 합니다.
Clay Studio는 사용자의 기기에서 실행되며 브라우저에 작업 공간을 제공합니다. 로컬 네트워크 외부에서 접근하려면 Tailscale과 같은 사설 네트워크를 사용하십시오.
Clay Studio를 사용하는 이유 (Why Clay Studio)
함께 일하기 (Work together)
프로젝트, 세션, 사람, 에이전트가 하나의 작업 공간을 공유합니다. 팀원들은 한 터미널 주변에 모일 필요 없이 라이브 활동을 보고, 같은 세션에 참여하고, 작업을 인계하며, 권한 요청에 응답할 수 있습니다.
컨텍스트 유지 (Keep the context)
세션은 일회성 채팅일 필요가 없습니다. Mates는 역할과 지식을 유지하며, 프로젝트 명령어는 지원되는 런타임 전반에 걸쳐 전달되고, 다음 작업이 시작될 때 결정 사항들이 사용 가능합니다.
제어권을 유지하세요
데몬은 사용자가 통제하는 인프라에서 실행됩니다. 세션과 지식은 독점적인 데이터베이스가 아닌 포터블한 JSONL 및 Markdown 형식의 디스크에 저장됩니다. 코딩 에이전트를 변경해도 그 주변 작업 공간을 마이그레이션할 필요가 없습니다.
지원되는 코딩 에이전트
Clay Studio는 현재 다음 통합 기능을 포함합니다:
Claude Code · Codex · Grok Build · Kimi Code · GitHub Copilot CLI · Qwen Code · Junie CLI · Antigravity CLI · OpenCode · Kiro CLI
Clay는 로컬에 설치된 런타임을 감지하고 사용자의 장치에서 사용 가능한 것들을 노출합니다. 각 런타임은 자체 인증을 유지하며, 서로 다른 모델, 모드 및 기능을 노출할 수 있습니다.
핵심 기능
- 공유 프로젝트 및 라이브 세션. 여러 리포지토리를 하나의 사이드바에 정리하고, 세션을 병렬로 실행하며, 존재감(presence), 커서, 멘션, 핸드오프를 통해 협업할 수 있습니다.
- 영구적인 Mates. 고유한 정체성, 명령어, 지식, 메모리, 다이렉트 메시지 및 구조화된 토론에서의 역할을 가진 AI 협력자를 생성합니다.
- 크로스 프로바이더 연속성. YOKE는 지원되는 코딩 에이전트에 공통 세션 인터페이스를 제공하고 프로젝트 명령어 파일을 벤더 경계를 넘어 전달합니다.
- 병렬 및 백그라운드 작업. git worktrees, 페어링된 세션, 생성된 워커(spawned workers), 예약된 작업, 그리고 Ralph Loops를 사용하여 무엇이 실행되고 있는지 가시성을 잃지 않고 사용할 수 있습니다.
- 모든 장치에서 작동하는 작업 공간. 데스크톱 브라우저를 사용하거나 모바일에 PWA를 설치하세요. 승인, 실패 및 완료된 작업에 대한 푸시 알림을 받습니다.
- 작업이 발생하는 곳의 도구들. 동일한 작업 공간에서 파일을 탐색하고 편집하며, diff와 히스토리를 검사하고, 터미널을 열고, 스킬을 설치하고, MCP 서버를 연결하고, 프로젝트 지식을 관리할 수 있습니다.
사용자의 장치가 곧 서버입니다
일반적인 요청 경로는 다음과 같습니다:
Browser → Clay Studio 데몬 → 선택된 코딩 에이전트 런타임 → 모델 제공업체
Clay Studio는 프로젝트 트래픽을 Clay가 호스팅하는 클라우드를 통해 전달하지 않습니다. 사용자의 코드는 오직 선택된 런타임이 이를 모델 제공업체로 전송할 때만, 마치 해당 CLI를 직접 사용할 때와 동일하게 기기를 벗어납니다.
로컬 HTTPS에 사용되는 d.clay.studio 호스트 이름은 DNS 전용 서비스입니다: 어떠한 애플리케이션 데이터도 이 경로를 통과하지 않습니다. 구현 및 위협 모델은 clay-dns를 참조하십시오.
리버스 프록시 및 터널링
프록시가 업스트림 Host 헤더를 재작성하는 경우, 서버 설정 → 네트워크 → 리버스 프록시 및 터널로 이동하여 브라우저에서 접근 가능한 오리진(origin)을 추가하십시오. 예를 들어 https://clay.example.com과 같습니다. 줄마다 하나의 HTTP 또는 HTTPS 오리진을 입력하며, 필요할 경우 포트를 지정하고 경로(path)나 와일드카드(*)는 사용하지 마십시오. 이 설정은 다중 사용자 모드에서 서버 관리자만 편집할 수 있습니다. 저장 시 재시작 없이 새로운 WebSocket 연결에 적용되며, 기존 연결은 재연결될 때까지 유지되고 인증은 여전히 필요합니다. Clay가 오리진 때문에 WebSocket을 거부하는 경우, 데몬 로그에 거부된 오리진이 기록됩니다 (최대 분당 한 번).
터널 연결이 아직 불가능한 경우, 작동하는 로컬 연결을 사용하여 구성하십시오. 또는, 데몬을 중지하고 기존 ~/.clay/daemon.json (또는 CLAY_HOME의 데몬 설정)에 다른 필드를 보존하면서 `
커뮤니티에서 제작한 Clay Stream Deck 플러그인은 물리적 버튼을 세션, 워크트리 및 권한 요청을 위한 실시간 대시보드로 변환합니다.
Clay Studio로 무언가를 구축하고 있나요? GitHub Discussions에서 공유해 주세요.
면책 조항 (Disclaimer)
Clay Studio는 지원하는 코딩 에이전트 제공업체와 제휴하지 않습니다. 제품명 및 상표는 각 소유자에게 속합니다. 이 소프트웨어는 '있는 그대로(as is)' 제공되며, 사용자는 선택한 제공업체의 약관을 준수할 책임이 있습니다.
라이선스 (License)
Clay Studio 전체는 GNU Affero General Public License, 버전 3만에 따라 라이선스가 부여됩니다 (AGPL-3.0-only). 프로젝트의 MIT 라이선스로 이전에 커버되었던 기존 부분은 해당 라이선스의 권한 및 적용 가능한 고지를 유지합니다. 자세한 내용은 LICENSES/MIT-legacy.txt와 라이선스 범위 공지를 참조하세요. 타사 구성 요소는 각자의 라이선스를 따릅니다.