微信秒变AI控制台：CC Connect一键接入Claude Code，远程操控你的本地Agent

鸿
鸿画夕
📅 2026-06-04 · 👁️ 106 阅读 · 5,048 字
摘要

CC Connect是一款将本地AI Agent（如Claude Code）桥接到微信等即时通讯工具的开源工具。它支持10+种AI Agent、多Agent协作、语音图片多模态输入、定时任务和持久化记忆。通过扫码即可将微信个人号与AI连接，实现随时随地通过聊天远程操控AI完成任务。

一、CC Connect 介绍

本文主要介绍如何通过 CC Connect 将 Claude Code 接入微信个人号，构建独属于自己的 AI 智能体。

CC Connect 可将运行在你机器上的 AI Agent 桥接到日常使用的即时通讯工具中。代码审查、资料研究、自动化任务、数据分析——只要 AI Agent 能做的事，都可以通过手机、平板或任何带有聊天应用的设备完成。在任何聊天工具中远程操控你的本地 AI Agent，随时随地，随心所欲。

二、CC Connect 主要特性

2.1 🤖 通用 Agent 支持

支持 10+ 种主流 AI Agent——Claude Code、Codex、Cursor Agent、Kimi CLI、Qoder CLI、Gemini CLI、OpenCode、iFlow CLI、Pi、Devin、Copilot，还可通过 Agent Client Protocol (ACP) 接入更多 Agent。可按需选用，或同时使用全部。

2.2 🔄 多 Agent 编排

多机器人中继——在群聊中绑定多个机器人，让它们相互协作。先问 Claude，再听 Gemini 的见解，同一个对话即可搞定。

2.3 🎮 完整的聊天控制

聊天即控制——切换模型 (/model)、切换推理强度 (/reasoning)、切换权限模式 (/mode)、管理会话，全部通过斜杠命令完成。

聊天切换工作目录——使用 /dir <路径> 切换下一次会话启动目录（/cd 为兼容别名），并支持 /dir <序号> /dir - 快速在历史目录间跳转。

2.4 🧠 持久化记忆

Agent 记忆——在聊天中直接读写 Agent 指令文件 (/memory)，无需回到终端。

2.5 ⏰ 智能定时任务

定时任务——使用自然语言创建 cron 任务，例如“每天早上6点总结 GitHub trending”，即刻生效。

2.6 🎤 多模态支持

语音 & 图片——发送语音或截图，CC Connect 会自动处理 STT/TTS 和多模态转发。

2.7 📦 多项目架构

多项目管理——一个进程同时管理多个项目，各自拥有独立的 Agent + 平台组合。

2.8 🌍 多语言界面

支持 5 种语言——原生支持英语、中文（简体/繁体）、日语和西班牙语。内置 i18n 让每个人都能得心应手。

三、CC Connect 安装方式

3.1 通过 AI Agent 自动安装配置（优先推荐）

最简单的方式——将这段话发给 Claude Code 或其他 AI 编码 Agent，它会帮你完成整个安装和配置过程：

请参考 https://raw.githubusercontent.com/chenhg5/cc-connect/refs/heads/main/INSTALL.md 帮我安装和配置 cc-connect（提示词）

3.2 手动安装

通过 NPM：

npm install -g cc-connect

通过 Homebrew（macOS / Linux）：

brew install cc-connect

3.3 从 GitHub Releases 下载

# Linux amd64 - 稳定版
curl -L -o cc-connect https://github.com/chenhg5/cc-connect/releases/latest/download/cc-connect-linux-amd64
chmod +x cc-connect
sudo mv cc-connect /usr/local/bin/

3.4 从源码编译（需要 Go 1.22+）

git clone https://github.com/chenhg5/cc-connect.git
cd cc-connect
make build

四、接入微信个人号

4.1 前置要求

  • 可运行 CC Connect 的环境（无需公网 IP；ilink 由云端提供）
  • 已安装并可正常使用的 Agent（如 Claude Code、Codex 等）
  • 使用微信（手机端）扫码完成 ilink 登录（或由运营商提供 Bearer Token）

4.2 推荐流程：一条命令扫码

方式一：安装好后，在项目目录执行

cc-connect weixin setup --project my-project

方式二：终端会打印

  1. 二维码（终端 ASCII）以及可复制的 URL（手机微信打开或扫码均可，取决于网关返回的链接形式）
  2. 按提示在手机上确认登录
  3. 成功后自动写入配置文件 config.toml

命令会从微信服务器获取以下信息，并保存到你项目目录下的 config.toml 文件中：

  • token：通常是一个 Bearer Token（类似访问凭证），后续 API 请求需要携带它。
  • base_url：网关返回的 API 基础地址（如果有）。
  • account_id：也称为 ilink_bot_id，是当前连接的机器人账号的唯一标识。

写入后，你的项目就完成了与微信的绑定，可以正常调用了。

方式三：若当前 allow_from 为空且你使用了 --set-allow-from-empty 选项（该选项默认开启），会尝试填入扫码关联的微信用户 ID，便于限制谁可以使用机器人。

4.3 命令对照

命令 作用 何时使用
weixin setup 无 --token 时走扫码；有 --token 时等同绑定 默认首选
weixin new 强制扫码，不接受 --token 明确只要重新扫码
weixin bind 强制只写 token，必须带 --token 已有 Token（例如从 OpenClaw 导出）

4.4 常用参数

参数 说明
--config 指定 config.toml 路径
--project 目标项目名；不存在会自动创建并挂上 weixin 平台
--platform-index 同一项目多个 weixin 平台时，按 1 基索引选择
--api-url ilink 网关根地址（无尾部路径）
--cdn-url 可选，同时写入 cdn_base_url
--timeout 等待扫码秒数，默认 480
--qr-image 将二维码 URL 导出为 PNG 路径
--route-tag 若运营商要求，设置请求头 SKRouteTag
--bot-type get_bot_qrcode 的 bot_type，默认 3
--debug 打印 HTTP 调试信息

4.5 配置说明（config.toml）

4.5.1 allow_from

为空或不填表示不限制发送者（不安全，仅建议本机调试）。

生产环境请填写允许的 ilink 用户 ID（形如 [email protected]），多个用英文逗号分隔。

扫码成功后，若开启默认的“空则回填”，会把扫码用户写入 allow_from（仍建议你核对后再上线）。

4.5.2 account_id 与状态目录

多微信账号或多机器人时，可用不同 account_id 隔离本地状态。状态文件默认在：/weixin/<account_id>/<状态目录路径>，其中含游标、缓存等，请勿手动泄露。

4.5.3 context_token（首次对话）

网关下发消息时可能带 context_token；CC Connect 会缓存并在回复时使用。

首次连接：

  1. 先启动 CC Connect 服务（让机器人处于监听状态）。
  2. 用已允许的微信账号（即 allow_from 列表中的用户）向机器人发送一条消息（任意内容）。
  3. 此时机器人会收到消息，并自动完成 context_token 的初始化和缓存。
  4. 之后，你才可以正常使用 /new 等指令（比如开始新的对话、重置上下文等）。

4.6 故障排查

现象 建议
扫码无反应 / 超时 检查网络、--api-url、--timeout；重试 weixin setup
写入配置后仍收不到消息 确认 allow_from、进程已重启、微信端已发消息触发 context_token
媒体无法解密 核对 cdn_base_url、网关返回的加密字段是否齐全
返回 errcode 等 -14 多为会话过期，按日志提示暂停轮询后重新登录或稍后再试

五、核心功能

5.1 💬 会话管理

  • /new [名称] — 创建新会话
  • /list — 列出所有会话
  • /switch <id> — 切换会话
  • /current — 查看当前会话
  • /dir [路径|reset] — 查看、切换或重置工作目录

项目配置也可以开启“长时间空闲后自动切到新会话”：

[[projects]]
reset_on_idle_mins = 60

5.2 🛡️ 系统用户隔离 (run_as_user)

在 Linux/macOS 上，项目可以用另一个 Unix 用户身份启动 Agent，从而在操作系统层面实现文件系统隔离。目前 Claude Code 已支持。

[[projects]]
name = "claude-sandboxed"
run_as_user = "partseeker-coder"
run_as_env = ["PGSSLROOTCERT"]

目标用户需要：supervisor 对其配置免密 sudo、自身不拥有 sudo、对 work_dir 有读写权限、拥有自己的 ~/.claude/settings.json。如果你通过 OAuth 认证，请将目标用户的 ~/.claude/.credentials.json 软链接到 supervisor 的副本以保持 token 同步——详见环境传播清单。完整设置说明见 docs/usage.md。

启动 cc-connect 之前，可用以下命令审核配置：

cc-connect doctor user-isolation

该命令会执行三项前置检查和一次隔离探测，报告目标用户能/不能读取的内容。如果任一检查失败或探测到跨用户泄漏，cc-connect 将拒绝启动。

5.3 🔐 权限模式

  • /mode — 查看可用模式
  • /mode yolo — 自动批准所有工具
  • /mode default — 每次工具调用前询问

5.4 🔄 提供者管理

  • /provider list — 列出 Provider
  • /provider switch <名称> — 运行时切换 API Provider

5.5 🤖 模型选择

  • /model — 列出可用模型（格式：alias - model）
  • /model switch <alias> — 按别名切换模型

5.6 📂 工作目录

  • /dir — 查看当前工作目录与历史
  • /dir <路径> — 切换到指定目录（相对或绝对路径）
  • /dir <序号> — 按历史序号切换
  • /dir - — 返回上一个目录
  • /cd <路径> — /dir <路径> 的兼容别名

5.7 ⏰ 定时任务

/cron add 0 6 * * * 帮我总结 GitHub trending
返回首页