CC-Connect 对接 Claude 完整搭建说明文档

（适配：海外 Linux 服务器、无 GPU 仅 CPU 可用、对接微信 / 网页后台、不用一直挂 Claude 窗口）

一、整体架构说明

1. Claude：官方命令行 AI 客户端，负责对话理解与生成。

2. CC-Connect：中间中转桥梁，作用：

   • 托管 Claude 后台常驻
   • 提供 Web 管理后台
   • 对接微信 / 飞书等第三方渠道

3. 运行逻辑：

   只需后台常驻 CC-Connect，不用一直打开 Claude 终端窗口，服务器不关机就永久在线。

二、前置环境准备

1. 服务器：海外 Linux（Ubuntu/Debian）
2. 已安装 Node.js/npm
3. 已安装 Claude 命令行客户端
4. 无需 NVIDIA 显卡、无需nvidia-smi，纯 CPU 即可正常使用

三、安装 CC-Connect

在服务器终端执行：

bash

运行

npm install -g cc-connect

安装完成后，系统自动生成配置目录：

/root/.cc-connect/

四、初始化配置文件

1. 首次执行任意 cc 命令，自动生成配置：

bash

运行

cc-connect

2. 生成核心文件：

• 主配置：/root/.cc-connect/config.toml
• Web 后台密码：/root/.cc-connect/web_password

五、CC-Connect 基础常用命令

bash

运行

# 启动后台常驻
cc-connect start

# 停止服务
cc-connect stop

# 查看运行状态
cc-connect status

# 重启服务
cc-connect restart

# 启动Web管理后台服务
cc-connect web

六、进入 CC-Connect Web 管理后台

nano /root/.cc-connect/config.toml

写入：

[web]
host = "0.0.0.0"
port = 9820
auth = false

2. 服务器安全组 / 防火墙放行 9820 端口
3. 重启服务：

bash

运行

cc-connect restart


cc-connect web

然后会出现 token，复制 token 填入界面即可
4. 浏览器访问：

http://服务器公网IP:9820

七、CC-Connect 与 Claude 关联逻辑

1. 无需在配置里手动填 Claude 密钥，CC 会自动读取本地 Claude 登录会话

2. 只要你服务器能正常登录 claude 命令行，CC 自动对接成功

3. 关联流程：

   • 终端执行 claude 登录一次账号
   • 退出 Claude exit
   • 后台启动 cc-connect start
   • CC 自动接管 Claude 会话，常驻后台

八、关键使用要点

1. 不用一直开 Claude 窗口

   只要 cc-connect start 在后台运行，关闭终端也不影响微信、网页对话。

2. 关于飞书报错提示

   日志里出现：

   10003 invalid param

   是飞书配置参数错误，不用飞书可直接忽略，不影响 Claude 和微信使用。

3. 警告说明

plaintext

allow_from is not set
admin_from is not set

只是权限安全提醒，普通使用不用配置，不影响正常聊天。

4. 无 GPU 不用处理

   nvidia-smi 找不到是因为服务器无显卡，CC+Claude 纯 CPU 就能完美运行，无需安装显卡驱动。

九、日常运维操作

1. 重启整套服务

bash

运行

cc-connect stop
cc-connect start

2. 重置 Web 后台密码

   重新执行 cc-connect web 会自动生成新密码，再用 cat ~/.cc-connect/web_password 查看。

3. 彻底重装

bash

运行

npm uninstall -g cc-connect
npm install -g cc-connect