chadbyte/clay

Clay Studio – 자체 호스팅 AI 보강 코딩 작업 공간

이것이 무엇인가

• 로컬에서 실행되는 웹 앱(데몬)으로, 브라우저를 협업 IDE로 전환하여 인간 팀원과 AI 코딩 에이전트(Claude, Codex, GitHub Copilot CLI 등)가 영구 작업 공간을 공유할 수 있게 합니다.
• 데몬은 지원되는 각 에이전트에 대해 설치된 CLI와 통신하며, CLI는 공급자의 모델 API에 연결합니다. 코드나 채팅 데이터는 제3자 서버를 통해 라우팅되지 않습니다.

작동 방식

1. 지원되는 코딩 에이전트 CLI 중 하나를 설치하고 인증합니다.
2. npx clay-server를 실행합니다 – 데몬이 포트 2633(또는 사용자 지정 포트)에서 시작되고 웹 UI를 제공합니다.
3. 모든 브라우저 또는 PWA 설치 장치에서 URL을 열거나(QR 코드 스캔) 엽니다.
4. 프로젝트, 에이전트 세트, 참가자를 바인딩하는 세션을 만듭니다. 세션은 디스크에 JSONL/Markdown으로 상태를 유지합니다.
5. 협업자는 실시간 커서, 멘션을 보고 작업을 인계할 수 있습니다. 에이전트는 고유한 정체성, 지침, 메모리를 가진 "메이트"로 작동합니다.

주요 기능

• 공유 프로젝트 및 실시간 세션 – 사이드바의 여러 저장소, 병렬 세션, 존재 표시기.
• 영구 AI "메이트" – 각 에이전트는 세션 간에 고유한 역할, 지침, 메모리를 유지합니다.
• 교차 공급자 연속성(YOKE) – 공통 세션 인터페이스를 통해 컨텍스트를 잃지 않고 Claude, Codex, Copilot 등 간에 전환할 수 있습니다.
• 백그라운드/병렬 작업 – git worktree, 생성된 작업자, 예약된 작업, "Ralph Loops"가 계속 표시됩니다.
• 기기 독립적 – 데스크톱 브라우저를 사용하거나 모바일에 PWA를 설치할 수 있습니다. 푸시 알림은 승인, 실패 또는 완료된 작업을 알려줍니다.
• 자체 호스팅 제어 – 모든 데이터는 사용자 머신에 저장됩니다. 유일한 네트워크 트래픽은 에이전트 CLI에서 모델 공급자로의 직접 요청입니다.

일반적인 워크플로

Browser → Clay daemon (local) → coding‑agent CLI → model provider

UI를 사설 네트워크(예: Tailscale)를 통해 LAN 외부로 노출하거나 사용자 지정 도메인에 대해 역방향 프록시/터널 설정을 구성할 수 있습니다.

지원되는 에이전트(README 기준) Claude Code, Codex, Grok Build, Kimi Code, GitHub Copilot CLI, Qwen Code, Junie CLI, Antigravity CLI, OpenCode, Kiro CLI.

설치 및 빠른 시작

# 사전 요구 사항: Node.js 20+ 및 최소 하나의 코딩 에이전트 CLI 설치 및 인증
npx clay-server               # 데몬 시작, QR 코드 / URL 열기
# 선택적 플래그
npx clay-server -p 8080       # 사용자 지정 포트
npx clay-server --add .       # 현재 폴더를 프로젝트로 추가
npx clay-server --list         # 등록된 프로젝트 나열
npx clay-server --shutdown    # 데몬 중지

커뮤니티 및 확장

• 커뮤니티 제작 Stream Deck 플러그인은 세션 제어, worktree 전환, 권한 처리를 위한 물리적 버튼을 제공합니다.
• 토론과 변경 로그는 GitHub에서 호스팅됩니다.

라이선스

• Clay Studio의 핵심은 AGPL‑3.0‑only로 출시됩니다. 해당되는 경우 레거시 부분은 MIT 라이선스를 유지합니다.

누가 혜택을 받을 수 있나요?

• 클라우드 호스팅 서비스에 의존하지 않고 AI 지원 페어 프로그래밍을 원하는 소규모 팀.
• 여러 코딩 세션에서 AI 컨텍스트(프롬프트, 메모리)를 유지하려는 개인 개발자.
• LLM 기반 코딩 어시스턴트를 활용하면서 엄격한 데이터 주권 요구 사항이 있는 조직.