cc-connect:IM ↔ Claude Code 桥接工具
概述
cc-connect(575 stars, Go, MIT)是一个轻量的 IM ↔ AI 编码 Agent CLI 桥接工具。它不是独立 AI Agent,而是纯粹的消息转发器:从 IM 收到消息 → spawn 本地 claude CLI 执行 → 结果回复到 IM。
核心架构
飞书/TG/Slack ──[WebSocket]──> cc-connect (Go) ──[CLI subprocess]──> claude --print (stream-json)
↓
结果回复 IM
- 不是 AI Agent:自身没有 LLM 推理,纯转发
- CLI subprocess 方式:spawn
claude二进制,通过 stdin/stdout 用 stream-json 协议通信 - 支持
--resume:多轮对话通过 session ID 续接
支持的平台
| IM 平台 | 连接方式 | 需要公网 IP |
|---|---|---|
| 飞书/Lark | WebSocket | 否 |
| 钉钉 | Stream | 否 |
| Telegram | Long Polling | 否 |
| Slack | Socket Mode | 否 |
| Discord | Gateway | 否 |
| 企业微信 | Webhook | 是 |
| LINE | Webhook | 是 |
| QQ (NapCat) | WebSocket | 否 (Beta) |
| QQ Bot | WebSocket | 否 |
支持 7 种 Agent CLI:Claude Code、Codex、Gemini CLI、Cursor、Qoder、OpenCode、iFlow。
核心功能
- 多项目管理:每个
[[projects]]绑定不同工作目录和 IM 频道 - 内置 cron:
/cron add 0 6 * * * "prompt"定时执行任务 - Session 管理:
/new、/list、/switch、/history - Provider 切换:运行时
/provider switch切换不同模型 - 语音:STT(Whisper)+ TTS(飞书支持)
- Daemon 模式:systemd/launchd 部署
配置示例
# ~/.cc-connect/config.toml
[[projects]]
work_dir = "~/Workspace/sean2077/obsidian-vault/2B 职业发展/resume"
agent = "claudecode"
[projects.channel]
type = "feishu"
app_id = "cli_xxx"
app_secret = "xxx"与 claw 系列的本质区别
| 维度 | cc-connect | claw 系列 (OpenClaw/ZeroClaw) |
|---|---|---|
| 本质 | IM ↔ CLI 桥接器(遥控器) | 自主 AI Agent(独立大脑) |
| 有无”大脑” | 否,纯转发 | 有自己的 LLM 推理 |
| 执行层 | 依赖 claude/codex CLI | 自带 shell/file/git 工具链 |
| 认证 | 用本地 CLI 认证(Max 订阅) | 需独立 API key |
| 额外成本 | 零 | 有(API 费) |
| 自主性 | 低 | 高 |
| 项目配置继承 | 完全继承 CLAUDE.md/MCP | 需单独配置 |
cc-connect 的优势
- 零额外成本(用 Max 订阅)
- 继承 Claude Code 全部能力(CLAUDE.md、MCP、Playwright)
- 轻量,就是个桥接器
cc-connect 的不足
- 无自主行为(必须你主动发消息)
- 无跨 session 记忆
- 无智能路由(不会判断该用哪个 agent)
- 无任务编排(不能自动拆解复杂任务)
- ToS 灰色地带(第三方进程调用 claude CLI)
与同类工具对比
| 工具 | 类型 | 调用方式 | 飞书 | 多项目 | Cron | 成本 |
|---|---|---|---|---|---|---|
| cc-connect | CLI 桥接 | CLI subprocess | ✅ | ✅ | ✅ | 0 |
| Claude-to-IM-skill | Claude Code skill | Agent SDK | ✅ | ❌ | ❌ | 0 |
| cjj198909/feishu-claude-code | 飞书 bot | Agent SDK | ✅ | ✅ | ❌ | API 费 |
| joewongjc/feishu-claude-code | 飞书 bot | CLI subprocess | ✅ | ❌ | ❌ | 0 |
ToS 合规性说明
Anthropic 2026-02 政策:OAuth(Max/Pro 订阅)仅限 Claude Code CLI 和 claude.ai 使用。
- cc-connect spawn 的是
claude二进制本身(不是 Agent SDK),比 SDK 方式更接近”直接用 Claude Code” - 但作为第三方进程调用 claude CLI,严格来说仍属灰色地带
- 如需完全合规,需配置
ANTHROPIC_API_KEY(额外付费)
升级路径
cc-connect(IM 桥接)
→ cc-connect + claw 层(DeepSeek 做智能路由)
→ 纯 claw(完全自主 agent)