微信接入 Claude Code（cc-connect）

cc-connect 是一个开源桥接工具，可以将本地运行的 Claude Code（以及 Codex、Cursor 等 Agent）连接到微信、飞书、Telegram、Slack 等 11 个即时通讯平台。连接后，你可以在手机微信里远程发送任务，Claude Code 在电脑上执行并回复结果。

支持的微信接入方式：

个人用户推荐 微信个人号（iLink） 方案：无需服务器、无需公网 IP，扫码即用。

安装

方式一：npm（推荐）

npm install -g cc-connect

方式二：Homebrew（macOS / Linux）

brew install cc-connect

方式三：从 GitHub Releases 下载二进制

前往 GitHub Releases 下载对应平台的二进制文件，解压后放到 /usr/local/bin/。

macOS 首次运行需要去除隔离属性：

xattr -d com.apple.quarantine cc-connect

验证安装：

cc-connect --version

配置

创建配置文件

配置文件默认位于 ~/.cc-connect/config.toml，第一次运行时会自动生成模板。也可以手动创建：

mkdir -p ~/.cc-connect

以下是接入微信个人号 + Claude Code 的最小配置：

[[projects]]
name = "wechat"

[projects.agent]
type = "claudecode"

[projects.agent.options]
work_dir = "/path/to/your/project"  # Claude Code 的工作目录
mode = "default"                    # 权限模式，见下文说明

[[projects.platforms]]
type = "weixin"

[projects.platforms.options]
allow_from = "*"  # 允许哪些微信账号发消息，* 表示所有

mode 权限模式说明：

个人使用推荐 auto 或 bypassPermissions，开发调试推荐 default。

微信个人号扫码登录

配置文件保存后，运行以下命令进行扫码登录：

cc-connect weixin setup --project wechat

终端会显示 ASCII 二维码，用手机微信扫码并在手机上确认登录。也可以指定保存二维码为图片：

cc-connect weixin setup --project wechat --qr-image /tmp/wechat-qr.png

登录成功后，token 会自动写入 ~/.cc-connect/config.toml，无需手动填写。

启动服务

前台启动（临时使用）

注意： 如果在 Claude Code 会话内运行，需要先取消 CLAUDECODE 环境变量，避免冲突：

unset CLAUDECODE && cc-connect

或者在独立的终端窗口中运行。看到以下输出说明启动成功：

level=INFO msg="cc-connect is running"

后台服务（推荐，开机自启）

安装为系统服务（macOS 使用 launchd，Linux 使用 systemd）：

cc-connect daemon install

常用的 daemon 管理命令：

cc-connect daemon start    # 启动服务
cc-connect daemon stop     # 停止服务
cc-connect daemon restart  # 重启服务
cc-connect daemon status   # 查看服务状态
cc-connect daemon logs -f  # 实时跟踪日志
cc-connect daemon uninstall  # 卸载服务

安装 daemon 后关闭终端不影响服务运行，开机后自动启动。

在微信中使用

服务启动后，用微信给自己发消息，Claude Code 即会响应。

常用聊天命令

/new [名称]          创建新会话
/switch <id>         切换到已有会话
/list                列出所有会话
/dir <路径>          切换 Claude Code 的工作目录
/model               列出可用模型
/mode                查看当前权限模式
/whoami              获取自己的微信用户 ID（用于 allow_from 配置）
/status              查看当前会话状态

权限确认

在 default / acceptEdits 模式下，Claude Code 请求工具权限时，在微信里回复：

• 允许 或 allow — 批准本次操作
• 拒绝 或 deny — 拒绝本次操作

限制特定微信账号访问

如果不希望任何人都能控制你的 Claude Code，可以在配置中指定允许的账号：

[projects.platforms.options]
allow_from = "user1@im.wechat,user2@im.wechat"

发送 /whoami 可以获取当前账号的微信用户 ID。

完整配置示例

language = "zh"

[[projects]]
name = "wechat"

[projects.agent]
type = "claudecode"

[projects.agent.options]
work_dir = "/Users/yourname/projects"
mode = "auto"

[[projects.platforms]]
type = "weixin"

[projects.platforms.options]
token = "your-ilink-token"           # 扫码后自动填入
base_url = "https://ilinkai.weixin.qq.com"
account_id = "your-account-id"       # 自动填入
allow_from = "*"

切换工作目录

你可以有多个项目目录，在微信里随时切换：

/dir /Users/yourname/projects/frontend

Claude Code 后续的操作就会在新目录下执行。

常见问题

Q：为什么 cc-connect 启动失败？

如果 npx 缓存损坏，可以清理后重试：

rm -rf ~/.npm/_npx

Q：token 过期怎么办？

重新扫码登录即可，新 token 会覆盖旧的：

cc-connect weixin new --project wechat

Q：如何查看收发消息的日志？

cc-connect daemon logs -f

或前台启动时日志直接输出到终端。

Q：可以同时连接多个平台吗？

可以，在同一个 project 下添加多个 [[projects.platforms]] 块即可，也可以创建多个 [[projects]]。

参考资料

• cc-connect GitHub
• 微信个人号接入文档
• 完整配置参考