予枫个人主页 个人专栏: 《Java 从入门到起飞》《读研码农的干货日常》《Java 面试刷题指南》 Debug 这个世界Return 更好的自己不用守在电脑前通过微信、飞书或钉钉随时远程指挥 Claude Code、Codex、Gemini CLI 等本地 AI Agent 干活。最近有同学问我能不能在企业微信或者飞书里使用 Claude Code最开始我想到的是自己写一个机器人通过 WebSocket 把聊天消息转发给本地的 Claude Code。但深入了解后我发现已经有一个相对完整的开源方案——cc-connect。它不仅支持 Claude Code还可以接入 Codex、Gemini CLI、Cursor Agent 等多种 AI 编程工具聊天平台方面则覆盖微信、飞书、钉钉、Telegram、Slack、Discord 等常用工具。本文将介绍cc-connect 是什么它解决了哪些问题如何完成本地安装如何接入飞书和微信如何设置工作目录、权限和访问控制如何配置后台运行与开机自启日常使用中有哪些常用命令。如果你希望把本地 AI Agent 变成一个随时可调用的“远程开发助手”可以按照本文一步一步完成配置。一、cc-connect 是什么cc-connect 是一个连接AI Agent和即时通讯工具的桥接器也可以理解为一个通信中枢。它负责把聊天软件中的消息转发给运行在本地电脑上的 AI Agent再把 Agent 的执行结果发送回聊天软件。项目地址https://github.com/chenhg5/cc-connect整体链路非常简单微信 / 飞书 / 钉钉 / Telegramcc-connectClaude Code / Codex / Gemini CLI本地代码仓库与操作系统换句话说你可以把原本只能在终端里使用的 Claude Code变成微信或飞书里的聊天机器人。例如你在手机上发送检查一下今天提交的代码看看有没有明显的安全问题。家里或者办公室电脑上的 Claude Code 可以自动进入指定项目目录执行git diff阅读修改过的代码分析潜在问题把检查结果返回到微信或飞书。整个过程中你不需要远程连接电脑也不需要一直守在终端前。二、cc-connect 解决了什么问题Claude Code、Codex、Gemini CLI 等 AI 编程工具已经非常强大但它们通常存在几个使用限制主要在终端中运行必须连接开发机器离开电脑后不方便继续操作长任务执行过程中不容易随时补充要求多台设备之间缺少统一的交互入口。cc-connect 的核心价值就是把 AI Agent 的操作入口从终端扩展到手机聊天软件。场景一远程检查代码下班以后你突然想到今天提交的代码可能存在问题可以直接在微信中发送检查今天的代码改动重点关注 SQL 注入、权限校验和敏感信息泄露。Claude Code 可以在本地仓库中执行gitdiffgitstatus然后阅读相关文件并返回分析报告。场景二让 AI 持续执行长任务你可以在路上发送分析这个仓库的整体架构整理主要模块、调用关系和潜在技术债生成一份 Markdown 报告。Agent 可以继续在电脑上完成搜索代码阅读项目文档分析目录结构执行必要的命令生成分析报告。任务完成后结果会直接返回聊天软件。场景三远程排查故障在飞书中发送帮我检查最近一次 CI 为什么失败不要修改代码先给出原因和解决方案。Agent 可以读取日志、检查构建脚本和依赖配置再把排查结果返回。场景四远程推进写作和调研任务cc-connect 不只能用于写代码。只要 Agent 能完成的工作都可以通过聊天软件发起例如整理技术方案阅读和总结资料生成博客初稿分析数据文件更新项目文档执行自动化脚本汇总每日工作进度。三、cc-connect 有哪些特点1. 支持多种 AI Agent根据项目提供的能力cc-connect 可以连接多种主流 AI 编程工具例如AI Agent支持情况Claude Code✅Codex✅Gemini CLI✅Cursor Agent✅Kimi CLI✅OpenCode✅Qoder CLI✅Pi Agent✅DevinACP✅其他 ACP Agent✅这意味着你不必被限制在某一个模型或某一个编程工具中。你甚至可以给不同 Agent 分配不同职责Claude 分析代码逻辑 Gemini 评审技术方案 Codex 给出修复建议2. 支持多种聊天平台cc-connect 支持的聊天平台包括微信飞书钉钉企业微信TelegramSlackDiscordLINEQQQQ 官方机器人微博私信WPS 协作。具体支持范围和接入方式可能随项目版本变化建议以项目最新文档为准。3. 多数场景不要求公网 IP很多传统机器人方案需要准备公网服务器HTTPS 证书Webhook 地址独立域名反向代理。cc-connect 在部分平台中可以使用 WebSocket、长轮询或 Socket Mode 建立连接因此可以直接运行在家里的 Mac Mini办公室电脑Linux 主机NAS常驻在线的开发机。对于个人开发者来说这可以明显降低部署门槛。4. 支持多会话管理cc-connect 提供了多会话管理能力。你可以为不同任务创建独立会话/new 修复登录接口超时问题再通过命令查看或切换会话/list /switch 2 /current /history 10比较推荐的习惯是一个任务对应一个会话。不要使用“临时”“测试”这种难以识别的名字而是直接描述任务例如/new 分析订单服务内存泄漏 /new 重构用户权限模块 /new 整理本周技术周报5. 支持切换工作目录你可以通过聊天命令切换 Agent 当前操作的目录/dir ~/workspace/project-a也可以查看当前目录/dir恢复到配置文件中的默认目录/dir reset6. 支持定时任务例如你可以让 Agent每天早上汇总 GitHub Trending每晚整理当天提交记录每周生成项目进展报告定期检查服务日志定时执行代码质量检查。本质上是把聊天指令、AI Agent 和系统任务调度组合在了一起。7. 支持图片、文件和语音部分平台可以向 Agent 发送图片截图文档代码文件语音消息。例如线上系统报错时可以直接把截图发给机器人分析一下截图里的报错告诉我可能的原因和排查步骤。语音输入也非常适合移动场景。提前设置好目录、权限和项目后走在路上也可以直接通过语音推进任务。8. 提供 Web 管理后台可以通过下面的命令启动管理界面cc-connect web在浏览器中完成项目管理Agent 管理Provider 管理聊天平台配置定时任务配置会话监控网页聊天。需要注意cc-connect web主要用于配置和管理不等于启动桥接服务。配置完成后仍然需要运行cc-connect或者通过 daemon 模式启动后台服务。四、本地安装 cc-connect方式一让 Claude Code 自动安装如果你已经安装了 Claude Code可以直接把下面这段话发给它请参考下面的安装文档帮我安装和配置 cc-connect https://raw.githubusercontent.com/chenhg5/cc-connect/refs/heads/main/INSTALL.mdClaude Code 会根据官方文档检查环境并执行安装。这种方式最省事也更适合不想手动处理依赖的用户。方式二使用 npm 安装手动安装可以执行npminstall-gcc-connect安装完成后检查版本cc-connect--version如果能够正常输出版本号说明安装成功。方式三在 macOS 上使用 HomebrewmacOS 用户也可以使用 Homebrewbrewinstallcc-connect同样可以通过下面的命令检查cc-connect--version“3 分钟部署”主要指本地安装和启动流程。创建飞书应用、扫码授权以及权限审批所需时间取决于具体平台和账号环境。五、接入飞书机器人第一步创建飞书应用打开飞书开放平台https://open.feishu.cn/app创建一个机器人或智能体应用。建议按照接入的 Agent 命名例如Home ClaudeClaude Code BotCodex AssistantDev Agent。创建完成后记录应用的App IDApp Secret。配图建议飞书开放平台创建应用页面。第二步执行配置命令在本地终端中执行cc-connect feishu setup\--projecthome-claude\--appcli_xxx:sec_xxx其中home-claude是项目名称cli_xxx替换为飞书 App IDsec_xxx替换为飞书 App Secret。第三步重启服务cc-connect daemon restart然后在飞书中给机器人发送/help如果机器人能够正常回复说明飞书已经接入成功。六、接入微信个人微信可以通过对应的 setup 命令完成配置cc-connect weixin setup--projecthome-claude执行后终端通常会显示登录二维码可复制的授权地址当前登录状态。使用手机微信扫码或者打开授权地址完成登录确认。认证信息会被写入配置文件~/.cc-connect/config.toml完成授权后重启服务cc-connect daemon restart然后在微信中向机器人发送一条测试消息例如/help能够正常回复就说明连接成功。个人微信接入方式可能受到平台规则、账号状态和项目版本影响。需要更高稳定性时建议优先选择飞书、钉钉或企业微信等官方机器人通道。七、配置项目工作空间cc-connect 的主要配置文件位于~/.cc-connect/config.toml第一次运行时程序会自动生成配置模板。也可以使用 Web 管理后台配置cc-connect web一个基础项目配置示例如下[[projects]] name home-claude [projects.agent] type claudecode [projects.agent.options] work_dir /Users/you/Workspace/your-project mode default其中work_dir决定 Agent 默认在哪个目录工作。配置完成后即使你人在外面Agent 也会直接进入正确的项目目录不需要每次手动切换。为不同项目创建独立配置建议给每个常用项目创建独立的 project[[projects]] name main-project [projects.agent] type claudecode [projects.agent.options] work_dir /Users/you/Workspace/main-project mode default [[projects]] name blog [projects.agent] type claudecode [projects.agent.options] work_dir /Users/you/Workspace/blog mode default这样可以避免多个项目之间的上下文、工作目录和任务互相干扰。八、权限模式怎么选权限配置是远程使用 cc-connect 时最需要关注的部分。常见模式包括模式说明default工具调用通常需要确认acceptEdits文件编辑自动通过其他高风险操作仍需确认plan只生成方案不直接执行bypassPermissions/yolo自动通过全部操作远程使用时建议默认配置为[projects.agent.options] mode default因为在手机上很难完整查看 Agent 的每一步操作长期使用全自动权限存在较高风险。对于明确、低风险的任务可以临时切换/mode yolo任务完成后立即切回/mode default以下任务不建议使用全自动模式删除大量文件修改生产配置执行数据库变更提交或推送代码安装来源不明的软件包运行无法确认内容的脚本操作生产服务器。九、配置访问控制远程 Agent 能够读取文件、执行命令因此一定要限制使用者。示例配置[[projects]] name home-claude admin_from 你的用户ID [projects.platforms.options] allow_from 你的用户ID或可信群ID其中allow_from控制哪些用户或群可以给机器人发送指令admin_from控制哪些用户可以执行切目录、Shell、重启等高风险操作。不要这样配置admin_from *推荐原则allow_from可以配置为可信群或可信成员admin_from最好只配置自己的用户 ID。如果机器人加入了多人群聊还要注意提示词注入和误操作风险不要让陌生成员能够直接执行系统命令。十、敏感信息不要写死在配置文件中API Key、App Secret 等敏感信息建议通过环境变量引用api_key ${ANTHROPIC_API_KEY} app_id ${FEISHU_APP_ID} app_secret ${FEISHU_APP_SECRET}然后在系统环境中设置变量exportANTHROPIC_API_KEY你的 API KeyexportFEISHU_APP_ID你的飞书 App IDexportFEISHU_APP_SECRET你的飞书 App Secret相比直接写入配置文件这种方式可以降低密钥被误提交到 Git 仓库的风险。同时建议将以下文件加入.gitignore.cc-connect/ config.toml .env十一、后台运行与开机自启远程使用不能依赖手动打开终端所以需要把 cc-connect 配置为后台服务。执行cc-connect daemoninstall--config~/.cc-connect/config.toml cc-connect daemon start在不同系统中后台服务可能会使用macOSlaunchdLinuxsystemd。常用管理命令如下# 查看服务状态cc-connect daemon status# 实时查看日志cc-connect daemon logs-f# 重启服务cc-connect daemon restart# 停止服务cc-connect daemon stop出门前建议完成两项检查cc-connect daemon status确认后台服务正常后再在飞书或微信中发送/help机器人能够正常回复就可以远程使用了。十二、常用命令整理1. 会话管理创建新会话/new 修复登录接口超时查看已有会话/list切换到指定会话/switch 2查看当前会话/current查看最近消息/history 102. 工作目录与模型查看当前工作目录/dir切换目录/dir ~/workspace/project-a恢复默认目录/dir reset查看当前模型/model切换模型/model switch sonnet查看权限模式/mode临时启用自动执行/mode yolo恢复默认权限/mode default3. 任务控制立即停止当前任务/stop向正在运行的任务追加要求/ps 不要提交代码只生成修改方案远程执行 Shell 命令/shell git status查看文件/show README.md4. 系统管理查看帮助/help查看运行状态/status运行诊断/doctor远程重启服务/restart十三、几个实用的远程指令模板代码检查检查当前仓库最近一次提交重点关注安全漏洞、异常处理和兼容性问题。不要修改代码先输出检查报告。故障排查分析最近一次 CI 失败的原因。先查看日志和相关配置不要直接修改文件。给出原因、影响范围和修复建议。项目分析阅读当前仓库整理项目架构、主要模块、启动流程和外部依赖生成 docs/architecture.md。安全模式修改代码修复登录接口的超时问题。修改前先说明计划完成后运行测试但不要执行 git commit 和 git push。生成日报根据今天的 Git 提交和项目文档整理一份开发日报包括完成事项、遇到的问题和明天的计划。检查服务状态查看当前服务运行状态和最近 200 行日志判断是否存在异常。不要执行重启操作。一条好的远程指令最好同时包含要完成的目标可以读取或操作的范围是否允许修改文件是否允许执行命令是否允许提交代码最终需要返回什么结果。十四、使用 cc-connect 时的安全建议cc-connect 让手机可以远程操作本地 Agent也意味着一条聊天消息可能最终变成文件修改或 Shell 命令。因此建议至少做到以下几点默认使用default或plan模式不要长期启用yolo严格限制allow_from和admin_from不要将管理员权限开放给整个群API Key 和 Secret 使用环境变量不要让 Agent 默认进入包含大量敏感文件的目录重要项目启用 Git并定期提交生产环境操作必须保留人工确认不要允许陌生人直接向机器人发送命令定期检查 daemon 日志和会话记录。对于高风险任务推荐先让 Agent 只输出计划先分析问题并给出执行方案不要修改文件也不要运行有副作用的命令。确认方案无误后再让它继续执行。十五、实际使用体验这类工具最大的价值并不是让模型突然变得更聪明而是降低了调度 AI 的阻力。以前使用 Claude Code通常需要回到电脑前打开终端进入项目目录找到之前的会话输入新的任务要求。接入 cc-connect 后入口变成了每天都会打开的微信或飞书。突然想到一个需求时可以直接发一条消息任务执行过程中需要调整方向也可以随时追加要求离开电脑后仍然可以查看执行进展和最终结果。尤其是在飞书和微信中使用语音输入时操作成本会更低。例如走在路上直接说检查订单服务今天的修改重点看看并发问题。不要提交代码先给我一份分析报告。语音转成文字后发送给 Agent任务就会在远程电脑上开始执行。很多原本需要“回家再处理”或者“回到工位再看”的事情现在可以立刻推进。总结cc-connect 可以理解为把 Claude Code、Codex、Gemini CLI、Cursor Agent 等本地 AI Agent变成微信、飞书、钉钉或 Telegram 里的聊天机器人。它解决的不是模型能力问题而是 AI Agent 的使用入口问题。通过 cc-connect你可以在手机上远程检查代码查看长任务执行进度随时补充和修改要求远程排查日志和 CI 故障管理多个 Agent 和多个会话通过语音推进开发、写作和调研工作。最简单的安装方式是直接让 Claude Code 阅读官方安装文档并完成配置请参考下面的安装文档帮我安装和配置 cc-connect https://raw.githubusercontent.com/chenhg5/cc-connect/refs/heads/main/INSTALL.md手动安装则可以执行npminstall-gcc-connect cc-connect web cc-connect需要特别注意cc-connect web用于配置管理cc-connect或cc-connect daemon start才是启动桥接服务远程使用时不要忽视权限、访问控制和密钥安全涉及生产环境、代码提交和文件删除时始终保留人工确认。当 AI Agent 的入口从终端变成手机聊天软件后你获得的不只是一个机器人而是一个随时可以调度的远程工作节点。