予楓個(gè)人主頁(yè) 個(gè)人專欄: 《Java 從入門到起飛》《讀研碼農(nóng)的干貨日?！贰禞ava 面試刷題指南》 Debug 這個(gè)世界Return 更好的自己不用守在電腦前通過微信、飛書或釘釘隨時(shí)遠(yuǎn)程指揮 Claude Code、Codex、Gemini CLI 等本地 AI Agent 干活。最近有同學(xué)問我能不能在企業(yè)微信或者飛書里使用 Claude Code最開始我想到的是自己寫一個(gè)機(jī)器人通過 WebSocket 把聊天消息轉(zhuǎn)發(fā)給本地的 Claude Code。但深入了解后我發(fā)現(xiàn)已經(jīng)有一個(gè)相對(duì)完整的開源方案——cc-connect。它不僅支持 Claude Code還可以接入 Codex、Gemini CLI、Cursor Agent 等多種 AI 編程工具聊天平臺(tái)方面則覆蓋微信、飛書、釘釘、Telegram、Slack、Discord 等常用工具。本文將介紹cc-connect 是什么它解決了哪些問題如何完成本地安裝如何接入飛書和微信如何設(shè)置工作目錄、權(quán)限和訪問控制如何配置后臺(tái)運(yùn)行與開機(jī)自啟日常使用中有哪些常用命令。如果你希望把本地 AI Agent 變成一個(gè)隨時(shí)可調(diào)用的“遠(yuǎn)程開發(fā)助手”可以按照本文一步一步完成配置。一、cc-connect 是什么cc-connect 是一個(gè)連接AI Agent和即時(shí)通訊工具的橋接器也可以理解為一個(gè)通信中樞。它負(fù)責(zé)把聊天軟件中的消息轉(zhuǎn)發(fā)給運(yùn)行在本地電腦上的 AI Agent再把 Agent 的執(zhí)行結(jié)果發(fā)送回聊天軟件。項(xiàng)目地址https://github.com/chenhg5/cc-connect整體鏈路非常簡(jiǎn)單微信 / 飛書 / 釘釘 / Telegramcc-connectClaude Code / Codex / Gemini CLI本地代碼倉(cāng)庫(kù)與操作系統(tǒng)換句話說(shuō)你可以把原本只能在終端里使用的 Claude Code變成微信或飛書里的聊天機(jī)器人。例如你在手機(jī)上發(fā)送檢查一下今天提交的代碼看看有沒有明顯的安全問題。家里或者辦公室電腦上的 Claude Code 可以自動(dòng)進(jìn)入指定項(xiàng)目目錄執(zhí)行g(shù)it diff閱讀修改過的代碼分析潛在問題把檢查結(jié)果返回到微信或飛書。整個(gè)過程中你不需要遠(yuǎn)程連接電腦也不需要一直守在終端前。二、cc-connect 解決了什么問題Claude Code、Codex、Gemini CLI 等 AI 編程工具已經(jīng)非常強(qiáng)大但它們通常存在幾個(gè)使用限制主要在終端中運(yùn)行必須連接開發(fā)機(jī)器離開電腦后不方便繼續(xù)操作長(zhǎng)任務(wù)執(zhí)行過程中不容易隨時(shí)補(bǔ)充要求多臺(tái)設(shè)備之間缺少統(tǒng)一的交互入口。cc-connect 的核心價(jià)值就是把 AI Agent 的操作入口從終端擴(kuò)展到手機(jī)聊天軟件。場(chǎng)景一遠(yuǎn)程檢查代碼下班以后你突然想到今天提交的代碼可能存在問題可以直接在微信中發(fā)送檢查今天的代碼改動(dòng)重點(diǎn)關(guān)注 SQL 注入、權(quán)限校驗(yàn)和敏感信息泄露。Claude Code 可以在本地倉(cāng)庫(kù)中執(zhí)行g(shù)itdiffgitstatus然后閱讀相關(guān)文件并返回分析報(bào)告。場(chǎng)景二讓 AI 持續(xù)執(zhí)行長(zhǎng)任務(wù)你可以在路上發(fā)送分析這個(gè)倉(cāng)庫(kù)的整體架構(gòu)整理主要模塊、調(diào)用關(guān)系和潛在技術(shù)債生成一份 Markdown 報(bào)告。Agent 可以繼續(xù)在電腦上完成搜索代碼閱讀項(xiàng)目文檔分析目錄結(jié)構(gòu)執(zhí)行必要的命令生成分析報(bào)告。任務(wù)完成后結(jié)果會(huì)直接返回聊天軟件。場(chǎng)景三遠(yuǎn)程排查故障在飛書中發(fā)送幫我檢查最近一次 CI 為什么失敗不要修改代碼先給出原因和解決方案。Agent 可以讀取日志、檢查構(gòu)建腳本和依賴配置再把排查結(jié)果返回。場(chǎng)景四遠(yuǎn)程推進(jìn)寫作和調(diào)研任務(wù)cc-connect 不只能用于寫代碼。只要 Agent 能完成的工作都可以通過聊天軟件發(fā)起例如整理技術(shù)方案閱讀和總結(jié)資料生成博客初稿分析數(shù)據(jù)文件更新項(xiàng)目文檔執(zhí)行自動(dòng)化腳本匯總每日工作進(jìn)度。三、cc-connect 有哪些特點(diǎn)1. 支持多種 AI Agent根據(jù)項(xiàng)目提供的能力cc-connect 可以連接多種主流 AI 編程工具例如AI Agent支持情況Claude Code?Codex?Gemini CLI?Cursor Agent?Kimi CLI?OpenCode?Qoder CLI?Pi Agent?DevinACP?其他 ACP Agent?這意味著你不必被限制在某一個(gè)模型或某一個(gè)編程工具中。你甚至可以給不同 Agent 分配不同職責(zé)Claude 分析代碼邏輯 Gemini 評(píng)審技術(shù)方案 Codex 給出修復(fù)建議2. 支持多種聊天平臺(tái)cc-connect 支持的聊天平臺(tái)包括微信飛書釘釘企業(yè)微信TelegramSlackDiscordLINEQQQQ 官方機(jī)器人微博私信WPS 協(xié)作。具體支持范圍和接入方式可能隨項(xiàng)目版本變化建議以項(xiàng)目最新文檔為準(zhǔn)。3. 多數(shù)場(chǎng)景不要求公網(wǎng) IP很多傳統(tǒng)機(jī)器人方案需要準(zhǔn)備公網(wǎng)服務(wù)器HTTPS 證書Webhook 地址獨(dú)立域名反向代理。cc-connect 在部分平臺(tái)中可以使用 WebSocket、長(zhǎng)輪詢或 Socket Mode 建立連接因此可以直接運(yùn)行在家里的 Mac Mini辦公室電腦Linux 主機(jī)NAS常駐在線的開發(fā)機(jī)。對(duì)于個(gè)人開發(fā)者來(lái)說(shuō)這可以明顯降低部署門檻。4. 支持多會(huì)話管理cc-connect 提供了多會(huì)話管理能力。你可以為不同任務(wù)創(chuàng)建獨(dú)立會(huì)話/new 修復(fù)登錄接口超時(shí)問題再通過命令查看或切換會(huì)話/list /switch 2 /current /history 10比較推薦的習(xí)慣是一個(gè)任務(wù)對(duì)應(yīng)一個(gè)會(huì)話。不要使用“臨時(shí)”“測(cè)試”這種難以識(shí)別的名字而是直接描述任務(wù)例如/new 分析訂單服務(wù)內(nèi)存泄漏 /new 重構(gòu)用戶權(quán)限模塊 /new 整理本周技術(shù)周報(bào)5. 支持切換工作目錄你可以通過聊天命令切換 Agent 當(dāng)前操作的目錄/dir ~/workspace/project-a也可以查看當(dāng)前目錄/dir恢復(fù)到配置文件中的默認(rèn)目錄/dir reset6. 支持定時(shí)任務(wù)例如你可以讓 Agent每天早上匯總 GitHub Trending每晚整理當(dāng)天提交記錄每周生成項(xiàng)目進(jìn)展報(bào)告定期檢查服務(wù)日志定時(shí)執(zhí)行代碼質(zhì)量檢查。本質(zhì)上是把聊天指令、AI Agent 和系統(tǒng)任務(wù)調(diào)度組合在了一起。7. 支持圖片、文件和語(yǔ)音部分平臺(tái)可以向 Agent 發(fā)送圖片截圖文檔代碼文件語(yǔ)音消息。例如線上系統(tǒng)報(bào)錯(cuò)時(shí)可以直接把截圖發(fā)給機(jī)器人分析一下截圖里的報(bào)錯(cuò)告訴我可能的原因和排查步驟。語(yǔ)音輸入也非常適合移動(dòng)場(chǎng)景。提前設(shè)置好目錄、權(quán)限和項(xiàng)目后走在路上也可以直接通過語(yǔ)音推進(jìn)任務(wù)。8. 提供 Web 管理后臺(tái)可以通過下面的命令啟動(dòng)管理界面cc-connect web在瀏覽器中完成項(xiàng)目管理Agent 管理Provider 管理聊天平臺(tái)配置定時(shí)任務(wù)配置會(huì)話監(jiān)控網(wǎng)頁(yè)聊天。需要注意cc-connect web主要用于配置和管理不等于啟動(dòng)橋接服務(wù)。配置完成后仍然需要運(yùn)行cc-connect或者通過 daemon 模式啟動(dòng)后臺(tái)服務(wù)。四、本地安裝 cc-connect方式一讓 Claude Code 自動(dòng)安裝如果你已經(jīng)安裝了 Claude Code可以直接把下面這段話發(fā)給它請(qǐng)參考下面的安裝文檔幫我安裝和配置 cc-connect https://raw.githubusercontent.com/chenhg5/cc-connect/refs/heads/main/INSTALL.mdClaude Code 會(huì)根據(jù)官方文檔檢查環(huán)境并執(zhí)行安裝。這種方式最省事也更適合不想手動(dòng)處理依賴的用戶。方式二使用 npm 安裝手動(dòng)安裝可以執(zhí)行npminstall-gcc-connect安裝完成后檢查版本cc-connect--version如果能夠正常輸出版本號(hào)說(shuō)明安裝成功。方式三在 macOS 上使用 HomebrewmacOS 用戶也可以使用 Homebrewbrewinstallcc-connect同樣可以通過下面的命令檢查cc-connect--version“3 分鐘部署”主要指本地安裝和啟動(dòng)流程。創(chuàng)建飛書應(yīng)用、掃碼授權(quán)以及權(quán)限審批所需時(shí)間取決于具體平臺(tái)和賬號(hào)環(huán)境。五、接入飛書機(jī)器人第一步創(chuàng)建飛書應(yīng)用打開飛書開放平臺(tái)https://open.feishu.cn/app創(chuàng)建一個(gè)機(jī)器人或智能體應(yīng)用。建議按照接入的 Agent 命名例如Home ClaudeClaude Code BotCodex AssistantDev Agent。創(chuàng)建完成后記錄應(yīng)用的App IDApp Secret。配圖建議飛書開放平臺(tái)創(chuàng)建應(yīng)用頁(yè)面。第二步執(zhí)行配置命令在本地終端中執(zhí)行cc-connect feishu setup\--projecthome-claude\--appcli_xxx:sec_xxx其中home-claude是項(xiàng)目名稱cli_xxx替換為飛書 App IDsec_xxx替換為飛書 App Secret。第三步重啟服務(wù)cc-connect daemon restart然后在飛書中給機(jī)器人發(fā)送/help如果機(jī)器人能夠正?；貜?fù)說(shuō)明飛書已經(jīng)接入成功。六、接入微信個(gè)人微信可以通過對(duì)應(yīng)的 setup 命令完成配置cc-connect weixin setup--projecthome-claude執(zhí)行后終端通常會(huì)顯示登錄二維碼可復(fù)制的授權(quán)地址當(dāng)前登錄狀態(tài)。使用手機(jī)微信掃碼或者打開授權(quán)地址完成登錄確認(rèn)。認(rèn)證信息會(huì)被寫入配置文件~/.cc-connect/config.toml完成授權(quán)后重啟服務(wù)cc-connect daemon restart然后在微信中向機(jī)器人發(fā)送一條測(cè)試消息例如/help能夠正常回復(fù)就說(shuō)明連接成功。個(gè)人微信接入方式可能受到平臺(tái)規(guī)則、賬號(hào)狀態(tài)和項(xiàng)目版本影響。需要更高穩(wěn)定性時(shí)建議優(yōu)先選擇飛書、釘釘或企業(yè)微信等官方機(jī)器人通道。七、配置項(xiàng)目工作空間cc-connect 的主要配置文件位于~/.cc-connect/config.toml第一次運(yùn)行時(shí)程序會(huì)自動(dòng)生成配置模板。也可以使用 Web 管理后臺(tái)配置cc-connect web一個(gè)基礎(chǔ)項(xiàng)目配置示例如下[[projects]] name home-claude [projects.agent] type claudecode [projects.agent.options] work_dir /Users/you/Workspace/your-project mode default其中work_dir決定 Agent 默認(rèn)在哪個(gè)目錄工作。配置完成后即使你人在外面Agent 也會(huì)直接進(jìn)入正確的項(xiàng)目目錄不需要每次手動(dòng)切換。為不同項(xiàng)目創(chuàng)建獨(dú)立配置建議給每個(gè)常用項(xiàng)目創(chuàng)建獨(dú)立的 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這樣可以避免多個(gè)項(xiàng)目之間的上下文、工作目錄和任務(wù)互相干擾。八、權(quán)限模式怎么選權(quán)限配置是遠(yuǎn)程使用 cc-connect 時(shí)最需要關(guān)注的部分。常見模式包括模式說(shuō)明default工具調(diào)用通常需要確認(rèn)acceptEdits文件編輯自動(dòng)通過其他高風(fēng)險(xiǎn)操作仍需確認(rèn)plan只生成方案不直接執(zhí)行bypassPermissions/yolo自動(dòng)通過全部操作遠(yuǎn)程使用時(shí)建議默認(rèn)配置為[projects.agent.options] mode default因?yàn)樵谑謾C(jī)上很難完整查看 Agent 的每一步操作長(zhǎng)期使用全自動(dòng)權(quán)限存在較高風(fēng)險(xiǎn)。對(duì)于明確、低風(fēng)險(xiǎn)的任務(wù)可以臨時(shí)切換/mode yolo任務(wù)完成后立即切回/mode default以下任務(wù)不建議使用全自動(dòng)模式刪除大量文件修改生產(chǎn)配置執(zhí)行數(shù)據(jù)庫(kù)變更提交或推送代碼安裝來(lái)源不明的軟件包運(yùn)行無(wú)法確認(rèn)內(nèi)容的腳本操作生產(chǎn)服務(wù)器。九、配置訪問控制遠(yuǎn)程 Agent 能夠讀取文件、執(zhí)行命令因此一定要限制使用者。示例配置[[projects]] name home-claude admin_from 你的用戶ID [projects.platforms.options] allow_from 你的用戶ID或可信群ID其中allow_from控制哪些用戶或群可以給機(jī)器人發(fā)送指令admin_from控制哪些用戶可以執(zhí)行切目錄、Shell、重啟等高風(fēng)險(xiǎn)操作。不要這樣配置admin_from *推薦原則allow_from可以配置為可信群或可信成員admin_from最好只配置自己的用戶 ID。如果機(jī)器人加入了多人群聊還要注意提示詞注入和誤操作風(fēng)險(xiǎn)不要讓陌生成員能夠直接執(zhí)行系統(tǒng)命令。十、敏感信息不要寫死在配置文件中API Key、App Secret 等敏感信息建議通過環(huán)境變量引用api_key ${ANTHROPIC_API_KEY} app_id ${FEISHU_APP_ID} app_secret ${FEISHU_APP_SECRET}然后在系統(tǒng)環(huán)境中設(shè)置變量exportANTHROPIC_API_KEY你的 API KeyexportFEISHU_APP_ID你的飛書 App IDexportFEISHU_APP_SECRET你的飛書 App Secret相比直接寫入配置文件這種方式可以降低密鑰被誤提交到 Git 倉(cāng)庫(kù)的風(fēng)險(xiǎn)。同時(shí)建議將以下文件加入.gitignore.cc-connect/ config.toml .env十一、后臺(tái)運(yùn)行與開機(jī)自啟遠(yuǎn)程使用不能依賴手動(dòng)打開終端所以需要把 cc-connect 配置為后臺(tái)服務(wù)。執(zhí)行cc-connect daemoninstall--config~/.cc-connect/config.toml cc-connect daemon start在不同系統(tǒng)中后臺(tái)服務(wù)可能會(huì)使用macOSlaunchdLinuxsystemd。常用管理命令如下# 查看服務(wù)狀態(tài)cc-connect daemon status# 實(shí)時(shí)查看日志cc-connect daemon logs-f# 重啟服務(wù)cc-connect daemon restart# 停止服務(wù)cc-connect daemon stop出門前建議完成兩項(xiàng)檢查cc-connect daemon status確認(rèn)后臺(tái)服務(wù)正常后再在飛書或微信中發(fā)送/help機(jī)器人能夠正?；貜?fù)就可以遠(yuǎn)程使用了。十二、常用命令整理1. 會(huì)話管理創(chuàng)建新會(huì)話/new 修復(fù)登錄接口超時(shí)查看已有會(huì)話/list切換到指定會(huì)話/switch 2查看當(dāng)前會(huì)話/current查看最近消息/history 102. 工作目錄與模型查看當(dāng)前工作目錄/dir切換目錄/dir ~/workspace/project-a恢復(fù)默認(rèn)目錄/dir reset查看當(dāng)前模型/model切換模型/model switch sonnet查看權(quán)限模式/mode臨時(shí)啟用自動(dòng)執(zhí)行/mode yolo恢復(fù)默認(rèn)權(quán)限/mode default3. 任務(wù)控制立即停止當(dāng)前任務(wù)/stop向正在運(yùn)行的任務(wù)追加要求/ps 不要提交代碼只生成修改方案遠(yuǎn)程執(zhí)行 Shell 命令/shell git status查看文件/show README.md4. 系統(tǒng)管理查看幫助/help查看運(yùn)行狀態(tài)/status運(yùn)行診斷/doctor遠(yuǎn)程重啟服務(wù)/restart十三、幾個(gè)實(shí)用的遠(yuǎn)程指令模板代碼檢查檢查當(dāng)前倉(cāng)庫(kù)最近一次提交重點(diǎn)關(guān)注安全漏洞、異常處理和兼容性問題。不要修改代碼先輸出檢查報(bào)告。故障排查分析最近一次 CI 失敗的原因。先查看日志和相關(guān)配置不要直接修改文件。給出原因、影響范圍和修復(fù)建議。項(xiàng)目分析閱讀當(dāng)前倉(cāng)庫(kù)整理項(xiàng)目架構(gòu)、主要模塊、啟動(dòng)流程和外部依賴生成 docs/architecture.md。安全模式修改代碼修復(fù)登錄接口的超時(shí)問題。修改前先說(shuō)明計(jì)劃完成后運(yùn)行測(cè)試但不要執(zhí)行 git commit 和 git push。生成日?qǐng)?bào)根據(jù)今天的 Git 提交和項(xiàng)目文檔整理一份開發(fā)日?qǐng)?bào)包括完成事項(xiàng)、遇到的問題和明天的計(jì)劃。檢查服務(wù)狀態(tài)查看當(dāng)前服務(wù)運(yùn)行狀態(tài)和最近 200 行日志判斷是否存在異常。不要執(zhí)行重啟操作。一條好的遠(yuǎn)程指令最好同時(shí)包含要完成的目標(biāo)可以讀取或操作的范圍是否允許修改文件是否允許執(zhí)行命令是否允許提交代碼最終需要返回什么結(jié)果。十四、使用 cc-connect 時(shí)的安全建議cc-connect 讓手機(jī)可以遠(yuǎn)程操作本地 Agent也意味著一條聊天消息可能最終變成文件修改或 Shell 命令。因此建議至少做到以下幾點(diǎn)默認(rèn)使用default或plan模式不要長(zhǎng)期啟用yolo嚴(yán)格限制allow_from和admin_from不要將管理員權(quán)限開放給整個(gè)群API Key 和 Secret 使用環(huán)境變量不要讓 Agent 默認(rèn)進(jìn)入包含大量敏感文件的目錄重要項(xiàng)目啟用 Git并定期提交生產(chǎn)環(huán)境操作必須保留人工確認(rèn)不要允許陌生人直接向機(jī)器人發(fā)送命令定期檢查 daemon 日志和會(huì)話記錄。對(duì)于高風(fēng)險(xiǎn)任務(wù)推薦先讓 Agent 只輸出計(jì)劃先分析問題并給出執(zhí)行方案不要修改文件也不要運(yùn)行有副作用的命令。確認(rèn)方案無(wú)誤后再讓它繼續(xù)執(zhí)行。十五、實(shí)際使用體驗(yàn)這類工具最大的價(jià)值并不是讓模型突然變得更聰明而是降低了調(diào)度 AI 的阻力。以前使用 Claude Code通常需要回到電腦前打開終端進(jìn)入項(xiàng)目目錄找到之前的會(huì)話輸入新的任務(wù)要求。接入 cc-connect 后入口變成了每天都會(huì)打開的微信或飛書。突然想到一個(gè)需求時(shí)可以直接發(fā)一條消息任務(wù)執(zhí)行過程中需要調(diào)整方向也可以隨時(shí)追加要求離開電腦后仍然可以查看執(zhí)行進(jìn)展和最終結(jié)果。尤其是在飛書和微信中使用語(yǔ)音輸入時(shí)操作成本會(huì)更低。例如走在路上直接說(shuō)檢查訂單服務(wù)今天的修改重點(diǎn)看看并發(fā)問題。不要提交代碼先給我一份分析報(bào)告。語(yǔ)音轉(zhuǎn)成文字后發(fā)送給 Agent任務(wù)就會(huì)在遠(yuǎn)程電腦上開始執(zhí)行。很多原本需要“回家再處理”或者“回到工位再看”的事情現(xiàn)在可以立刻推進(jìn)。總結(jié)cc-connect 可以理解為把 Claude Code、Codex、Gemini CLI、Cursor Agent 等本地 AI Agent變成微信、飛書、釘釘或 Telegram 里的聊天機(jī)器人。它解決的不是模型能力問題而是 AI Agent 的使用入口問題。通過 cc-connect你可以在手機(jī)上遠(yuǎn)程檢查代碼查看長(zhǎng)任務(wù)執(zhí)行進(jìn)度隨時(shí)補(bǔ)充和修改要求遠(yuǎn)程排查日志和 CI 故障管理多個(gè) Agent 和多個(gè)會(huì)話通過語(yǔ)音推進(jìn)開發(fā)、寫作和調(diào)研工作。最簡(jiǎn)單的安裝方式是直接讓 Claude Code 閱讀官方安裝文檔并完成配置請(qǐng)參考下面的安裝文檔幫我安裝和配置 cc-connect https://raw.githubusercontent.com/chenhg5/cc-connect/refs/heads/main/INSTALL.md手動(dòng)安裝則可以執(zhí)行npminstall-gcc-connect cc-connect web cc-connect需要特別注意cc-connect web用于配置管理cc-connect或cc-connect daemon start才是啟動(dòng)橋接服務(wù)遠(yuǎn)程使用時(shí)不要忽視權(quán)限、訪問控制和密鑰安全涉及生產(chǎn)環(huán)境、代碼提交和文件刪除時(shí)始終保留人工確認(rèn)。當(dāng) AI Agent 的入口從終端變成手機(jī)聊天軟件后你獲得的不只是一個(gè)機(jī)器人而是一個(gè)隨時(shí)可以調(diào)度的遠(yuǎn)程工作節(jié)點(diǎn)。