在 QQ 里和 Claude Code 聊天：cc-connect 上手记
在 QQ 里和 Claude Code 聊天：cc-connect 上手记
最近发现一个挺有意思的项目叫 cc-connect，简单说就是把 Claude Code、Cursor 这些 AI 编程助手接到 QQ、飞书、Telegram 这些聊天软件上。试了一下，效果比我预期的好，记录一下安装和使用过程。
项目地址：https://github.com/chenhg5/cc-connect
这东西能干嘛
平时用 Claude Code 都是在终端里敲命令，但有时候你不在电脑前——比如在外面、在开会、或者就是懒得起身——又想让 AI 帮你干点活。cc-connect 就是干这个的：你在 QQ 上给机器人发条消息，它就能调用你本地的 Claude Code 帮你写代码、改文件、跑命令，然后把结果发回 QQ。
它支持的平台还挺全的：QQ、飞书、钉钉、Telegram、Discord、Slack、企业微信、个人微信、LINE。Agent 方面除了 Claude Code，还支持 Codex、Cursor Agent、Gemini CLI 等。
架构很简单：
你 (QQ/飞书/Telegram) → 聊天平台 → cc-connect → Claude Code → 你的电脑
数据全在本地走，不经过第三方服务器，这点挺重要的。
安装
最省心的方式：让 Claude Code 帮你装
如果你已经装了 Claude Code，那最简单的方法就是直接让它帮你搞定一切。
装好 Claude Code 后，打开终端：
npm install -g @anthropic-ai/claude-code
claude
然后跟它说：
请参考 https://raw.githubusercontent.com/chenhg5/cc-connect/refs/heads/main/INSTALL.md 帮我安装和配置 cc-connect
它会一步步问你：用哪个 Agent？连什么平台？QQ 号多少？工作目录在哪？你只需要回答选择题，剩下的它全包了——装 cc-connect、部署 NapCat、生成配置文件、启动服务。连 QQ 扫码登录这种事它都会把二维码截图放到你桌面上。
说实话这是我用过最舒服的安装体验，基本不用动脑子。
手动安装
当然你也可以自己来，下面记录一下手动步骤。
装 cc-connect
npm install -g cc-connect
cc-connect --version # 确认装好了
macOS/Linux 也可以用 Homebrew：brew install cc-connect。不想装 Node 的话，去 GitHub Releases 下二进制文件也行。
装 Agent
npm install -g @anthropic-ai/claude-code
其他 Agent 按需装：Codex (npm install -g @openai/codex)、Gemini CLI (npm install -g @google/gemini-cli) 等等。
配平台
这里拿 QQ 举例，因为国内用的人多，而且不需要公网 IP。
QQ 要走 NapCat（一个 OneBot v11 实现），用 Docker 部署：
docker run -d --name napcat \
-e ACCOUNT=你的QQ号 \
-p 3001:3001 \
-p 6099:6099 \
--restart unless-stopped \
mlikiowa/napcat-docker:latest
等容器起来后看日志：
docker logs -f napcat
终端里会出现二维码，用 QQ 手机版扫码登录。也可以打开 http://127.0.0.1:6099 用 WebUI 操作。
登录成功后还要配一下 Forward WebSocket。编辑容器里的配置文件：
docker exec napcat cat /app/napcat/config/onebot11_<你的QQ号>.json
在 network.websocketServers 里加一个：
{
"name": "forward-ws",
"enable": true,
"host": "0.0.0.0",
"port": 3001,
"enableForcePushEvent": true,
"messagePostFormat": "array",
"token": ""
}
然后 docker restart napcat 就行。
飞书也挺简单的，去飞书开放平台建个应用，开机器人能力，事件订阅选 WebSocket 长连接模式，然后 cc-connect feishu setup --project xxx 一键搞定。Telegram 更简单，找 @BotFather 拿个 token 就行。
写配置文件
配置文件放 ~/.cc-connect/config.toml，一个基本的长这样：
language = "zh"
[log]
level = "info"
[[projects]]
name = "my-project"
[projects.agent]
type = "claudecode"
[projects.agent.options]
work_dir = "/你的项目路径"
mode = "acceptEdits"
[[projects.platforms]]
type = "qq"
[projects.platforms.options]
ws_url = "ws://127.0.0.1:3001"
token = ""
allow_from = "*"
mode 这个字段控制 Claude 的权限。acceptEdits 是自动接受文件编辑但其他操作要确认；yolo 是全自动不问你——省事但有风险，自己掂量。也可以不手动写配置，跑 cc-connect web 开个网页界面来配。
启动
cc-connect
看到 cc-connect is running 就成了。注意别在 Claude Code 会话里面启动，会冲突。开个新终端跑。
怎么用
启动之后，用你的另一个 QQ（或者朋友的 QQ）给机器人号发消息就行。它会把消息转给 Claude Code，Claude 处理完自动回复。
有几个常用的命令：
/new— 重新开始一轮对话，清掉之前的上下文/mode yolo— 切全自动模式，Claude 不再问你要不要执行/quiet— 关掉那些"正在思考..."的提示消息/stop— 中断当前任务/help— 看所有命令
Claude 执行操作的时候会问你让不让干，回复 允许 或者 允许所有 就行。嫌烦就直接 /mode yolo。
多项目
一个 cc-connect 可以同时管多个项目，每个项目有自己的工作目录和 Agent。在配置文件里加多个 [[projects]] 就行：
[[projects]]
name = "后端"
[projects.agent]
type = "claudecode"
[projects.agent.options]
work_dir = "D:\\backend"
# ...平台配置
[[projects]]
name = "前端"
[projects.agent]
type = "codex"
[projects.agent.options]
work_dir = "D:\\frontend"
# ...平台配置
聊天里用 /list 看有哪些项目，/switch 切换。
定时任务
这个功能挺有意思——你可以用自然语言告诉机器人要定时干什么，比如"每天早上 8 点帮我看看 GitHub Trending"，它会自动转成 cron 任务。底层是 cc-connect cron add 命令，也可以手动管理：
cc-connect cron list # 看所有任务
cc-connect cron del <job-id> # 删一个
踩过的坑
CLAUDECODE 环境变量冲突：如果你在 Claude Code 会话里跑 cc-connect，会报错。解决办法是开新终端，或者先 $env:CLAUDECODE = ""。
QQ 登录过期：NapCat 容器重启后可能需要重新扫码。docker restart napcat 然后 docker logs -f napcat 看新二维码。
机器人不回消息：先查三个东西——NapCat 跑没跑（docker ps）、WebSocket 起没起（日志里搜 3001）、cc-connect 连上没有（日志里搜 connected to OneBot）。
后台运行：Windows 用 Start-Process cc-connect -WindowStyle Hidden，Linux 用 screen/tmux 或者搞个 systemd service。
安全
allow_from 字段限制谁能用你的机器人，别设成 * 然后把机器人加到公共群里——那等于谁都能让你的电脑干活。yolo 模式也要慎用，万一有人发个"删掉所有文件"呢。
整体用下来感觉 cc-connect 把 AI 助手从终端里拽出来了，随时随地 QQ 上发条消息就能让 Claude 干活，确实方便。不需要服务器、不需要公网 IP，本地电脑就能跑，门槛很低。
浙公网安备 33010602011771号