Appearance
可以想象一下,你在外面,突然想起有个bug没改。又没有带电脑,用手机发条消息给飞书里的机器人。20分钟后,bug被修好了。 代码是在手机端下的单,但真正执行它的是你书房里那台电脑——通过一个叫
cc-connect的开源工具。
痛点太痛
先说这批人的通病。
Claude Code 这东西真香,只要你坐在电脑前。但问题在于——你不能一直坐在电脑前。
出门吃饭、出差路上、躺在床上……这些场景里,Claude Code 是无能为力的。
试过用远程桌面、向日葵、TeamViewer、UU远程,那体验简直是灾难:
- 画面卡顿
- 操作延迟
- 屏幕太小点不到按钮
每次操作都像在拧一个生锈的螺丝。
它是什么
cc-connect 是一个开源代理工具,把 Claude Code 接进飞书(或者其他聊天软件),让你在手机上通过聊天就能操控它。
用手机发一条消息给飞书机器人,机器人把指令传给本地电脑的 Claude Code,Claude Code 读你的项目文件、执行命令、改代码,结果再传回手机。
整个过程,你只需要手机操作。
项目 GitHub:7.8k stars,MIT 协议开源。
原理不复杂
飞书机器人 ←→ cc-connect(本地)←→ Claude Code CLI ←→ 项目代码| 组件 | 作用 |
|---|---|
| 飞书机器人 | 接收手机消息,发送结果 |
| cc-connect | 本地代理,转发指令 |
| Claude Code CLI | 读取文件、执行命令、改代码 |
| WebSocket | 实时双向通信 |
快速上手
前提条件
- 一台电脑(运行 cc-connect 和 Claude Code)
- 一个飞书企业(个人版也行)
- 手机安装飞书
步骤一:安装 Claude Code CLI
bash
# macOS/Linux
npm install -g @anthropic-ai/claude-code
# 验证安装
claude-code --version步骤二:安装 cc-connect
bash
npm install -g cc-connect步骤三:配置飞书机器人
- 打开 飞书开放平台
- 创建企业自建应用
- 获取 App ID 和 App Secret
- 配置机器人能力
yaml
# ~/.cc-connect/config.yaml
feishu:
app_id: "cli_xxxxxxxxx"
app_secret: "xxxxxxxxxxxxx"
server:
port: 8080
host: "0.0.0.0"步骤四:启动服务
bash
# 在电脑端启动
cc-connect start
# 指定工作目录
cc-connect start --directory ~/projects/myapp步骤五:连接飞书
在飞书里给机器人发消息:
/connect看到"已连接"回复就成功了。
使用示例
日常对话
你:帮我看看这个bug是怎么回事
机器人:让我分析一下...
你:修复这个bug
机器人:已修复,修改了 src/utils.js 第23行...查看代码
你:列出当前目录的文件
机器人:
- src/
- package.json
- README.md
- tests/执行命令
你:运行 npm test
机器人:执行中...
✅ 测试通过,32个测试全部通过配置选项
多项目切换
yaml
# ~/.cc-connect/config.yaml
projects:
- name: myapp
path: ~/projects/myapp
description: 主项目
- name: blog
path: ~/projects/blog
description: 个人博客使用:
你:/switch blog
机器人:已切换到 blog 项目安全设置
yaml
# 限制执行危险命令
security:
allow_destructive: false
allowed_commands:
- npm
- git
- node
blocked_patterns:
- "rm -rf /"
- "DROP TABLE"Webhook 配置
yaml
# 完成后自动通知
notifications:
on_complete: true
on_error: true
summary_length: 500踩坑记录
坑1:连接断开
问题:长时间不操作后连接断开。
解决:配置心跳:
yaml
server:
heartbeat_interval: 30坑2:中文编码问题
问题:代码里的中文注释乱码。
解决:
bash
export LANG=zh_CN.UTF-8
cc-connect start坑3:权限不足
问题:无法写入文件。
解决:
bash
# 检查目录权限
ls -la ~/projects/myapp
# 修复权限
chmod -R 755 ~/projects/myapp进阶玩法
配合 Claude Pro 使用
yaml
# 使用 Claude Pro
claude_code:
model: claude-opus-4-5
max_tokens: 4096自动任务
yaml
# 定时任务
tasks:
- name: 每日构建
schedule: "0 9 * * *"
command: "npm run build"多端同步
配置多个 cc-connect 实例,实现手机和电脑无缝切换。
总结
一句话:把 Claude Code 装进手机,随时随地改bug。
适合场景:
- 出差路上改紧急bug
- 躺在床上突然有灵感
- 出门忘带电脑的焦虑症患者
核心价值:
- 手机聊天 → 操控 Claude Code
- 20分钟 → 远程修好bug
- 7.8k stars → 成熟稳定
安装命令:
bash
npm install -g cc-connect