我们似乎Yi经习惯了把繁琐的代码丢给 AI 处理。但是你有没有遇到过这种尴尬的时刻：周末正和朋友在咖啡馆享受拿铁，手机突然狂震——线上服务挂了或者老板突然要kan一个紧急的数据分析报告。这时候，你不得不掏出沉重的笔记本电脑，连上那忽快忽慢的公共 WiFi，满头大汗地开始修 Bug。

Ru果我说其实你只需要掏出手机，在熟悉的飞书里发一条消息，家里的电脑就会自动开始工作、修 Bug、跑脚本，甚至把结果截图发回给你，你会不会觉得这简直是科幻电影？

Zui近，GitHub 上一个名为 cc-connect 的开源项目火了。它另辟蹊径，利用飞书开放平台的长连接Neng力，充当了“本地 AI Agent”与“即时通讯工具”之间的桥梁。这意味着，你无需公网 IP，无需复杂的内网穿透工具，就Neng把运行在你台式机上的 Claude Code 变成随叫随到的远程助手。今天我们就来深度拆解一下如何搭建这套“远程指挥系统”。

为什么我们需要“远程指挥”Claude Code？

在此之前，你可Neng听说过向日葵或者 TeamViewer 这类远程控制软件。没错，它们Neng解决问题，但体验实在算不上“优雅”。你需要传输画面、忍受延迟，还得时刻盯着屏幕。而 cc-connect 带来的是一种完全不同的交互范式：基于文本的异步控制。

想象一下这样的场景：

解放双手： 你正在Zuo饭，突然想到代码里有个逻辑漏洞。对着手机语音输入一句“帮我检查 UserAuth.js 里的权限逻辑”，几秒钟后飞书里就弹出了详细的修复建议。

自动化运维： 不需要写复杂的 Jenkins 脚本，直接在飞书里输入“每天早上 6 点 GitHub Trending”，Claude Code 就会自动为你生成定时任务。

多模态交互： 电脑上生成的图表、PDF 报告，甚至报错截图，douNeng直接作为附件回传到你的手机聊天窗口。

这不仅仅是远程控制，这是把你的本地开发环境“投影”到了云端，让你随时随地douNeng指挥那个Zui懂你代码的 AI 打工。

核心原理：cc-connect 是如何工作的？

在开始动手之前，我们需要理解这套系统的运作逻辑。简单来说cc-connect 就是一个中间件。

传统的远程控制需要你的电脑有公网 IP，或者你得去配置路由器的端口映射，这对hen多新手来说简直是噩梦。而 cc-connect 利用飞书开放平台的长连接 WebSocket Neng力，建立了一条从“云端”到“本地”的专属通道。

整个数据流向是这样的：

指令下发： 你在手机飞书 App 给机器人发消息。

云端接收： 飞书服务器接收到消息，通过长连接推送到你本地运行的 cc-connect 进程。

本地执行： cc-connect 解析指令，调用本地的 Claude Code进行思考、读写文件、执行命令。

结果回传： 执行结果、日志、生成的文件，再顺着原路返回到你的飞书聊天界面。

Zui妙的是这一切dou不需要你拥有公网 IP，也不需要购买域名。只要你的电脑Neng上网，Neng连上飞书，这套系统就Neng跑起来。

第一步：环境准备与安装

好了原理讲完了让我们卷起袖子开始干吧。整个过程其实比你想象的要简单得多，尤其是Ru果你Yi经习惯了使用 Node.js 开发环境。

1. 前置检查

确保你的电脑上Yi经安装了 Node.js 和 npm。毕竟 cc-connect 是基于 Node.js 编写的。打开你的终端，输入以下命令验证：

node -v
npm -v

Ru果Nengkan到版本号输出，那就没问题。Ru果没有，赶紧去官网下载一个 LTS 版本安装上。

2. 安装 cc-connect

安装过程非常直接，使用 npm 的全局安装命令即可。这也是后续升级该工具的通用命令：

npm install -g cc-connect

当你kan到终端里滚动的日志Zui终显示 "added packages" 之类的字样时恭喜你，核心组件Yi经就位了。为了方便后续管理，建议你运行一下内置的管理后台：

cc-connect web

这会打开一个可视化的 Web UI，虽然我们后续主要讲配置文件的方法，但这个界面在管理多个项目时非常有用。

第二步：飞书开放平台配置

这是整个流程中唯一稍微繁琐一点的步骤，但别担心，我们一步步来。我们需要给 Claude Code 发一张“工牌”，让它以机器人的身份入驻飞书。

1. 创建企业自建应用

登录飞书开放平台，创建一个“企业自建应用”。给它起个酷一点的名字，比如“Claude 助手”或者“代码终结者”。创建完成后你会kan到 App ID 和 App Secret，这两个字符串非常重要，相当于账号密码，请妥善保管。

2. 开启机器人Neng力

在应用的“权限管理”页面你需要给机器人开通必要的权限。为了让它Neng收发消息，至少要开通以下权限：

im:message

im:message:send_as_bot

此外为了支持卡片交互和geng丰富的功Neng，建议把 im:chat 相关的权限也一并打开。

3. 事件订阅

hen多新手在这里会踩坑。你需要去“事件订阅”配置项，添加两个关键事件：im.message.receive_v1和 application.bot.menu_v1。

这里有一个巨大的优势：cc-connect 使用的是长连接模式，所以你不需要配置 HTTP 回调 URL。你只需要在飞书后台“订阅”这些事件即可。这解决了困扰无数开发者的“内网穿透”问题。

Ru果你在测试过程中遇到了 ERR-CODE: 200340，这通常意味着事件订阅没有正确配置，或者应用没有发布到对应的版本里。记得检查一下事件订阅列表里是否真的勾选了那些消息接收事件。

第三步：配置 config.toml

现在我们要把飞书应用和你的本地项目“缝合”在一起。cc-connect 的所有配置dou集中在一个名为 config.toml 的文件里。

1. 创建配置文件

在你的用户目录下新建一个 config.toml 文件。你Ke以手动创建这个文件夹和文件。

2. 填写配置项

这是一个典型的配置模板，我为你加上了详细的注释，你Ke以直接复制并修改其中的关键信息：

# 项目配置段
]
name = "my-ai-workspace"  # 给你的项目起个名
# Agent 配置：告诉 cc-connect 要调用谁
agent = "claudecode"      # 这里指定使用 Claude Code
# Windows 用户注意：路径分隔符建议用双反斜杠或者正斜杠
workdir = "C:/Users/你的用户名/Documents/MyCode"
mode = "default"          # 模式：default, auto 等
# 飞书平台配置段
]
type = "feishu"
# 填入你在飞书开放平台获取的 App ID 和 Secret
app_id = "cli_axxxxxxxxxxxx"
app_secret = "QhkMpxxxxxxxxxxxxxxxxxxxx"
# 可选配置项
# domain = "https://open.feishu.cn"  # Ru果你是飞书海外版，可Neng需要修改域名
# enable_feishu_card = true         # 是否启用富文本卡片回复
# attachment_send = "on"             # 是否允许 AI 把生成的图片/文件发回给你

Ru果你觉得手写配置文件太麻烦，cc-connect 其实提供了一个超级方便的命令行向导。你Ke以直接在终端运行：

cc-connect feishu setup --project my-project

它会自动引导你输入 App ID 和 Secret，并帮你把配置写回 config.toml，省去了手动编辑文件的麻烦。

第四步：启动与测试

配置dou搞定了吗？那让我们见证奇迹的时刻。

1. 启动守护进程

在终端输入以下命令启动服务：

cc-connect daemon start --config ~/.cc-connect/config.toml

Ru果一切顺利，你应该会kan到类似 "Daemon started" 的提示。这时候，cc-connect 就在后台悄悄运行了它正在尝试与飞书服务器建立长连接。

2. 开始对话

打开飞书 App，找到你刚才创建的那个企业自建应用机器人。给它发个消息试试：

你好

Ru果它回复了你，说明链路Yi经通了！这时候，你Ke以试着发一个真正的开发指令：

帮我在当前目录下写一个 hello world 的 Python 文件

几秒钟后刷新你的项目目录，你应该Nengkan到一个崭新的 hello.py 文件躺在那里。是不是hen神奇？你甚至没有打开编辑器！

进阶玩法：像黑客一样指挥 AI

仅仅Neng写代码还不够，cc-connect 结合 Claude Code 的强大之处在于，它支持一系列复杂的“斜杠命令”，让你在聊天界面就Neng完成终端级别的操作。

📂 目录跳转与文件管理

在聊天窗口里你不需要 cd 命令，而是使用geng智Neng的 /dir

/dir C:/Users/Admin/Desktop
/dir -   # 返回上一个目录
/dir 1   # 快速跳转到历史记录里的第1个目录

这对于管理多个项目目录非常有用，你不需要记住复杂的绝对路径，只需要像在浏览器里一样来回切换。

🤖 模型与 Provider 切换

有时候你觉得 Claude 3.5 Sonnet 太慢，或者想换个模型试试，直接在聊天里切：

/model switch claude-3-5-sonnet
/provider list

这种动态切换Neng力，让你Ke以在不同的任务之间灵活调整 AI 的“大脑”。

⏰ 定时任务

这是我个人的Zui爱功Neng。你Ke以用自然语言创建定时任务。比如你想每天早上kankan GitHub 上有什么热门项目：

/cron add * * * 帮我 GitHub trending

设置好后Claude Code 就会乖乖地在每天那个时间点自动工作，并把结果推送到飞书。这简直就是把你的电脑变成了一个 24 小时待命的智Neng秘书。

📎 文件与图片回传

当 AI 在本地执行完任务，生成了截图、日志包或者分析图表时它不会傻傻地只告诉你“文件Yi生成”。通过配置 attachment_send = "on"，它会直接把文件作为附件发回飞书聊天窗口。你Ke以直接在手机上预览、下载，或者转发给同事。

常见问题与排错指南

在折腾这套系统的过程中，难免会遇到一些小插曲。这里我列几个大家Zui容易碰到的问题。

Q: 飞书机器人一直不回消息，或者报错 20029？

A: 这通常是 OAuth 重定向 URI 的问题。检查一下飞书开放平台里的“重定向 URL”设置，确保没有填错。另外确认你的 App Secret 没有多余的空格。

Q: 如何让它在开机时自动启动？

A: Ru果你用的是 Windows，不想每次开机dou手动敲命令，Ke以把 cc-connect 注册成系统服务。在 PowerShell下运行：

cc-connect daemon install --config ~/.cc-connect/config.toml

这样，即使电脑重启，你的远程指挥中心也会自动上线。

Q: 支持微信吗？

A: cc-connect 本身支持多种平台，包括 Discord、Telegram 等。至于微信，由于微信个人号的协议限制，直接接入比较复杂，但社区里有一些基于类似思路的 wechat-claude-code 方案，原理是相通的：桥接 IM 和本地 Agent。

从“工具人”到“指挥官”的蜕变

通过 cc-connect 将 Claude Code 接入飞书，我们不仅仅是在玩一个酷炫的 Geek 玩意，geng是在重塑工作流。以前，你需要守在电脑前，等待编译、等待测试、等待结果；现在你只需要动动嘴，AI 就会在后台默默为你处理一切。

代码审查、资料研究、自动化脚本、数据分析……只要 AI Agent NengZuo的事，现在douKe以通过手机、平板完成。这种“随时随地，随心所欲”的控制感，一旦体验过就真的回不去了。

所以别犹豫了。趁着周末，花半小时把这套系统搭起来吧。下次当你躺在沙发上指挥家里的电脑写代码时你会感谢今天动手的自己。毕竟未来的编程方式，可Neng就是这样“聊天”而Yi。

---