cc-connect-AI一键部署（接入个人微信）指南

使用方法

拿到本文档后，在 Claude Code（或其他 AI 编程助手）中输入：

“请参考这个文档帮我安装和配置 cc-connect”

然后把本文档的完整内容发给 AI，它会自动引导你完成所有步骤。

---

这是什么？

cc-connect 将本地 AI 编程助手连接到消息平台（微信、飞书、钉钉、Telegram、Slack、Discord 等），让你在手机上就能与 AI 编程助手对话。

GitHub：https://github.com/chenhg5/cc-connect

---

给 AI 助手的指令

重要：你正在帮助用户安装 cc-connect。请使用交互式提问引导用户完成配置选择，不要猜测值。

你需要依次执行以下步骤，每一步都用提问让用户选择：

---

第一步：安装 cc-connect

检查 Node.js

先检查系统是否已安装 Node.js：

node --version
npm --version

如果没有安装，提示用户从 https://nodejs.org 下载 LTS 版本。

安装 cc-connect

npm install -g cc-connect

安装后验证：

cc-connect --version

---

第二步：检查 AI 引擎

询问用户要使用哪个 AI 编程助手，并提供选项：

选项	安装命令
Claude Code	npm install -g @anthropic-ai/claude-code
Codex (OpenAI)	npm install -g @openai/codex
Gemini CLI	npm install -g @google/gemini-cli
Cursor Agent	需安装 Cursor 编辑器
Qoder CLI	curl -fsSL https://qoder.com/install | bash

检查选择的引擎是否已安装，如未安装则执行安装命令。

---

第三步：创建配置文件

询问用户

1. 项目名称 — 例如 my-project
2. 工作目录 — AI 编程助手的工作文件夹（如 E:/DevelopProject）
3. 权限模式 — default（每次询问）、edit（自动编辑）、plan（计划模式）、yolo（完全自动）

创建配置目录和文件

mkdir -p ~/.cc-connect

写入 ~/.cc-connect/config.toml：

language = "zh"

[log]
level = "info"

[[projects]]
name = "<项目名称>"

[projects.agent]
type = "<引擎类型>"

[projects.agent.options]
work_dir = "<工作目录>"
mode = "<权限模式>"

---

第四步：连接消息平台

询问用户

让用户选择要连接的消息平台，本指南以个人微信（ilink） 为例。

其他平台配置见官方文档：https://github.com/chenhg5/cc-connect

个人微信（ilink）配置

运行扫码登录

cc-connect weixin setup --project <项目名称>

引导用户扫码

终端会显示二维码和 URL 链接。告诉用户两种方式：

1. 扫二维码：用手机微信「扫一扫」扫描终端屏幕上的二维码
2. 打开链接：将 URL 发送到手机微信（文件传输助手），在微信内点击打开

⚠️ 注意：二维码有效时间较短，请让用户准备好手机微信后再运行命令。

如果二维码过期，命令会自动刷新（最多 3 次）。如果全部过期，重新运行命令。

扫码成功后的反馈

扫码成功后，会显示：

✅ 已与微信建立连接。
Project "<项目名称>" had no Weixin platform; added one automatically.
✅ Weixin (ilink) configured for project "<项目名称>"

配置文件会自动写入 token，无需手动操作。

关于机器人头像

如果用户问：ilink 机器人使用腾讯分配的默认头像和名称，不支持自定义修改。

---

第五步：启动服务

启动 cc-connect

cc-connect

或指定配置：

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

⚠️ 重要：如果当前在 Claude Code 会话内，必须先取消环境变量再启动：

unset CLAUDECODE && cc-connect

或者让用户另开一个独立终端窗口运行。

成功日志：

level=INFO msg="platform started" project=my-project platform=weixin
level=INFO msg="engine started" project=my-project agent=claudecode platforms=1
level=INFO msg="cc-connect is running" projects=1

完成最终绑定

告诉用户：用授权的微信给机器人发一条消息，cc-connect 会自动完成 context_token 绑定，之后就可以正常对话了。

---

第六步：开机自启（可选）

询问用户是否需要设置开机自启（免手动开终端）。

Windows 方案

在启动文件夹创建 VBS 脚本：

路径：

C:\Users\<用户名>\AppData\Roaming\Microsoft\Windows\Start Menu\Programs\Startup\

创建 cc-connect.vbs：

CreateObject("WScript.Shell").Run "cc-connect.cmd --config C:\Users\<用户名>\.cc-connect\config.toml", 0, False

这样每次开机登录，cc-connect 会在后台静默运行，不弹出窗口。

---

第七步：设置 CLAUDE.md（如果使用 Claude Code）

询问用户是否需要为 Claude Code 设置自定义规则。

如果需要，在工作目录下创建 CLAUDE.md：

# 语言要求

请始终用中文（简体中文）回复用户。所有解释、建议、代码注释等均使用中文。

修改后发送 /new 开启新会话即可生效。

---

微信内命令参考

会话管理

命令	功能
/new	开启新对话
/list	列出所有会话
/switch <id>	切换到指定会话
/current	查看当前会话
/history [n]	查看最近 n 条消息
/stop	停止当前执行
/help	查看帮助

权限回复

Claude 请求权限时，回复：

• allow — 允许本次
• deny — 拒绝本次
• allow all — 全部自动允许

---

常见问题（供 AI 参考）

cc-connect 启动后微信收不到回复？

• 检查日志级别：[log] level = "debug"
• 确认用户已用授权微信给机器人发过至少一条消息
• 检查 work_dir 是否正确

提示 “session already in use”？

发 /new 开启新会话即可。

二维码一直过期？

二维码有效期较短。让用户先拿好手机打开微信，再运行命令，然后立即扫码。

如何更换微信账号？

重新运行 cc-connect weixin setup --project <项目名称>

如何升级？

npm update -g cc-connect

然后重启 cc-connect。

---

参考链接

• cc-connect GitHub：https://github.com/chenhg5/cc-connect
• 官方安装指南：https://github.com/chenhg5/cc-connect/blob/main/INSTALL.md
• Claude Code 文档：https://docs.anthropic.com/en/docs/claude-code/overview