chenhg5/cc-connect
요약
cc-connect는 로컬에서 실행되는 AI 에이전트를 사용자가 이미 사용하고 있는 다양한 메신저 플랫폼(채팅 앱)에 연결하여, 어디서든 언제든지 접근할 수 있게 해주는 도구입니다. 이를 통해 코드 리뷰, 연구, 자동화, 데이터 분석 등 AI 에이전트가 수행할 수 있는 모든 작업을 휴대폰이나 태블릿을 포함한 어떤 기기에서도 원활하게 처리할 수 있습니다. 웹 관리 UI를 통해 프로젝트 및 제공자 관리가 용이하며, 라이프사이클 이벤트 훅과 스킬 관리 기능을 지원하여 고급 자동화 워크플로우 구축에 최적화되어 있습니다.
핵심 포인트
- 로컬 AI 에이전트를 다양한 메신저 플랫폼(채팅 앱)에 연결하여 접근성을 극대화합니다.
- 웹 관리 UI를 통해 프로젝트 생성, 제공자 관리, 세션 모니터링 등 모든 기능을 직관적으로 관리할 수 있습니다.
- 라이프사이클 이벤트 훅을 지원하여 메시지, 세션, 크론 작업 등의 이벤트 발생 시 외부 명령어 또는 웹훅을 트리거하는 고급 자동화가 가능합니다.
- 개인 위챗(Weixin) 및 웨이보 DM 등 특정 메신저 플랫폼과의 연동 기능을 제공합니다.
Sponsors
MiniMax-M2.7 는 자율 진화와 실제 생산성을 위한 차세대 대규모 언어 모델입니다. 기존 모델과 달리 M2.7 은 에이전트 팀, 동적 도구 사용, 강화학습 루프를 통해 자체 개선을 적극적으로 참여합니다. 소프트웨어 공학 (SWE-Pro 56.22%, VIBE-Pro 55.6%, Terminal Bench 2 57.0%) 에서 강력한 성능을 발휘하며, 복잡한 사무 워크플로우에서 뛰어난 1495 ELO 를 달성했습니다. Word, Excel, PowerPoint 의 고화질 편집과 40 개 이상의 복잡한 기술에 대한 97% 준수율을 통해 AI 네이티브 워크플로우 및 조직 구축의 새로운 기준을 세웠습니다.
MiniMax Token 플랜 + cc-connect 사용자에게 할인을 위한 쿠폰을 위해 여기 클릭하세요!
| Thanks to AIGoCode for sponsoring this project! AIGoCode 는 Claude Code, Codex, 최신 Gemini 모델을 통합하는 올인원 플랫폼으로, 안정적인 효율적이고 비용 효율적인 AI 코딩 서비스를 제공합니다. 유연한 구독 플랜, 계정 정지 없음, VPN 없이 직접 액세스, 번개 속도로 응답합니다. cc-connect 사용자를 위한 특별 혜택: 이 링크를 통해 등록하면 첫 충전에 추가 10% 보너스 크레딧을 받습니다! |
| AIHubMix |
| Thanks to AIHubMix for sponsoring this project! AIHubMix 는 OpenAI, Claude, Gemini, Qwen, DeepSeek, Kimi 를 포함한 500 개 이상의 글로벌 모델과 깊은 통합을 제공합니다. 무한한 병행, Google Cloud 의 프로덕션급 안정성. 모든 에이전트를 구동하는 단일 API 키는 원본 OpenAI/Anthropic/Gemini 포맷 지원으로 코드 변경 없이 — 0 코드로. 공식 제공업체와 일치하는 사용량에 따른 가격 정책 및 coding-glm-5.1-free 와 같은 무료 모델 포함. 여기 클릭하여 가입하세요! |
| Thanks to NekoCode for sponsoring this project! NekoCode 는 Claude 과 CodeX 에 대해 투명한 가격 정책을 제공하는 신뢰성 있고 안정적인 효율적인 API 릴레이 서비스를 제공합니다. cc-connect 사용자를 위한 독점 10% 할인 프로모션 코드: CC-CONNECT. 개발자를 위한 고품질의 안정적인 AI 모델 액세스. 이 링크를 통해 등록하세요. |
| Thanks to DMXAPI for sponsoring this project! DMXAPI 는 200 개 이상의 기업 사용자에 글로벌 대규모 모델 API 서비스를 제공합니다. 모든 글로벌 모델을 위한 단일 API 키. 기능: 즉시 청구, 무한한 병행, $0.15 부터 시작, 24/7 기술 지원. GPT/Claude/Gemini 모두 32% 할인, 국내 모델 20-50% 할인, Claude Code 독점 모델 66% 할인! 이 링크를 통해 등록하세요. |
| Thanks to Shengsuanyun for sponsoring this project! Shengsuanyun 은 Claude, Chatgpt, Gemini 와 같은 국내 및 국제 LLM 과 이미지/비디오 멀티미디어 모델을 집계하고 공급하는 AI 네이티브 팀을 위한 산업급 AI 작업 병행 실행 플랫폼과 모델 마켓플레이스입니다. 역공학 또는 데이터 조작은 보장되지 않으며, 전체 사이트 99.7% SLA 가용성을 자랑하며 모니터링 인터페이스는 일관되게 녹색입니다. 또한 세분화된 비용 및 액세스 제어를 위한 기업급 커스터마이징 게이트웨이와 지능형 라우팅, 보안 보호, BYOK 기업 제공 키 호스팅을 제공합니다. 플랫폼은 사용량에 따른 청구 및 토큰 플랜 (곧 출시 예정) 으로 청구되며 영수증이 있습니다. 이 링크를 통해 등록하는 신규 사용자는 모델 파워 10 원과 첫 충전에 10% 보너스를 받습니다.
deposit. | |
| ... |
어떤 채팅 앱에서든 로컬 AI 에이전트를 제어하세요. 어디서든, 언제든지.
cc-connect 는 머신에서 실행 중인 AI 에이전트를 이미 사용하고 있는 메신저 플랫폼에 연결합니다.
코드 리뷰, 연구, 자동화, 데이터 분석 — AI 에이전트가 할 수 있는 모든 작업이 이제 휴대폰, 태블릿 또는 채팅 앱이 있는 어떤 기기에서도 접근 가능합니다.
🌐 웹 관리 UI (추천) — 바이너리에 내장된 전체 관리 대시보드 — 추가 의존성 없음. 프로젝트 생성 및 편집, 제공자 관리, 세션 모니터링, 크론 작업 편집, 그리고 브라우저에서 에이전트와 직접 대화 가능. 5 개 언어 지원 (en/zh/zh-TW/ja/es). cc-connect 는 config.toml 을 수동으로 편집하는 대신 웹 UI 를 통해 관리하는 것을 권장합니다. cc-connect web 실행하여 대시보드를 구성하고 열기, 그 다음 cc-connect 실행하여 서비스를 시작하세요.
라이프사이클 이벤트 훅 (Lifecycle Event Hooks) — 새 [[hooks]] 설정은 메시지, 세션, 크론, 권한, 오류 이벤트에 대해 shell 명령어나 HTTP 웹훅을 트리거합니다. 기본값: 비동기 처리, 실패 시 오픈.
스킬 관리 (Skill Management) — 로컬 스킬 브라우저와 추천 프리셋이 있는 새 /skills 페이지.
글로벌 제공자 관리 (Global Provider Management) — 웹 UI 에서 제공자 추가/편집/삭제; cc-switch 설정에서 가져오기 가능.
개인 위챗 (Personal WeChat) — Weixin (personal) 을 통해 ilink 로긴 폴링을 사용하여 로컬 에이전트와 대화. QR weixin setup, CDN 미디어, 공개 IP 없음.설치 →docs/weixin.md
위보 DM (Weibo DM) — WebSocket 를 통해 위보 개인 메시지를 사용하여 에이전트와 대화; 공개 IP 필요 없음, 텍스트 스트리밍 지원.
페이슈 개선 사항 (Feishu Enhancements) — @명 언급 자동 해결, 다단계 답장 체인 인식, 완료 이모지 반응.
새로운 에이전트 — Kimi CLI 와 Pi 에이전트 지원 추가.
각 내장 플랫폼이 cc-connect 에서 할 수 있는 작업에 대한 고수준 개요.
전체 (Legend)
| 기호 | 의미 |
|---|---|
| ✅ | 일반적인 설정으로 안정형 cc-connect 에서 작동 |
| ... | |
| † QQ (NapCat / OneBot) — 비공식 자체 호스팅 브리지; 동작은 NapCat/네트워크 설정에 따라 다름. |
| 기능 | 페이슈 | 딩톡 | 텔레그램 | 슬랙 | 디스코드 | 라인 | 위컴 | 위챗(개인) |
| QQ† | QQ 봇 |
|---|---|
| 텍스트 및 슬래시 명령어 | ✅ |
| ... | |
| 위컴: 웹훅 모드는 공개 URL 필요; 긴 연결/WS 스타일 설정은 종종 그렇지 않습니다. |
보이스 행: 많은 플랫폼이 config.toml 에서 [speech] / TTS 제공자 활성화 필요; 값은 최선의 노력 요약입니다.
플랫폼별 설치: 아래에 플랫폼 설치 가이드.
10 개 이상의 AI 에이전트 — Claude Code, Codex, Cursor Agent, Kimi CLI, Qoder CLI, Gemini CLI, OpenCode, iFlow CLI, Pi, Devin — plus Agent Client Protocol (ACP) 을 지원하는 모든 에이전트. 워크플로우에 맞는 것을 사용하거나 모두를 한 번에 사용하세요.
11 개 채팅 플랫폼 — 페이슈, 딩톡, 슬랙, 텔레그램, 디스코드, 위챗 워크, 위보, 라인, QQ, QQ 봇 (공식), plus 위챗 (개인 ilink) 를 위한 개인 위챗. 대부분의 플랫폼은 공개 IP 0 개 필요.
멀티봇 릴레이 — 그룹 채팅에서 여러 봇을 연결하고 서로 소통하게 하세요. Claude 에게 물어보고 Gemini 에서 통찰력을 얻으세요 — 모든 것이 한 대화에서.
채팅에서의 완전한 제어 (Full Control from Chat) — 모델 전환 (/model), 추론 조정 (/reasoning), 권한 모드 변경 (/mode), 세션 관리, 모두 슬래시 명령어를 통해.
채팅 내 디렉터리 전환 — /dir <path> (및 /cd <path> 호환성 별칭) 를 사용하여 다음 세션 시작 위치 변경, plus /dir <number> / /dir - 를 통한 빠른 히스토리 점프.
Agent Memory — 터미널을 건드리지 않고 에이전트 지시 파일 (/memory )를 읽기 및 쓰기.
Scheduled Tasks — 자연어로 크론 작업을 설정합니다. "매일 오후 6 시, GitHub 트렌딩 요약"만 바로 작동합니다.
Voice & Images — 음성 메시지나 스크린샷을 전송; cc-connect 는 STT/TTS 와 다중 모달 포워딩을 처리합니다.
Multi-Project — 하나의 프로세스에 여러 프로젝트가 있으며, 각 프로젝트에는 고유한 에이전트 + 플랫폼 조합이 있습니다.
5 Languages — 영어, 중국어 (간체 및 정체), 일본어, 스페인어를 원어로 지원합니다. 내장 i18 n 을 통해 모든 사용자가 편안함을 느낍니다.
Left: Lark | Telegram | Right: Wechat
가장 쉬운 방법 — Claude Code 나 어떤 AI 코딩 에이전트에게 이 내용을 보내면 전체 설치 및 구성을 처리해 줍니다:
Follow https://raw.githubusercontent.com/chenhg5/cc-connect/refs/heads/main/INSTALL.md to install and configure cc-connect.
Via npm:
npm install -g cc-connect
Via Homebrew (macOS / Linux):
brew install cc-connect
Download binary from GitHub Releases:
# Linux amd64 - Stable
curl -L -o cc-connect https://github.com/chenhg5/cc-connect/releases/latest/download/cc-connect-linux-amd64
chmod +x cc-connect
...
Build from source (requires Go 1.22+):
git clone https://github.com/chenhg5/cc-connect.git
cd cc-connect
make build
💡 Tip: Web UI 를 사용하여 구성 — 설치 후 cc-connect web 을 실행하여 웹 관리자 및 브라우저에서 대시보드를 열 수 있습니다. 시각적으로 프로젝트를 생성하고, 플랫폼을 추가하며, 제공자를 관리하고 에이전트와 대화할 수 있습니다. TOML 파일을 수동으로 편집할 필요가 없습니다.
Note: cc-connect web 은 구성과 브라우저만 실행합니다 — 서비스를 시작하려면 cc-connect 를 별도로 실행해야 합니다.
수동 구성을 선호하는 경우:
mkdir -p ~/.cc-connect
cp config.example.toml ~/.cc-connect/config.toml
vim ~/.cc-connect/config.toml
프로젝트에서 admin_from = "alice,bob" 를 설정하여 해당 사용자 ID 가 /dir 와 /shell 과 같은 특권 명령어를 실행할 수 있게 합니다.
사용자가 /dir reset 을 실행하면, cc-connect 는 구성한 work_dir 을 복원하고 data_dir/projects/<project>.state.json 에 저장된 지속적 오버라이드를 지웁니다.
./cc-connect
# npm
npm install -g cc-connect
# Homebrew
...
| Component | Type | Status |
|---|---|---|
| Agent | Claude Code | ✅ Supported |
| ... | ||
| Platform | Guide | Connection |
| --- | --- | --- |
| Feishu (Lark) | docs/feishu.md | WebSocket |
| ... |
/new [name] 새 세션 시작
/list 모든 세션 목록
/switch <id> 세션 전환
...
프로젝트 구성은 장기 비활성화 후 자동으로 새로운 세션으로 전환됩니다. 이는 --continue 를 통해 반복적으로 재인수되는 구식 채팅 기록 (실패한 명령어, 디버깅 노이즈) 이 모델의 주의를 지배하기 시작하는 "컨텍스트 드리프트" 현상을 방지합니다. 이전 세션은 보존되며 /list 와 /switch 를 통해 액세스할 수 있습니다.
[[projects]]
reset_on_idle_mins = 30 # 기본값; 비설정 시 0 으로 설정하여 비활성화
기본값은 30 분입니다. reset_on_idle_mins = 0 을 설정하여 이전 세션을 계속하는 것을 항상 선택할 수 있습니다.
Linux/macOS 에서 프로젝트는 cc-connect 를 실행하는 감독자 사용자와 OS 레벨 파일 시스템 격리 하에 다른 Unix 사용자 아래 에이전트를 생성할 수 있습니다. 현재 Claude Code 는 지원됩니다.
[[projects]]
name = "claude-sandboxed"
run_as_user = "partseeker-coder"
...
Supervisor 에서 패스리스 sudo 를 필요로 하고, 자체 sudo 는 없으며 work_dir 에 대한 읽기/쓰기 권한이 있고, 자신의 ~/.claude/settings.json 이 있어야 합니다. 에이전트가 사용하는 자격증표로 채워져야 하며, claude.ai OAuth 를 통해 인증하는 경우 대상 사용자의 ~/.claude/.credentials.json 을 supervisor 의 복사본에 링크 (symlink) 하여 토크न 갱신이 동기화되도록 해야 합니다 — 자세한 내용은 환경 전파 체크리스트를 참조하세요. 전체 설정은 docs/usage.md 를 참조하세요.
cc-connect 를 시작하기 전에 다음 명령어로 설정을 감사 (audit) 하세요:
cc-connect doctor user-isolation
이것은 세 가지 go/no-go 사전 점검 게이트와 대상 사용자가 읽을 수 있고 읽을 수 없는 것을 보고하는 격리 프로브를 실행합니다. 어떤 게이트가 실패하거나 프로브가 교차 사용자 누출을 감지하면 cc-connect 는 시작을 거부합니다.
/mode Show available modes
/mode yolo # 모든 도구를 자동 승인
/mode default # 각 도구를 확인
/provider list 제공자를 나열
/provider switch <name> 런타임에 API 제공자를 변경
/model 사용 가능한 모델 나열 (형식: 별명 - 모델)
/model switch <alias> 별명으로 모델을 변경
/dir 현재 작업 디렉터리와 히스토리 표시
/dir <path> 경로로 변경 (상대 또는 절대)
/dir <number> 히스토리에서 변경
...
/cron add 0 6 * * * Summarize GitHub trending
에이전트가 로컬 스크린샷, 차트, PDF, 버클, 기타 파일을 생성할 때, 해당 첨부물을 현재 채팅으로 다시 보낼 수 있습니다.
첫 번째 릴리스는 다음을 지원:
- Feishu
- Telegram
에이전트가 시스템 프롬프트를 내장적으로 주입하지 않는 경우, 업그레이드 후 채팅에서 한 번 실행하세요:
/bind setup
또는:
/cron setup
이것은 프로젝트 메모리 파일에 cc-connect 지시를 새로고침하여 에이전트가 첨부물을 다시 보낼 수 있도록 합니다.
config.toml 에서 이 기능을 전역으로 제어할 수 있습니다:
`attachment_send =
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub Trending Go (weekly)의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기