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