소개
Cc Connect는 로컬에서 실행되는 AI 코딩 에이전트(Claude Code, Codex, Gemini CLI 등)와 메신저 플랫폼을 연결하는 오픈소스 브릿지 도구입니다. 사용자는 텔레그램, 슬랙, 디스코드 등 이미 사용 중인 채팅 앱에서 AI 에이전트를 제어하고 코드 리뷰, 자동화 작업 등을 수행할 수 있습니다. 대부분의 플랫폼에서 공인 IP 없이도 작동하여 어디서나 편리하게 개발 환경에 접근할 수 있습니다.
상세정보
멀티 프로젝트 아키텍처
하나의 프로세스로 여러 프로젝트를 관리할 수 있으며, 각 프로젝트는 자체 에이전트와 플랫폼 조합을 가집니다.
다국어 인터페이스
영어, 중국어(간체/번체), 일본어, 스페인어를 기본적으로 지원하며, i18n이 내장되어 있습니다.
사전 요구사항
AI 에이전트 CLI를 먼저 설치하고 인증해야 합니다. cc-connect는 로컬 AI 코딩 에이전트의 브릿지이므로, 에이전트 CLI가 cc-connect보다 먼저 설치되어 인증되어야 합니다.
예를 들어 Claude Code는 다음 명령으로 설치할 수 있습니다:
- macOS/Linux: brew install –cask claude-code
- 다른 플랫폼: npm install -g @anthropic-ai/claude-code
설치 후 claude –version 명령으로 PATH에 제대로 설치되었는지 확인하세요.
에이전트 인증
각 에이전트는 자체 로그인 절차가 있습니다. 에이전트를 한 번 대화형으로 실행하여 홈 디렉토리에 자격 증명을 저장해야 합니다. 예를 들어 claude login 명령은 브라우저를 열어 인증합니다.
cc-connect 설치
다음 방법 중 하나로 설치할 수 있습니다:
- npm: npm install -g cc-connect
- Homebrew: brew install cc-connect
- GitHub Releases에서 바이너리 다운로드
시작 및 설정
터미널에서 cc-connect 명령을 실행하면 서비스가 시작됩니다. 첫 실행 시 ~/cc-connect/config.toml 파일이 자동으로 생성됩니다. 웹 관리 UI는 http://localhost:9820에서 접근할 수 있습니다.
웹 UI에서 프로젝트를 만들고, 플랫폼을 추가한 후 해당 플랫폼 개발자 콘솔에서 봇 토큰을 붙여넣으면 됩니다. 설정을 저장하면 cc-connect가 핫 리로드됩니다.
기본 사용법/명령어
cc-connect를 시작하면 웹 관리 인터페이스가 활성화됩니다. 이 인터페이스를 통해 프로젝트 생성, 플랫폼 추가, 프로바이더 관리 등을 시각적으로 수행할 수 있습니다.
채팅 앱에서 슬래시 명령을 사용하여 AI 에이전트를 제어할 수 있습니다. 주요 명령어는 다음과 같습니다:
- /model: AI 모델 전환
- /reasoning: 추론 매개변수 조정
- /mode: 권한 모드 변경
- /dir [경로]: 작업 디렉토리 전환
- /memory: 에이전트 지시 파일 관리
이런 경우에 유용합니다
이동 중에 스마트폰으로 로컬 개발 환경의 AI 에이전트와 상호작용해야 할 때 유용합니다. 예를 들어, 출퇴근길에 텔레그램으로 Claude에게 코드 리뷰를 요청하거나, 태블릿에서 Gemini로 프로젝트 문서를 요약할 수 있습니다.
팀 협업 시 그룹 채팅에서 여러 AI 에이전트를 동시에 활용할 때 효과적입니다. 하나의 대화에서 코딩 문제를 해결하면서 동시에 여러 관점의 피드백을 얻을 수 있습니다.
지원 환경·시스템 요구사항
Cc Connect는 Go 1.22 이상이 필요한 오픈소스 프로젝트입니다. 지원되는 에이전트 CLI(Claude Code, Codex, Gemini CLI 등)가 시스템에 설치되어 있어야 합니다.
대부분의 메신저 플랫폼 연동 시 공인 IP가 필요하지 않으며, 웹소켓, 롱 폴링, 소켓 모드 등을 지원합니다.
최신 버전·업데이트
현재 안정적인 버전은 1.5.0이며, v1.5.1-beta.1도 사용할 수 있습니다. 업데이트 방법은 npm, Homebrew, 또는 바이너리 자체 업데이트(cc-connect update)가 지원됩니다.
최신 릴리스는 GitHub Releases 페이지에서 확인할 수 있습니다.
시스템 요구사항
별도의 시스템 요구사항이 등록되지 않았습니다.


