프로젝트 소개

# Codeg Codeg(Code Generation)는 모든 AI 코딩 에이전트를 한곳에 모아주는 멀티 에이전트 코딩 워크스페이스입니다. 지원되는 에이전트 CLI(Claude Code, Codex, OpenCode, Pi, Grok Build 등)의 세션을 하나의 검색 가능한 워크스페이스로 통합하며, 메인 에이전트가 단일 작업 내에서 다른 유형의 서브 에이전트에게 작업을 위임할 수 있게 해줍니다. 15개의 에이전트가 기본 내장되어 있으며, 다른 ACP 호환 에이전트도 직접 등록할 수 있습니다. ## 주요 기능 - **멀티 에이전트 협업** — `@`를 입력해 모든 에이전트를 멘션하고 작업을 위임할 수 있습니다. 서브 에이전트는 하나의 작업 내에서 병렬로 별도 세션으로 실행되며, 결과를 현재 스레드로 스트리밍합니다. - **할 일 보드** — 작업을 적어두면 에이전트가 큐를 통해 작업을 처리합니다. 각 작업은 자체 git 워크트리와 브랜치에서 실행되며, 검토하고 병합할 때까지 무인으로 동작합니다. - **사용자 정의 에이전트** — 공개 레지스트리나 배포 JSON에서 모든 ACP 호환 에이전트를 등록할 수 있습니다. Codeg가 이를 설치하고 실행 여부를 검증한 뒤 내장 에이전트처럼 취급합니다. - **통합 워크스페이스** — 모든 에이전트에 걸쳐 하나의 에디터, 실시간 diff, git 클라이언트, 파일 트리를 제공합니다. 다른 디렉터리를 연결해 하나의 워크스페이스로 취급할 수 있습니다. - **세션 기록** — 이전 세션을 `@`로 멘션하면 에이전트가 이를 읽을 수 있습니다. 다른 에이전트의 세션이라도 가능하며, 실행 간 연속성을 제공합니다. - **오피스 문서** — 번들된 `officecli`를 통해 `.docx`, `.xlsx`, `.pptx` 파일을 생성, 분석, 교정, 편집할 수 있으며 탭 내 실시간 미리보기를 지원합니다. - **과학 연구** — 번들된 연구 스킬(가설 생성, 실험 설계, 통계, 시각화, 비판적 평가, 문헌 검색)을 제공합니다. - **프로젝트 부트** — 실시간 미리보기와 함께 새 프로젝트를 시각적으로 스캐폴딩한 뒤 워크스페이스에서 열 수 있습니다. - **MCP 및 스킬** — 로컬 서버 스캔과 레지스트리 검색/설치를 지원하며, 스킬은 전역 또는 프로젝트 범위에서 관리됩니다. - **사용자 정의** — 열두 가지 테마를 토큰 단위로 재색칠하고, 모서리 반경을 설정하며, 테마를 shadcn JSON으로 가져오기/내보내기하거나 사용자 정의 CSS를 작성할 수 있습니다. - **배포 옵션** — 네이티브 데스크톱 앱(macOS, Windows, Linux), 브라우저 접근용 독립 실행형 `codeg-server`, 또는 Docker(`docker compose up`)를 지원합니다. - **모바일 클라이언트** — 데스크톱이나 서버에 연결해 세션 시작, 응답 스트리밍, 권한 승인을 할 수 있는 네이티브 iOS 및 Android 앱을 제공합니다. - **채팅 채널** — Telegram, Lark(Feishu), WeChat에서 에이전트를 구동할 수 있습니다. 작업 생성, 권한 승인, 실시간 업데이트를 지원합니다. - **자동화** — 구성된 컴포저를 재사용 가능한 자동화로 저장해 cron 일정이나 요청 시 헤드리스로 실행할 수 있습니다. - **토큰 사용량 보고서** — 토큰 추세, 캐시 적중률, 활동 히트맵, 폴더·에이전트·모델·세션별 분석에 대한 전체 보고서를 제공합니다. ## 프라이버시 및 보안 파싱, 저장, 프로젝트 작업은 기본적으로 로컬 우선이며, 네트워크 접근은 사용자가 트리거한 작업에서만 발생합니다. 웹 및 서버 모드는 토큰 기반 인증으로 보호됩니다. ## 커뮤니티 QR 코드를 통해 WeChat 그룹에 참여해 토론과 피드백을 나눌 수 있습니다. 지원해 주신 LinuxDO 커뮤니티에 감사드립니다. OfficeCLI는 오피스 문서 워크플로를 지원합니다. ## 시작하기 - **데스크톱** — Releases에서 설치 프로그램을 다운로드하고 설치 문서를 따르세요. - **서버** — `codeg-server`를 헤드리스로 실행하고 모든 브라우저에서 접근하세요. - **Docker** — `docker run -d -p 3080:3080 -v codeg-data:/data ghcr.io/xintaofei/codeg:latest` 배포 문서에서는 Compose, 사전 빌드된 바이너리, 소스 빌드, 제자리 업데이트를 다룹니다.