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
飞书/LarkWebSocket
钉钉Stream
TelegramLong Polling
SlackSocket Mode
DiscordGateway
企业微信Webhook
LINEWebhook
QQ (NapCat)WebSocket否 (Beta)
QQ BotWebSocket

支持 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-connectclaw 系列 (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-connectCLI 桥接CLI subprocess0
Claude-to-IM-skillClaude Code skillAgent SDK0
cjj198909/feishu-claude-code飞书 botAgent SDKAPI 费
joewongjc/feishu-claude-code飞书 botCLI subprocess0

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)

相关链接