Skip to content

cc-connect:将Claude Code装进手机的开源工具完整教程

2026年5月9日

可以想象一下,你在外面,突然想起有个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实时双向通信

快速上手

前提条件

  1. 一台电脑(运行 cc-connect 和 Claude Code)
  2. 一个飞书企业(个人版也行)
  3. 手机安装飞书

步骤一:安装 Claude Code CLI

bash
# macOS/Linux
npm install -g @anthropic-ai/claude-code

# 验证安装
claude-code --version

步骤二:安装 cc-connect

bash
npm install -g cc-connect

步骤三:配置飞书机器人

  1. 打开 飞书开放平台
  2. 创建企业自建应用
  3. 获取 App ID 和 App Secret
  4. 配置机器人能力
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

不要孤军奋战啦!

加入微信群一起学习交流 AI

与大神一起使用 OpenClaw、Hermes、Claude Code、Seedance 2.0、GPT-Image-2 等

微信公众号

扫码关注微信公众号
私信 "加群",将自动获取微信群二维码

探索 AI 世界,掌握智能未来