cc-connect

KO | EN

gitlite — search

#react #llm #golang #machine-learning #rust #docker #nodejs #windows #awesome #kubernetes #security #ios #openai #mcp

(★ 15,089)

로컬 AI 코딩 에이전트(Claude Code, Cursor, Gemini CLI, Codex)를 메신저 플랫폼(Feishu/Lark, DingTalk, Slack, Telegram, Discord, LINE, WeChat Work)과 연결하세요. 어디서든 AI 개발 어시스턴트와 대화할 수 있습니다. 대부분의 플랫폼에서 공인 IP가 필요하지 않습니다.

파일 탐색기

최종 버전 다운로드 (.zip)

- settings.local.json
- - bug_report.yml
  - config.yml
  - feature_request.yml
  - platform_agent_request.yml
- - ci.yml
  - issue-reply.yml
  - stale.yml
- CODEOWNERS
- FUNDING.yml
- PULL_REQUEST_TEMPLATE.md
- - agent.go
  - agent_test.go
  - cursor_integration_test.go
  - list_sessions.go
  - mapping.go
  - mapping_test.go
  - rpc.go
  - rpc_test.go
  - session.go
  - session_mode_test.go
- - antigravity.go
  - antigravity_model_test.go
  - permission_bridge.go
  - permission_bridge_test.go
  - session.go
  - session_test.go
- - protocol.go
  - protocol_test.go
- - cc_hooks.go
  - cc_hooks_test.go
  - claude_usage.go
  - claude_usage_test.go
  - claudecode.go
  - claudecode_model_test.go
  - claudecode_test.go
  - claudecode_workdir_race_test.go
  - proc_unix.go
  - proc_unix_test.go
  - proc_windows.go
  - project_env_test.go
  - provider_env_test.go
  - provider_integration_test.go
  - session.go
  - session_test.go
  - skilldirs_test.go
- - appserver_session.go
  - appserver_session_test.go
  - codex.go
  - codex_cache_test.go
  - codex_model_test.go
  - context_usage.go
  - integration_test.go
  - list.go
  - list_test.go
  - patch_test.go
  - proc_unix.go
  - proc_windows.go
  - project_env_test.go
  - provider_config.go
  - provider_config_test.go
  - provider_resume_test.go
  - provider_switch_test.go
  - session.go
  - session_test.go
  - skilldirs_test.go
  - usage.go
  - usage_test.go
- - copilot.go
  - copilot_test.go
  - integration_test.go
  - jsonrpc.go
  - jsonrpc_test.go
  - mock_copilot_test.go
  - proc_unix.go
  - proc_windows.go
  - session.go
  - session_test.go
- - cursor.go
  - cursor_chats_test.go
  - cursor_concurrent_test.go
  - cursor_model_test.go
  - permission_test.go
  - session.go
  - skilldirs_test.go
- - devin.go
  - devin_test.go
- - gemini.go
  - gemini_model_test.go
  - session.go
  - session_test.go
- - iflow.go
  - iflow_integration_test.go
  - iflow_test.go
  - session.go
  - session_test.go
- - kimi.go
  - kimi_test.go
  - live_e2e_test.go
  - probe.go
  - probe_test.go
  - provider_resume_test.go
  - session.go
  - session_test.go
- - opencode.go
  - opencode_model_test.go
  - opencode_workdir_race_test.go
  - provider_resume_test.go
  - session.go
  - session_test.go
- - pi.go
  - pi_test.go
  - proc_unix.go
  - proc_windows.go
  - session.go
- - qoder.go
  - qoder_test.go
  - session.go
- - reasonix.go
  - session.go
  - session_test.go
- - session.go
  - tmux.go
  - tmux_test.go
  - window_per_session_test.go
- - minimax-en.png
  - minimax-zh.png
- - 10dianai.png
  - aican.jpg
  - aicodemirror.jpg
  - aigocode.png
  - aihubmix.png
  - anyrouteio.png
  - apikeyfun.png
  - apinebula.png
  - camel_logo.png
  - claudeapi.svg
  - code0.svg
  - ddshub.png
  - dmx-en.jpg
  - dmx-zh.jpeg
  - dragoncode.png
  - ergou.png
  - fenno.png
  - nekocode.jpg
  - patewayai.png
  - qiniu.png
  - runapi.jpg
  - shengsuanyun.svg
  - siliconflow.png
  - unity2ai.png
  - visioncoder.png
  - youyunzhisuan.png
- v1.2.2-beta.3.md
- v1.3.3-beta.5.md
- v1.3.3.md
- - antigravity_hook.go
  - config_cmd.go
  - cron.go
  - cron_add_test.go
  - cron_edit_test.go
  - daemon.go
  - daemon_test.go
  - doctor_runas.go
  - doctor_runas_test.go
  - doctor_runas_windows.go
  - feishu.go
  - feishu_test.go
  - instance_lock.go
  - instance_lock_test.go
  - instance_lock_windows.go
  - logbackups_test.go
  - logsize_test.go
  - main.go
  - main_test.go
  - plugin_agent_acp.go
  - plugin_agent_antigravity.go
  - plugin_agent_claudecode.go
  - plugin_agent_codex.go
  - plugin_agent_copilot.go
  - plugin_agent_cursor.go
  - plugin_agent_devin.go
  - plugin_agent_gemini.go
  - plugin_agent_iflow.go
  - plugin_agent_kimi.go
  - plugin_agent_opencode.go
  - plugin_agent_pi.go
  - plugin_agent_qoder.go
  - plugin_agent_reasonix.go
  - plugin_agent_tmux.go
  - plugin_platform_cloud_web.go
  - plugin_platform_dingtalk.go
  - plugin_platform_discord.go
  - plugin_platform_feishu.go
  - plugin_platform_googlechat.go
  - plugin_platform_line.go
  - plugin_platform_matrix.go
  - plugin_platform_max.go
  - plugin_platform_qq.go
  - plugin_platform_qqbot.go
  - plugin_platform_slack.go
  - plugin_platform_telegram.go
  - plugin_platform_tuitui.go
  - plugin_platform_webex.go
  - plugin_platform_wecom.go
  - plugin_platform_weibo.go
  - plugin_platform_weixin.go
  - plugin_platform_wps_agentspace.go
  - plugin_platform_wps_xiezuo.go
  - plugin_platform_yuanbao.go
  - plugin_web.go
  - provider.go
  - relay.go
  - restart_unix.go
  - restart_windows.go
  - runas_startup.go
  - runas_startup_windows.go
  - send.go
  - send_test.go
  - session_id.go
  - session_id_test.go
  - sessions.go
  - sessions_test.go
  - sessions_tui.go
  - timer.go
  - tuitui.go
  - tuitui_disabled.go
  - tuitui_test.go
  - update.go
  - update_test.go
  - web.go
  - weixin.go
  - yuanbao.go
- config.go
- config_test.go
- api.go
- api_test.go
- atomicwrite.go
- atomicwrite_test.go
- bridge.go
- bridge_capabilities.go
- bridge_capabilities_snapshot_test.go
- bridge_capabilities_test.go
- bridge_test.go
- card.go
- card_test.go
- claude_status_footer_test.go
- cmdopts.go
- cmdopts_test.go
- command.go
- command_test.go
- cron.go
- cron_test.go
- cuj_test.go
- dedup.go
- dedup_test.go
- dir_history.go
- doctor.go
- engine.go
- engine_test.go
- heartbeat.go
- heartbeat_test.go
- hooks.go
- hooks_test.go
- httpclient.go
- i18n.go
- i18n_test.go
- interfaces.go
- management.go
- management_test.go
- markdown.go
- markdown_html.go
- markdown_html_test.go
- markdown_slack.go
- markdown_slack_test.go
- markdown_test.go
- message.go
- message_test.go
- model_alias_test.go
- multi_workspace_test.go
- observer.go
- observer_test.go
- outgoing_ratelimit.go
- outgoing_ratelimit_test.go
- privileged_test.go
- progress_compact.go
- progress_compact_test.go
- projectstate.go
- projectstate_test.go
- provider.go
- provider_presets.go
- provider_test.go
- providerproxy.go
- ratelimit.go
- ratelimit_test.go
- redact.go
- redact_test.go
- reference_parse.go
- reference_render.go
- reference_render_test.go
- reference_show.go
- reference_show_test.go
- registry.go
- registry_test.go
- relay.go
- relay_test.go
- restart_notify_test.go
- runas.go
- runas_audit.go
- runas_audit_test.go
- runas_check.go
- runas_check_test.go
- runas_probe.sh
- runas_test.go
- runas_windows.go
- session.go
- session_id_validation_test.go
- session_test.go
- setup.go
- skill.go
- skill_presets.go
- skill_test.go
- speech.go
- speech_test.go
- streaming.go
- streaming_test.go
- timer.go
- timer_test.go
- truncate_test.go
- tts.go
- tts_test.go
- updater.go
- updater_test.go
- user_message_watermark_test.go
- user_roles.go
- user_roles_test.go
- web_assets.go
- web_manager.go
- webhook.go
- webhook_test.go
- workspace_binding.go
- workspace_binding_test.go
- workspace_state.go
- workspace_state_test.go
- check_linger_other.go
- env_extension.go
- launchd.go
- launchd_test.go
- logbackups.go
- logbackups_test.go
- logrotate.go
- logrotate_test.go
- logsize.go
- logsize_test.go
- manager.go
- manager_test.go
- systemd.go
- systemd_test.go
- unsupported.go
- windows.go
- windows_test.go
- - alipay.jpg
  - banner.svg
  - connector.png
  - wechatpay.jpg
- - 2026-03-11-delete-batch.md
  - 2026-03-11-feishu-delete-card-design.md
  - 2026-03-11-feishu-delete-card.md
  - 2026-03-12-multi-workspace-design.md
  - 2026-03-12-multi-workspace-plan.md
  - 2026-03-12-multi-workspace-plan.md.tasks.json
  - 2026-03-12-usage-design.md
  - 2026-03-12-usage.md
  - 2026-03-13-session-resilience-design.md
  - 2026-03-13-session-resilience-plan.md
  - 2026-03-13-session-resilience-plan.md.tasks.json
  - 2026-03-23-acp-adapter-design.md
  - 2026-03-24-integration-tests.md
- bridge-protocol.md
- bridge-protocol.zh-CN.md
- cloud-web.md
- cloud-web.zh-CN.md
- community-tools.md
- dingtalk.md
- discord.md
- feishu.md
- googlechat.md
- management-api.md
- management-api.zh-CN.md
- matrix.md
- matrix.zh-CN.md
- max-webhook.md
- qq.md
- qqbot.md
- slack-app-manifest.json
- slack-feature-inventory.md
- slack.md
- telegram.md
- tuitui.md
- usage.md
- usage.zh-CN.md
- wecom.md
- weibo.md
- weixin.md
- wps-xiezuo.md
- .gitignore
- install.js
- package.json
- README.md
- run.js
- - card.go
  - cloudweb.go
  - cloudweb_test.go
  - gateway.go
  - gateway_test.go
  - poll.go
  - poll_test.go
  - protocol.go
  - testhelpers_test.go
  - transport.go
  - ws.go
  - ws_test.go
- - card.go
  - dingtalk.go
  - dingtalk_test.go
- - discord.go
  - discord_test.go
  - format.go
  - format_test.go
  - progress.go
- - card.go
  - card_test.go
  - delete_mode_form.go
  - feishu.go
  - feishu_test.go
  - logger_test.go
  - platform_test.go
  - preview_cleaner_test.go
  - quote_file_test.go
  - relay_group_visibility_test.go
  - token_retry_test.go
  - transient_retry_test.go
  - ws_shared.go
  - ws_shared_test.go
- - googlechat.go
  - googlechat_test.go
  - streaming.go
- - line.go
  - line_test.go
- - e2ee.go
  - e2ee_stub.go
  - matrix.go
  - matrix_test.go
  - verification.go
- - max.go
  - max_test.go
- - qq.go
  - qq_test.go
- - qqbot.go
  - qqbot_test.go
- - session_scope_test.go
  - slack.go
  - slack_test.go
  - streaming.go
  - streaming_card.go
  - streaming_card_test.go
- - telegram.go
  - telegram_location.go
  - telegram_reply.go
  - telegram_test.go
- - history.go
  - tuitui.go
  - tuitui_test.go
- - client.go
  - client_test.go
  - types.go
  - webex.go
  - webex_reply.go
  - webex_test.go
- - inbound_file_test.go
  - mention_strip.go
  - mention_strip_test.go
  - message_split.go
  - websocket.go
  - websocket_media.go
  - websocket_media_test.go
  - websocket_outbound_media.go
  - websocket_test.go
  - wecom.go
  - wecom_test.go
- - weibo.go
  - weibo_test.go
- - cdn.go
  - cdn_test.go
  - client.go
  - media_inbound.go
  - media_outbound.go
  - media_outbound_test.go
  - parse.go
  - types.go
  - weixin.go
  - weixin_test.go
- - wpsagentspace.go
  - wpsagentspace_test.go
- - wpsxiezuo.go
  - wpsxiezuo_test.go
- - platform.go
  - proto.go
  - proto_test.go
  - sign.go
- - regression_test.go
  - smoke_test.go
- - agent_integration_test.go
  - e2e_helpers_test.go
  - e2e_session_test.go
  - engine_platform_test.go
  - filter_sessions_test.go
  - multi_workspace_shared_test.go
  - unsolicited_events_test.go
- - mock_agent.go
  - mock_platform.go
- - bench_test.go
- - favicon.svg
- - App.tsx
  - index.css
  - main.tsx
- .pnpmrc.json
- embed.go
- embed_stub.go
- index.html
- package.json
- pnpm-lock.yaml
- pnpm-workspace.yaml
- postcss.config.js
- preview.html
- tailwind.config.ts
- tsconfig.json
- vite-env.d.ts
- vite.config.ts
.gitignore
.golangci.yml
AGENTS.md
CHANGELOG.md
CLAUDE.md
config.example.toml
CONTRIBUTING.md
embed.go
go.mod
go.sum
INSTALL.md
Makefile
provider-presets.json
README.md
README.zh-CN.md
skill-presets.json

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

![CC-Connect Banner](./docs/images/banner.svg)

[![CI Status](https://github.com/chenhg5/cc-connect/actions/workflows/ci.yml/badge.svg)](https://github.com/chenhg5/cc-connect/actions/workflows/ci.yml)
[![Release](https://img.shields.io/github/v/release/chenhg5/cc-connect?include_prereleases)](https://github.com/chenhg5/cc-connect/releases)
[![npm downloads](https://img.shields.io/npm/dm/cc-connect?logo=npm)](https://www.npmjs.com/package/cc-connect)
[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](https://github.com/chenhg5/cc-connect/blob/main/LICENSE)
[![Go Report Card](https://goreportcard.com/badge/github.com/chenhg5/cc-connect)](https://goreportcard.com/report/github.com/chenhg5/cc-connect)

[![Discord](https://img.shields.io/badge/Discord-Join-5865F2?logo=discord&logoColor=white)](https://discord.gg/kHpwgaM4kq)
[![Telegram](https://img.shields.io/badge/Telegram-Group-26A5E4?logo=telegram&logoColor=white)](https://t.me/+odGNDhCjbjdmMmZl)

[English](./README.md) | [中文](./README.zh-CN.md)

[![chenhg5/cc-connect | Trendshift](https://trendshift.io/api/badge/repositories/23266)](https://trendshift.io/repositories/23266)

## ❤️ Sponsor
> 이곳에 이름을 올리고 싶으신가요? 문의: chg80333@gmail.com | WeChat: mongorz
스폰서
[![Kimi](https://gcdn.moonshot.cn/growth-cdn/sponsor/kimi-en.png)](https://www.kimi.com/code/?aff=cc-connect)
이 프로젝트를 후원해 주신 [Kimi](https://www.kimi.com/code/?aff=cc-connect)에 감사드립니다! [Kimi K3](https://www.kimi.com/blog/kimi-k3)는 Moonshot AI의 가장 강력한 모델이자 세계 최초의 오픈 3T 클래스 모델입니다. 2조 8,000억 개의 파라미터, 네이티브 비전, 그리고 100만 토큰 컨텍스트 윈도우를 갖춘 K3는 장기 코딩, 지식 노동, 추론 전반에 걸쳐 최고 수준의 성능을 제공합니다.
cc-connect를 사용하면 로컬 머신의 Kimi CLI를 Feishu/Lark, DingTalk, Telegram, Slack, Discord, WeCom 및 기타 인스턴스 메시징 도구로 가져올 수 있습니다. 장소에 구애받지 않고 채팅을 통해 로컬 프로젝트 작업을 계속할 수 있으며, Kimi에게 코드를 검사 또는 수정하고, 문제를 해결하고, 명령을 실행하고, 자동화 작업을 처리하도록 요청할 수 있습니다.
\*\*cc-connect는 이미 Kimi CLI를 지원합니다. \*\*[Kimi Code 구독](https://www.kimi.com/code/?aff=cc-connect)\*\*을 시도해 보거나, Kimi Open Platform([中文站](https://platform.kimi.com?track\_id=track-78c5d46574a54286a4ff42f7331272ba&aff=cc-connect) | [Global](https://platform.kimi.ai?track\_id=track-dd37b0bea7a64b99b3fe2217b398e20b&aff=cc-connect))을 통해 API를 사용해 보세요.
---

|  |  |
| --- | --- |
| [APINEBULA](https://apinebula.com/UrO0q1) | 이 프로젝트를 후원해 주신 APINEBULA에 감사드립니다! Galaxy Video Bureau 산하의 엔터프라이즈급 AI 어그리게이션 플랫폼인 APINEBULA는 광범위한 플랫폼 리소스를 활용하여 개발자, 팀, 기업에 안정적이고 비용 효율적인 대형 언어 모델 API 액세스를 제공합니다. 이 플랫폼은 Claude, GPT, Gemini 같은 선도적인 풀 스펙 모델들을 통합하여 단일 API로 세계 최고의 AI 모델에 연결할 수 있게 해주며, 가격은 원본 비용의 최저 10% 수준부터 시작합니다. AI 프로그래밍, Agent 개발, 비즈니스 시스템 통합을 위해 설계된 APINEBULA는 엔터프라이즈급 고동시성, 정식 계약, 법인 계좌 이체 및 세금계산서 발행 서비스를 지원합니다. APINEBULA는 소프트웨어 사용자를 위한 특별 할인 혜택을 제공합니다. [이 링크](https://apinebula.com/UrO0q1)를 통해 가입하고 첫 충전 시 "ccconnect" 프로모션 코드를 입력하면 10% 할인을 받을 수 있습니다. |
| [七牛云 Qiniu Cloud](https://s.qiniu.com/aUbueu) | 이 프로젝트를 후원해 주신 [Qiniu Cloud AI](https://s.qiniu.com/aUbueu)에 감사드립니다! Qiniu Cloud(HK:02567)는 모든 주요 공급업체와 완전한 프로토콜 호환성을 갖추고 150개 이상의 글로벌 선도 모델에 대한 원스톱 액세스를 제공하는 엔터프라이즈급 LLM MaaS 플랫폼입니다. 텍스트, 이미지, 오디오, 비디오, 파일 처리를 모든 모달리티에 걸쳐 아우르며, 전 세계 169만 명 이상의 기업 및 갲바자 사용자에게 서비스를 제공합니다. cc-connect 사용자를 위한 단독 혜택: 기업 고객에게는 1,200만 개의 무료 토큰이 제공되며, 친구를 초대하면 최대 수십억 개의 토큰을 보너스로 적립할 수 있습니다. |
| [Fenno.ai](https://api.fenno.ai/register?redirect=/purchase?tab=subscription%26group=16&aff=C7KG6WBS7CQJ) | 이 프로젝트를 후원해 주신 Fenno.ai에 감사드립니다! Fenno.ai는 현재 OpenAI 및 Anthropic 프로토콜과 완전 호환되는 Codex 릴레이를 제공하는 안정적이고 효율적인 API 릴레이 서비스입니다. Codex, Claude Code, OpenCode 같은 주류 코딩 도구와 유연하게 통합되며, 하루 수천억 개의 토큰에 달하는 엔터프라이즈급 요구 사항을 안정적으로 지원합니다. Fenno.ai는 국내 및 해외 법인 간 결제 및 세금계산서 발행을 지원합니다. cc-connect 사용자를 위한 단독 혜택: [이 링크](https://api.fenno.ai/register?redirect=/purchase?tab=subscription%26group=16&aff=C7KG6WBS7CQJ)를 통해 구독하면 파격적인 조건의 Coding Plan(¥9.9 / $150 크레딧)을 이용할 수 있으며, 친구를 초대할 때마다 최대 20%의 보너스를 적립할 수 있습니다. |
| [AIGoCode](https://aigocode.com/invite/CYY3C85C) | 이 프로젝트를 후원해 주신 AIGoCode에 감사드립니다! AIGoCode는 Claude Code, Codex, 최신 Gemini 모델을 통합한 올인원 플랫폼으로, 안정적이고 효율적이며 비용 효율성이 뛰어난 AI 코딩 서비스를 제공합니다. 이 플랫폼은 유연한 구독 플랜, 계정 정지 위험 제로, VPN 불필요한 직관적 접속, 번개처럼 빠른 응답 속도를 제공합니다. AIGoCode는 cc-connect 사용자를 위한 특별한 혜택을 준비했습니다. [이 링크](https://aigocode.com/invite/CYY3C85C)를 통해 가입하시면 첫 충전 시 10%의 추가 보너스 크레딧을 받으실 수 있습니다! |
| [DMXAPI](https://www.dmxapi.cn/register?aff=NDln) | 이 프로젝트를 후원해 주신 DMXAPI에 감사드립니다! DMXAPI는 200개 이상의 기업 사용자에게 글로벌 대형 모델 API 서비스를 제공합니다. 모든 글로벌 모델을 하나의 API 키로 이용하세요. 즉시 세금계산서 발행, 무제한 동시성, $0.15부터 시작하는 가격, 연중무휴 기술 지원 등의 특징을 제공합니다. GPT/Claude/Gemini 전 품목 32% 할인, 국내 모델 20~50% 할인, Claude Code 전용 모델 66% 할인! [이 링크](https://www.dmxapi.cn/register?aff=NDln)를 통해 가입하세요. |
| [APIKEY.FUN](https://apikey.fun/register?aff=cc_connect) | 이 프로젝트를 후원해 주신 APIKEY.FUN에 감사드립니다! APIKEY.FUN은 기업과 개인 개발자에게 안정적이고 효율적이며 비용 효율적인 AI 모델 API 액세스를 제공하는 데 주력하는 전문 엔터프라이즈급 AI 릴레이 서비스입니다. 이 플랫폼은 Claude, OpenAI, Gemini 및 기타 주류 모델을 지원하며, 가격은 공식 요금의 최저 7% 수준입니다. [이 링크](https://apikey.fun/register?aff=cc_connect)를 통해 가입하세요. |

모든 충전 시 상시 5% 할인 혜택을 누리세요! |
||  |  |
| --- | --- |
| [Shengsuanyun](https://www.shengsuanyun.com/?from=CH_67XCLZGS) | 본 프로젝트를 후원해 주신 Shengsuanyun에 감사드립니다! Shengsuanyun은 AI Native 팀을 서비스하기 위해 헌신하는 슈퍼 팩토리이자, 산업용 등급의 AI 작업 병렬 실행 플랫폼이며, Claude, ChatGPT, Gemini 등 국내외 LLM 및 이미지/비디오 멀티미디어 모델의 컴퓨팅 파워를 집약하고 공급하는 모델 마켓플레이스입니다. 리버스 엔지니어링이나 데이터 조작이 없음을 보장하며, 사이트 전체에서 99.7%의 SLA 가용성을 자랑하고 [모니터링 인터페이스](https://watch.shengsuanyun.com/status/shengsuanyun)는 항상 녹색 상태를 유지합니다. 또한, 지능형 라우팅, 보안 보호, BYOK 기업 제공 키 호스팅 기능을 갖춘 정교한 비용 및 액세스 제어를 위한 엔터프라이즈급 맞춤형 게이트웨이를 제공합니다. 이 플랫폼은 종량제(pay-as-you-go) 및 토큰 요금제(출시 예정)로 과금되며, 인보이스 발급이 가능합니다. [이 링크](https://www.shengsuanyun.com/?from=CH_67XCLZGS)를 통해 가입하는 신규 사용자에게는 10위안어치의 모델 파워와 첫 충전 시 10% 보너스가 제공됩니다. |
| [VisionCoder](https://visioncoder.cn) | 본 프로젝트를 지원해 주신 VisionCoder에 감사드립니다. [VisionCoder 개발자 플랫폼](https://visioncoder.cn)은 신뢰할 수 있고 효율적인 API 릴레이 서비스 제공업체로, Claude Code, Codex, Gemini 등 주류 AI 모델에 대한 액세스를 제공합니다. 이를 통해 개발자와 팀이 AI 기능을 더 쉽게 통합하고 생산성을 향상할 수 있도록 돕습니다. 또한, VisionCoder는 이제 **Claude Max 200** 및 **GPT Pro 200** **프리미엄 계정**에 대한 소매 채널을 제공하여 사용자가 최고 수준의 AI 컴퓨팅 파워와 기능을 즉시 이용할 수 있도록 지원합니다. |
| [RunAPI](https://runapi.co/register?aff=4BXa) | 본 프로젝트를 후원해 주신 RunAPI에 감사드립니다! RunAPI는 OpenRouter의 대안이 되는 효율적이고 안정적인 API 플랫폼입니다. 단 하나의 API Key로 OpenAI, Claude, Gemini, DeepSeek, Grok 등을 포함한 150개 이상의 주요 모델에 원본 가격의 최저 10 수준(최대 90% 할인)으로 뛰어난 안정성과 함께 액세스할 수 있습니다. Claude Code, OpenClaw 등의 도구와 완벽하게 호환됩니다. RunAPI는 cc-connect 사용자만을 위한 독점 혜택을 제공합니다. 가입 후 관리자에게 연락하여 7위안 상당의 무료 크레딧을 받으세요. |
| [CaMeL](https://camel.kr777.top/register?aff=V2z8) | 본 프로젝트를 후원해 주신 CaMeL에 감사드립니다! 주요 연구소 및 슈퍼컴퓨팅 센터와의 심도 있는 협력을 바탕으로 자체 개발한 고안정성 고효율 캐시 스케줄링 솔루션을 제공합니다. cc-connect 사용자 전용 혜택: 신규 가입 및 인증 시 즉시 10달러의 크레딧이 지급됩니다. [이 링크](https://camel.kr777.top/register?aff=V2z8)를 통해 가입하세요. |
| [Unity2.ai](https://unity2.ai/register?source=ccconnect) | 본 프로젝트를 후원해 주신 Unity2.ai에 감사드립니다! Unity2.ai는 개인 개발자, 팀, 기업을 위한 고성능 AI 모델 API 릴레이 플랫폼입니다. 국내 주요 기업들을 장기적으로 서비스해 왔으며 일일 트래픽이 300억 토큰을 초과하고, 최대 5000 RPM의 고동시성을 지원합니다. 잔액 과금, 첫 충전 보너스, 콤보 구독, 기업용 인보이스, 전담 연동 서비스를 제공합니다. [이 링크](https://unity2.ai/register?source=ccconnect)를 통해 가입하여 2달러 크레딧을 받고, 공식 그룹에 참여하여 추가로 10달러 크레딧을 받아 최대 12달러의 무료 크레딧을 챙기세요! |
| [二狗 API](https://ergouapi.com/r/gh-cc-connect) | 본 프로젝트를 후원해 주신 Ergou API (二狗 API)에 감사드립니다! Ergou API는 업계 최저 수준인 0.1배~0.2배의 전면적인 요율을 제공하는 LLM API 릴레이로, Claude, GPT, Gemini 및 기타 최고급 LLM을 위한 100% 네이티브 엔드포인트를 지원합니다. 프리미엄 IPLC 라우트와 이중 주거용 ISP 이중화 백업을 통해 Ergou API는 전국 어디서나 안정적이고 지연 시간이 짧은 액세스를 제공합니다. 개발자와 스튜디오의 많은 [가입](https://ergouapi.com/r/gh-cc-connect)을 환영합니다. |
| [AnyRoute.io](https://cc.anyroute.io/register?aff=CR455DSQSKEV) | Thank

s to AnyRoute.io for sponsoring this project! AnyRoute.io는 최신 Claude Code 및 Codex 모델을 통합하는 안정적이고 효율적인 API 릴레이 플랫폼입니다. 공식 가격 대비 최대 93% 할인된 투명한 가격(단 0.7배)을 제공하며, 인보이스 발행 및 엔터프라이즈 급 고동시 접속을 지원합니다. 시작하려면 [이 링크](https://cc.anyroute.io/register?aff=CR455DSQSKEV)를 통해 가입하세요. |
| [aicanapi.com](https://aicanapi.com/register?aff=rIEy) | aicanapi.com의 프로젝트 후원에 감사드립니다! Aican API는 기업과 개발자를 위한 고성능, 저지연, 고동시 접속 API 서비스를 제공합니다. Claude Code 모델은 공식 가격 대비 최대 84% 할인, 기타 모델은 80% 할인된 가격으로 이용할 수 있습니다. Doubao Seedance 2 실사람 생성 서비스는 대기열 없는 빠른 응답을 지원합니다. 더 간단하고 효율적이며 비용 효율적인 엔터프라이즈 급 AI 서비스를 위해 Aican API를 선택하세요. 시작하려면 [이 링크](https://aicanapi.com/register?aff=rIEy)를 통해 가입하세요. |
| [Pateway](https://pateway.ai/?ch=2qn568&aff=DRA4VUFS) | Pateway의 프로젝트 후원에 감사드립니다! PatewayAI는 진지한 AI 개발자를 위한 프리미엄 API 릴레이 서비스로, 리버스 엔지니어링이나 품질 저하 없이 Claude 및 Codex 모델에 대한 100% 공식 다이렉트 액세스를 제공합니다. 토큰 수준 검증을 통한 투명한 과금이 제공됩니다. 엔터프라이즈 급 동시 접속 지원, 정식 계약 및 인보이스 발행이 가능합니다. 시작하려면 [이 링크](https://pateway.ai/?ch=2qn568&aff=DRA4VUFS)를 통해 가입하여 $3 무료 체험 크레딧, 충전 시 최대 40% 할인, 최대 $150의 추천 보상을 받으세요! |
| [10点AI](https://cy.10dianai.com/register?aff=3FQn) | 10点AI의 프로젝트 후원에 감사드립니다! 10dian-AI Enterprise Platform은 GPT, Claude, Gemini, DeepSeek 등을 통합하는 개발자 및 기업용 AI API 게이트웨이입니다. 인터페이스 지연 및 타임아웃 문제를 방지하며 안정적인 고동시 접속 운영이 가능하도록 프로덕션 환경에 최적화되어 있습니다. 합리적인 가격, 안정적인 가동 시간, 공식 보증을 제공합니다. 시작하려면 [이 링크](https://cy.10dianai.com/register?aff=3FQn)를 통해 가입하여 ¥5 무료 크레딧을 받으세요! |
| [SiliconFlow](https://cloud.siliconflow.cn/i/650Yh2Z7) | SiliconFlow의 프로젝트 지원에 감사드립니다! SiliconFlow는 고성능 AI 인프라 및 모델 API 플랫폼으로, 언어, 음성, 이미지, 비디오 모델에 빠르고 안정적으로 접근할 수 있는 통합 환경을 제공합니다. 사용량 기반 과금(pay-as-you-go), 광범위한 멀티모달 모델 지원, 고속 추론, 엔터프라이즈 급 안정성을 갖춘 SiliconFlow는 개발자와 팀이 AI 응용 프로그램을 더욱 효율적으로 구축하고 확장할 수 있도록 지원합니다. [이 링크](https://cloud.siliconflow.cn/i/650Yh2Z7)를 통해 가입하고 실명 인증을 완료하면 ¥20의 보너스 크레딧을 받을 수 있습니다! |
| [优云智算](https://passport.compshare.cn/register?referral_code=H65IOClRGu5CM7nn5ykfad&ytag=GPU_YY_YX_git_cc-connect) | 优云智算의 프로젝트 후원에 감사드립니다! 优云智算(UCloud AI Cloud Platform)은 클릭 한 번으로 국내외 모델 API를 안정적이고 포괄적으로 제공합니다. 가성비 높은 Coding Plan 패키지(월간 또는 사용량별)와 해외 모델을 위한 안정적인 공식 릴레이를 특징으로 합니다. Claude Code, Codex, API 호출을 지원합니다. 엔터프라이즈 기능으로는 고동시 접속, 24시간 연중무휴(7x24) 기술 지원, 셀프 서비스 인보이스 발행이 있습니다. [이 링크](https://passport.compshare.cn/register?referral_code=H65IOClRGu5CM7nn5ykfad&ytag=GPU_YY_YX_git_cc-connect)를 통해 가입하여 ¥5의 무료 플랫폼 크레딧을 받으세요! |
| [DragonCode](https://dragoncode.codes/register?ref=23ZELCPX) | DragonCode의 프로젝트 지원에 감사드립니다. DragonCode는 cc-connect 사용자를 위해 특별 혜택을 준비했습니다. 시작하려면 [이 링크](https://dragoncode.codes/register?ref=23ZELCPX)를 통해 가입하세요. |
| [Code0](https://code0.ai/register?aff=5cGO) | Code0의 프로젝트 후원에 감사드립니다! Code0은 중국 개발자를 위한 AI 모델 집계 API 릴레이 서비스로, OpenAI / Anthropic / Gemini 프로토콜과 호환됩니다. 모든 주류 모델을 원클릭으로 지원하며, Claude Code, Codex, Gemini CLI, cc-connect 등을 안정적으로 지원합니다. 고정 환율을 제공합니다.

te: ¥1.5 CNY = $1 USD API 크레딧, 투명한 가격, 국내 직통 연결, 바로 사용 가능. [이 링크](https://code0.ai/register?aff=5cGO)를 통해 가입하세요. |
| [claudeapi.com](https://console.claudeapi.com/register?aff=GDbA) | 이 프로젝트를 후원해 주신 claudeapi.com에 감사드립니다! claudeapi는 중고급 사용자들을 위한 고품질 Claude 직접 연결 서비스입니다. Anthropic의 공식 퍼스트파티 Key 및 AWS Bedrock 공식 채널과 완벽하게 연동되어 리버스 엔지니어링, 성능 저하, 이어 붙이기 등이 전혀 없습니다. Opus / Sonnet / Haiku의 공식 기능, 긴 컨텍스트, 도구 호출(tool-calling) 성능을 온전히 보존합니다. Claude Code 파워 유저, Agent 개발자, 엔터프라이즈 팀을 위해 특별히 설계되었으며, 즉시 사용 가능한 편리함과 엔터프라이즈급 안정성에 초점을 맞추고 있습니다. 인보이스 발행 및 팀 온보딩을 지원합니다. [이 링크](https://console.claudeapi.com/register?aff=GDbA)를 통해 가입하세요. |

**Control your local AI agents from any chat app. Anywhere, anytime.**

cc-connect는 내 컴퓨터에서 실행 중인 AI 에이전트를 이미 사용 중인 메신저 플랫폼과 연결해 줍니다.  
코드 리뷰, 리서치, 자동화, 데이터 분석 등 AI 에이전트가 할 수 있는 모든 것을

이제 스마트폰, 태블릿, 또는 채팅 앱이 있는 어떤 기기에서든 접근할 수 있습니다.

![CC-Connect Architecture](docs/images/connector.png)

## 🆕 v1.3.3 새로운 기능
1.3.3 시리즈의 첫 번째 정식 버젼 — beta.1에서 beta.5까지의 안정화 버전(v1.3.2 이후 약 235개의 PR) 및 7개의 베타 이후 수정 사항을 포함합니다. 주요 하이라이트:
- \*\*새로운 에이전트\*\* — Devin CLI, Google Antigravity (`agy`), GitHub Copilot CLI가 퍼스트 클래스 에이전트로 추가되었습니다(#672, #1123, #865). Cursor / OpenCode / Qoder / Kimi / Pi 지원이 강화되었습니다.
- \*\*플랫폼 확장\*\* — QQ (OneBot) 파일 송수신(#323), QQ Bot 인라인 키보드(#1131), WebSocket의 WeCom `SendFile`(#1199), Feishu 오디오 + 비디오 네이티브 미디어(#1202), Slack Assistant API(#844), MAX 웹훅 전달(#818), DingTalk @멘션 / richText / 이미지 / 파일 수신(#1188, #828, #1357), 확장된 Weibo DM, WPS Xiezuo (金山协作).
- \*\*장기 실행 턴 강화\*\* — 새로운 `max\_turn\_time\_mins` 벽시계 제한(wall-clock cap)에 소프트 스톱(soft-stop) + 강제 종료(force-kill) + 자동 재개(auto-resume) 기능이 추가되어, 긴 bash / 테스트 명령어가 세션을 무기한 잠그는 것을 방지합니다(#1091).
- \*\*새로운 코어 명령어\*\* — `/timer` (일회성 지연 작업), `/cancel` (현재 턴 중단), `/ps` (`/btw` 대체, 별칭으로 유지), `cron add --silent`, 에이전트 구동형 TTS.
- \*\*다중 사용자 / 권한\*\* — 권한이 없는 IM 발신자에게 답장 보내기 옵션, `@Bot/permit` ≡ `/permit` 키워드 매칭, Bridge 활성화 시 토큰 필수화.
- \*\*제공자 생태계\*\* — NekoCode, VisionCoder, AIHubMix, MiniMax M3 프리셋; Claude Code 1M 컨텍스트 Opus + `append\_system\_prompt` + PermissionRequest 훅; Codex `request\_user\_input` 앱 서버 이벤트; `exec`를 위한 설정 가능한 `shell` + 셸 프로필.
- \*\*관측 가능성\*\* — 블랙박스 테스트 프레임워크(P0/P1/P2 + 설정 스위치 매트릭스), CUJ 테스트 프레임워크, codex/opencode/kimi용 제공자 재개 회귀 테스트 스위트, 답장 바닥글의 Pi 컨텍스트 사용량 리포터.
⚠️ \*\*동작 변경 사항(조치가 필요할 수 있음)\*\*: Telegram/Discord `progress\_style` 기본값이 `compact`로 변경됨 (되돌리려면 `legacy`로 설정); QQ Bot 기본 `intents`에 이제 `INTERACTION\_CREATE`가 포함됨 (사용자 정의 값은 `1<<26`을 포함해야 함); DingTalk `msgtype=file` 수신이 이제 에이전트에 도달함; 엔진 권한 키워드는 @멘션 허용형임; `reset\_on\_idle\_mins` 기본값은 30분임; 토큰이 설정되지 않은 Bridge는 시작을 거부합니다. 전체 테마별 요약은 `changelogs/v1.3.3.md`를 참조하세요.
호환성이 깨지는 변경 사항(Breaking changes)은 없습니다. v1.3.3-beta.\* 버전에서 업그레이드하는 경우, 사소한 버그 수정 전용 업그레이드입니다.
## 🧩 플랫폼 기능 스냅샷
cc-connect의 각 \*\*내장 플랫폼\*\*이 할 수 있는 일에 대한 고수준 요약입니다.
\*\*범례\*\*
| 기호 | 의미 |
|--------|---------|
| ✅ | 일반적인 설정으로 \*\*안정적인\*\* cc-connect에서 작동함 |
| ⚠️ | 부분적 작동, 추가 설정(예: 음성 / ASR) 필요, 또는 공급업체 앱/API에 의해 제한됨 |
| ❌ | 지원되지 않거나 실제 사용이 불가능함 |
† \*\*QQ (NapCat / OneBot)\*\* — 비공식 자체 호스팅 브리지; 동작은 NapCat / 네트워크 설정에 따라 다릅니다.
| 기능 | Feishu | WPS Xiezuo | DingTalk | Telegram | Slack | Discord | LINE | WeCom | Weibo | \*\*Weixin\*\*  
\*(개인)\* | QQ† | QQ Bot | Matrix |
|------------|:------:|:----------:|:--------:|:--------:|:-----:|:-------:|:----:|:-----:|:-----:|:-------------------------:|:---:|:------:|:------:|
| 텍스트 및 슬래시 명령어 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| Markdown / 카드 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ⚠️ | ⚠️ | ❌ | ✅ | ✅ | ✅ | ⚠️ |
| 스트리밍 / 청크 단위 답장 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| 이미지 및 파일 | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ |
| 음성 / STT / TTS | ⚠️ | ❌ | ⚠️ | ✅ | ⚠️ | ⚠️ | ❌ | ⚠️ | ❌ | ✅ | ⚠️ | ⚠️ | ❌ |
| 개인 (DM) | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ |
| 그룹 / 채널 | ✅ | ✅ | ✅ | ✅ | ✅ | ✅ | ⚠️ | ✅ | ❌ | ✅ | ✅ | ✅ | ✅ |
> \*\*WeCom:\*\* 웹훅 모드에는 \*\*공개 URL\*\*이 필요하며, 롱 커넥션 / WS 스타일 설정은 대개 필요하지 않습니다.
> \*\*음성 행:\*\* 많은 플랫폼에서 `config.toml`에 `[speech]` / TTS 제공자가 활성화되어 있어야 합니다. 값은 최선(best-effort)을 다해 요약한 것입니다.
> 플랫폼별 설정: 아래의 [플랫폼 설정 가이드](#-platform-setup-guides)를 참조하세요.
## ✨ 왜 cc-connect인가요?
### 🤖 범용 에이전트 지원
\*\*10개 이상의 AI 에이전트\*\* — C

Claude Code, Codex, Cursor Agent, Kimi CLI, Qoder CLI, Gemini CLI, OpenCode, iFlow CLI, Pi, Devin, Copilot — 그리고 [Agent Client Protocol (ACP)](https://agentclientprotocol.com/get-started/agents)을 지원하는 모든 에이전트. 워크플로우에 맞는 것을 선택하거나, 한 번에 모두 사용할 수도 있습니다.
### 📱 플랫폼 유연성
\*\*13개의 채팅 플랫폼\*\* — Feishu, WPS Xiezuo, DingTalk, Slack, Telegram, Discord, WeChat Work, Weibo, LINE, QQ, QQ Bot (Official), Matrix, 그리고 개인 WeChat을 위한 \*\*Weixin (personal ilink)\*\*. 대부분의 플랫폼은 \*\*공인 IP가 전혀 필요하지 않습니다\*\*.
### 🔄 멀티 에이전트 오케스트레이션
\*\*멀티 봇 릴레이(Multi-Bot Relay)\*\* — 그룹 채팅에서 여러 봇을 바인딩하고 서로 소통하게 만드세요. Claude에게 물어보고 Gemini로부터 인사이트를 얻는 과정을 모두 하나의 대화 안에서 진행할 수 있습니다.
### 🎮 완벽한 채팅 제어
\*\*채팅을 통한 완전한 제어\*\* — 슬래시 명령어를 통해 모델 전환(`/model`), 추론 조정(`/reasoning`), 권한 모드 변경(`/mode`), 세션 관리를 모두 수행할 수 있습니다.
\*\*채팅 내 디렉토리 전환\*\* — `/dir `(및 호환성 별칭인 `/cd `)을 사용하여 다음 세션이 시작될 위치를 변경하고, `/dir ` / `/dir -`를 통해 빠른 기록 이동이 가능합니다.
### 🧠 영구 메모리
\*\*에이전트 메모리\*\* — 터미널을 건드리지 않고도 에이전트 지침 파일(`/memory`)을 읽고 쓸 수 있습니다.
### ⏰ 지능형 스케줄링
\*\*예약된 작업\*\* — 자연어로 cron 작업을 설정하세요. \*"매일 오전 6시에 GitHub 트렌딩 요약해줘"\* 같은 작업이 바로 실행됩니다.
### 🎤 멀티모달 지원
\*\*음성 및 이미지\*\* — 음성 메시지나 스크린샷을 전송하세요. cc-connect가 STT/TTS 및 멀티모달 전달을 처리합니다.
### 📦 멀티 프로젝트 아키텍처
\*\*멀티 프로젝트\*\* — 하나의 프로세스로 여러 프로젝트를 관리하며, 각 프로젝트마다 고유한 에이전트와 플랫폼 조합을 가집니다.
### 🌍 다국어 인터페이스
\*\*5개 언어\*\* — 영어, 중국어(간체 및 번체), 일본어, 스페인어 기본 지원. 내장된 i18n을 통해 누구나 편안하게 사용할 수 있습니다.

![飞书](docs/images/screenshot/cc-connect-lark.JPG)
![Telegram](docs/images/screenshot/cc-connect-telegram.JPG)
![微信](docs/images/screenshot/cc-connect-wechat.JPG)

*Left：Lark  |  Telegram  |  Right：Wechat*

## 📋 사전 준비 사항
> \*\*반드시 이 순서대로 설치하세요\*\* — cc-connect는 로컬 AI 코딩 에이전트를 위한 브리지이므로, cc-connect를 시작하기 \*전에\* 에이전트 CLI가 설치되어 있어야 하며 인증도 완료되어야 합니다. 이 단계를 건너뛰면 `cc-connect`가 `claudecode: claude CLI not found in PATH` (또는 선택한 에이전트에 해당하는 메시지)와 함께 종료되며, `:9820`의 웹 UI가 절대 나타나지 않습니다.
### 1️⃣ AI 에이전트 CLI 설치
브리지를 연결할 에이전트를 선택하세요. \*\*최소 하나\*\*가 필요합니다.
```bash
# Claude Code (가장 일반적임)
brew install --cask claude-code # macOS / Linux Homebrew
# 또는
npm install -g @anthropic-ai/claude-code # npm을 통한 모든 플랫폼
# OpenAI Codex
npm install -g @openai/codex
# Google Gemini CLI
npm install -g @google/gemini-cli
# iFlow CLI
npm install -g @iflow-ai/iflow-cli
# Qoder CLI
curl -fsSL https://qoder.com/install | bash
```
\*\*Cursor Agent\*\* 및 \*\*OpenCode\*\*의 경우 공식 설치 페이지를 따르세요:
- Cursor Agent: 
- OpenCode: 
바이너리가 `PATH`에 있는지 확인하세요:
```bash
claude --version # 또는: codex / gemini / opencode / qodercli / cursor-agent ...
```
### 2️⃣ 에이전트 인증
각 에이전트마다 고유한 로그인 흐름이 있습니다. 에이전트를 대화형 모드로 한 번 실행하여 홈 디렉토리에 자격 증명을 저장하도록 하세요:
```bash
claude login # 인증을 위한 브라우저가 열립니다
# 또는
codex login # /gemini / opencode auth — 에이전트 문서 참조
```
이 단계를 건너뛰면 `cc-connect`는 정상적으로 시작되지만, 에이전트가 인증 오류와 함께 모든 프롬프트를 거부하게 됩니다.
### 3️⃣ cc-connect 설치
```bash
# npm (모든 플랫폼)
npm install -g cc-connect
# Homebrew (macOS / Linux)
brew install cc-connect
# 또는 https://github.com/chenhg5/cc-connect/releases 에서 바이너리 다운로드
```
### 4️⃣ cc-connect 시작 및 웹 UI 열기
```bash
cc-connect # 서비스를 시작합니다. 최초 실행 시 ~/.cc-connect/config.toml이 자동 생성됩니다.
```
첫 실행 시 cc-connect는 다음과 같은 메시지를 출력합니다:
```
Web admin: http://localhost:9820
```
브라우저에서 해당 URL을 엽니다. `9820`이 이미 사용 중인 경우 `--web-port 9821`을 전달하거나 `config.toml`에서 `web\_port`를 설정하세요.
> \*\*참고:\*\* `cc-connect web`은 브라우저와 설정 UI만 열며, 서비스는 \*\*시작하지 않습니다\*\* 여전히 다른 터미널에서 `cc-connect`를 실행해야 합니다.
### 5️⃣ 웹 UI에서 플랫폼 봇 토큰 설정
웹 UI에서 프로젝트를 생성한 후, 최소 하나의 플랫폼(Feishu / Telegram / Discord / Slack / DingTalk / WeChat Work / QQ / LINE / Weixin)을 추가하고 해당 플랫폼의 개발자 콘솔에서 봇 토큰을 붙여넣으세요. 저장하면 cc-connect가 실시간으로 변경 사항을 반영(hot-reload)합니다.
이것으로 끝입니다. 봇에게 메시지를 보내면 cc-connect가 로컬 에이전트로 메시지를 중계해 줍니다.
---
## 🚀 빠른 시작
### 🤖 AI 에이전트를 통해 설치 및 설정하기 (권장)
> \*\*가장 쉬운 방법\*\* — Claude Code나 기타 AI 코딩 에이전트에 아래 내용을 보내면, 에이전트가 전체 설치 및 설정을 알아서 처리해 줍니다:
```bash
Follow https://raw.githubusercontent.com/chenhg5/cc-connect/refs/heads/main/INSTALL.md to install and configure cc-connect.
```
### 📦 수동 설치
\*\*npm 사용:\*\*
```bash
npm install -g cc-connect
```
\*\*Homebrew 사용 (macOS / Linux):\*\*
```bash
brew install cc-connect
```
\*\*\[GitHub Releases](https://github.com/chenhg5/cc-connect/releases)에서 바이너리 다운로드:\*\*
```bash
# 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
sudo mv cc-connect /usr/local/bin/
```
\*\*소스코드로부터 빌드 (Go 1.22+ 필요):\*\*
```bash
git clone https://github.com/chenhg5/cc-connect.git
cd cc-connect
make build
```
### ⚙️ 설정
> \*\*💡 팁: 설정 시 웹 UI 사용하기\*\* — 설치 후 `cc-connect web`을 실행하여 웹 관리자를 설정하고 브라우저에서 대시보드를 여세요. TOML 파일을 수동으로 편집할 필요 없이 시각적으로 프로젝트를 생성하고, 플랫폼을 추가하며, 제공자를 관리하고, 에이전트와 대화할 수 있습니다. \*\*참고:\*\* `cc-connect web`은 설정 및 브라우저 열기 전용이므로, 서비스를 시작하려면 별도로 `cc-connect`를 실행해야 합니다.
수동 설정을 선호하는 경우

tion:
```bash
mkdir -p ~/.cc-connect
cp config.example.toml ~/.cc-connect/config.toml
vim ~/.cc-connect/config.toml
```
프로젝트에서 `admin\_from = "alice,bob"`을 설정하면 해당 사용자 ID가 `/dir` 및 `/shell` 같은 권한이 필요한 명령을 실행할 수 있습니다.
`admin\_from`은 `[[projects]]` 아래에 배치해야 합니다 (`[projects.platforms.options]` 아래가 아님). 현재 `User ID`를 확인하려면 `/whoami` 또는 `/status`를 사용할 수 있습니다.
사용자가 `/dir reset`을 실행하면 cc-connect는 설정된 `work\_dir`을 복원하고 `data\_dir/projects/.state.json` 아래에 저장된 지속형 오버라이드를 지웁니다.
### ▶️ 실행
```bash
./cc-connect
```
### 🔄 업그레이드
```bash
# npm
npm install -g cc-connect
# Homebrew
brew upgrade cc-connect
# 바이너리 자체 업데이트
cc-connect update # 안정 버전
cc-connect update --pre # 프리릴리스 포함
```
## 📊 지원 매트릭스
| 컴포넌트 | 유형 | 상태 |
|-----------|------|--------|
| Agent | Claude Code | ✅ 지원됨 |
| Agent | Codex (OpenAI) | ✅ 지원됨 |
| Agent | Cursor Agent | ✅ 지원됨 |
| Agent | Gemini CLI (Google) | ✅ 지원됨 |
| Agent | Qoder CLI | ✅ 지원됨 |
| Agent | OpenCode (Crush) | ✅ 지원됨 |
| Agent | iFlow CLI | ✅ 지원됨 |
| Agent | Kimi CLI (Moonshot) | ✅ 지원됨 |
| Agent | Pi (Cursor Background Agent) | ✅ 지원됨 |
| Agent | Copilot (GitHub) | ✅ 지원됨 |
| Agent | ACP (Agent Client Protocol) | ✅ [ACP 호환 에이전트](https://agentclientprotocol.com/get-started/agents) |
| Agent | Devin (Cognition) | ✅ 지원됨 (ACP 경유) |
| Agent | Goose (Block) | 🔜 계획 중 |
| Agent | Aider | 🔜 계획 중 |
| Platform | Feishu (Lark) | ✅ WebSocket — 공인 IP 불필요 |
| Platform | DingTalk | ✅ Stream — 공인 IP 불필요 |
| Platform | WPS Xiezuo | ✅ WebSocket — 공인 IP 불필요 |
| Platform | Telegram | ✅ Long Polling — 공인 IP 불필요 |
| Platform | Slack | ✅ Socket Mode — 공인 IP 불필요 |
| Platform | Discord | ✅ Gateway — 공인 IP 불필요 |
| Platform | Weibo | ✅ WebSocket — 공인 IP 불필요 |
| Platform | LINE | ✅ Webhook — 공인 IP 필요 |
| Platform | WeChat Work | ✅ WebSocket / Webhook |
| Platform | Weixin (personal, ilink) | ✅ HTTP long polling — 공인 IP 불필요 |
| Platform | QQ (NapCat/OneBot) | ✅ WebSocket |
| Platform | QQ Bot (Official) | ✅ WebSocket — 공인 IP 불필요 |
| Platform | Matrix | ✅ Long Polling (/sync) — 공인 IP 불필요 |
## 📖 플랫폼 설정 가이드
| 플랫폼 | 가이드 | 연결 방식 | 공인 IP 필요 여부 |
|----------|-------|------------|------------|
| Feishu (Lark) | [docs/feishu.md](docs/feishu.md) | WebSocket | 아니오 |
| DingTalk | [docs/dingtalk.md](docs/dingtalk.md) | Stream | 아니오 |
| WPS Xiezuo | [docs/wps-xiezuo.md](docs/wps-xiezuo.md) | WebSocket | 아니오 |
| Telegram | [docs/telegram.md](docs/telegram.md) | Long Polling | 아니오 |
| Slack | [docs/slack.md](docs/slack.md) | Socket Mode | 아니오 |
| Google Chat | [docs/googlechat.md](docs/googlechat.md) | Cloud Pub/Sub | 아니오 |
| Discord | [docs/discord.md](docs/discord.md) | Gateway | 아니오 |
| Weibo | [docs/weibo.md](docs/weibo.md) | WebSocket | 아니오 |
| WeChat Work | [docs/wecom.md](docs/wecom.md) | WebSocket / Webhook | 아니오 (WS) / 예 (Webhook) |
| Weixin (개인) | [docs/weixin.md](docs/weixin.md) | HTTP long polling (ilink) | 아니오 |
| QQ / QQ Bot | [docs/qq.md](docs/qq.md) | WebSocket | 아니오 |
| Matrix | [docs/matrix.md](docs/matrix.md) | /sync (Long Polling) | 아니오 |
## 🎯 주요 기능
### 💬 세션 관리
```
/new [name] 새로운 세션 시작
/list 모든 세션 목록 표시
/switch  세션 전환
/current 현재 세션 표시
/dir [path|reset] 작업 디렉토리 표시, 전환 또는 초기화
```
프로젝트 설정은 장기간 활동이 없을 경우 자동으로 새로운 세션으로 순환됩니다. 이는 `--continue`를 통해 오래된 대화 기록(실패한 명령, 디버깅 노이즈)이 반복적으로 다시 유입되어 모델의 주의를 독점하는 "컨텍스트 표류(context drift)"를 방지합니다. 이전 세션은 보존되며 `/list` 및 `/switch`를 통해 계속 접근할 수 있습니다.
```toml
[[projects]]
reset\_on\_idle\_mins = 30 # 미설정 시 기본값; 비활성화하려면 0으로 설정
```
기본값은 \*\*30분입니다.

nutes\*\* 설정하지 않은 경우에 적용됩니다. 이전 세션을 항상 유지하고 기능을 사용하지 않으려면 `reset\_on\_idle\_mins = 0`으로 설정하세요.
### 🛡️ OS-사용자 격리 (`run\_as\_user`)
Linux/macOS에서는 프로젝트가 cc-connect를 실행하는 슈퍼바이저 사용자와 OS 수준에서 파일 시스템을 격리하기 위해, 에이전트를 다른 Unix 사용자로 실행(spawn)할 수 있습니다. 현재 Claude Code에서 지원합니다.
```toml
[[projects]]
name = "claude-sandboxed"
run\_as\_user = "partseeker-coder"
run\_as\_env = ["PGSSLROOTCERT"]
```
대상 사용자는 슈퍼바이저로부터 비밀번호 없는 sudo 권한이 필요하지만 자체 sudo 권한은 없어야 하며, `work\_dir`에 대한 읽기 및 쓰기 권한, 그리고 에이전트가 사용하는 자격 증명이 포함된 고유한 `~/.claude/settings.json`이 필요합니다. `claude.ai` OAuth를 통해 인증하는 경우, 토큰 갱신이 동기화되도록 대상 사용자의 `~/.claude/.credentials.json`을 슈퍼바이저의 복사본에 심볼릭 링크로 연결하세요. 자세한 내용은 [환경 전파 체크리스트](./docs/usage.md#environment-propagation-what-moves-into-the-target-users-home)를 참조하세요. 전체 설정 방법은 [`docs/usage.md`](./docs/usage.md#running-agents-as-a-different-unix-user-run\_as\_user)를 참조하세요.
cc-connect를 시작하기 전에 다음 명령으로 설정을 검사하세요.
```bash
cc-connect doctor user-isolation
```
이 명령어는 세 가지 사전 실행(go/no-go) 게이트와 대상 사용자가 읽을 수 있는 항목과 읽을 수 없는 항목을 보고하는 격리 프로브를 실행합니다. 게이트가 실패하거나 프로브가 사용자 간 유출을 감지하면 cc-connect는 시작을 거부합니다.
---
### 🔐 권한 모드
```
/mode Show available modes
/mode yolo # Auto-approve all tools
/mode default # Ask for each tool
```
### 🔄 프로바이더 관리
```
/provider list List providers
/provider switch  Switch API provider at runtime
```
### 🤖 모델 선택
```
/model List available models (format: alias - model)
/model switch  Switch to model by alias
```
### 📂 작업 디렉토리
```
/dir Show current work directory and history
/dir  Switch to a path (relative or absolute)
/dir  Switch from history
/dir - Switch to previous directory
/cd  Compatibility alias for /dir 
```
### ⏰ 예약된 작업
```bash
/cron add 0 6 \* \* \* Summarize GitHub trending
```
### 📎 에이전트 첨부 파일 전송 기능
에이전트가 로컬 스크린샷, 차트, PDF, 번들 또는 기타 파일을 생성하면 해당 첨부 파일을 현재 채팅으로 다시 보낼 수 있습니다.
첫 번째 릴리스에서 지원하는 항목:
- Feishu
- Telegram
에이전트가 시스템 프롬프트를 기본적으로 주입하지 않는 경우, 업그레이드 후 채팅에서 다음을 한 번 실행하세요.
```text
/bind setup
```
또는:
```text
/cron setup
```
이렇게 하면 프로젝트 메모리 파일의 cc-connect 지침이 갱신되어 에이전트가 첨부 파일을 다시 보내는 방법을 인식하게 됩니다.
`config.toml`에서 이 기능을 전역적으로 제어할 수 있습니다.
```toml
attachment\_send = "on" # default: "on"; set to "off" to block image/file send-back
```
이 스위치는 에이전트의 `/mode`와는 독립적입니다. 오직 `cc-connect send --image/--file`만 제어합니다. 음성 전송 기능은 대신 TTS 설정을 사용합니다.
예시:
```bash
cc-connect send --image /absolute/path/to/chart.png
cc-connect send --file /absolute/path/to/report.pdf
cc-connect send --file /absolute/path/to/report.pdf --image /absolute/path/to/chart.png
cc-connect send --tts "Hello from cc-connect"
```
참고사항:
- 절대 경로를 사용하는 것이 가장 안전합니다.
- `--image`와 `--file` 모두 여러 번 사용할 수 있습니다.
- `--tts`는 사용자가 음성 답변을 요청할 때 합성된 음성을 보냅니다.
- `attachment\_send = "off"`는 첨부 파일 전송 기능만 비활성화하며, 일반 텍스트 답변은 계속 작동합니다.
- 첨부 파일은 기본적으로 50 MiB로 제한되며, `max\_attachment\_size\_mb`(또는 동일한 MiB 단위의 `CC\_MAX\_ATTACHMENT\_SIZE\_MB` 환경 변수)로 설정할 수 있습니다.
- 이 명령어는 일반 텍스트 답변이 아닌 생성된 첨부 파일을 위한 것입니다.
📖 \*\*전체 문서:\*\* [docs/usage.md](docs/usage.md)
## 📚 문서
- [사용 가이드](docs/usage.md) — 전체 기능 문서
- [INSTALL.md](INSTALL.md) — AI 에이전트 친화적인 설치 가이드
- [config.example.toml](config.example.toml) — 설정 템플릿
- [CONTRIBUTING.md](CONTRIBUTING.md) — 문제 신고 및 풀 리퀘스트 기여 방법
## 👥 커뮤니티
- [Discord](https://discord.gg/kHpwgaM4kq)
- [Telegram](https://t.me/

me/+odGNDhCjbjdmMmZl)
## ☕ 프로젝트 후원하기
cc-connect가 도움이 되었다면 커피 한 잔을 후원해 주세요! 보내주신 후원은 다음과 같은 활동에 사용됩니다:
- 🛠️ 프로젝트 유지보수 및 개선
- 📚 더 나은 문서 및 튜토리얼 작성
- 🐛 버그 수정 및 새로운 기능 신속 추가
- ☕ 개발자들이 카페인을 유지하며 코딩할 수 있도록 지원
### 후원 방법
\*\*Buy Me a Coffee\*\*: [https://buymeacoffee.com/cg33](https://buymeacoffee.com/cg33)
\*\*WeChat Pay / Alipay\*\*:
| WeChat Pay | Alipay |
|:----------:|:------:|
| ![WeChat Pay](docs/images/wechatpay.jpg) | ![Alipay](docs/images/alipay.jpg) |
### 후원해 주신 분들께 감사드립니다! 🎉
이 프로젝트를 지원해 주신 모든 분께 감사드립니다. 이곳에 이름을 올리고 싶으시다면 후원 메시지에 GitHub 사용자 이름을 남겨주세요!
| 프로필 이미지 | GitHub 사용자 이름 | 날짜 |
|--------|-----------------|------|
| ![](https://avatars.githubusercontent.com/u/1762560?v=4) | [@thx0701](https://github.com/thx0701) | 2026-04-29 |
## 🤝 상업적 제휴
다음과 같은 상업적 제휴를 환영합니다:
- \*\*기업 맞춤화\*\*: 내부 AI 툴링(Feishu, DingTalk, WeChat Work, Slack 등)을 위한 맞춤형 배포
- \*\*기술 컨설팅\*\*: AI agent 통합 및 아키텍처 설계
- \*\*외주 프로젝트\*\*: AI 관련 시스템 개발
\*\*연락처\*\*: \*\*Email\*\*: chg80333@gmail.com | \*\*WeChat\*\*: mongorz | [Telegram](https://t.me/+odGNDhCjbjdmMmZl) | [Discord](https://discord.gg/kHpwgaM4kq)
## 🙏 기여자
[![](https://contrib.rocks/image?repo=chenhg5/cc-connect&v=20250313)](https://github.com/chenhg5/cc-connect/graphs/contributors)
## ⭐ Star History
[![Star History Chart](https://api.star-history.com/svg?repos=chenhg5/cc-connect&type=Date)](https://www.star-history.com/#chenhg5/cc-connect&Date)
## 📄 라이선스
MIT License

cc-connect 커뮤니티에서 ❤️를 담아 만들었습니다.

cc-connect

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

cc-connect

파일 탐색기

오늘의 추천 프로젝트

Was this content helpful?

Recent Feedback

Download README