mycc

name	mycc
description	启动 mycc 小程序后端服务（后台运行）。触发词："/mycc"、"启动 mycc"、"启动小程序后端"、"检查 mycc 状态"、"启动飞书后端"

mycc

启动 mycc 小程序本地后端，连接网页版/小程序与本地 Claude Code。

支持双通道同时运行：

• Web 通道：网页版/小程序访问（默认）
• 飞书通道：飞书群双向通信（需配置）

特性：通道独立启动，任意通道失败不影响其他通道

环境要求

要求	说明
Claude Code	必须是官方原版，fork 版本可能不兼容
网络	需要 VPN/代理（cloudflared 需要访问外网）
系统	✅ macOS、✅ Linux、✅ Windows (原生)、⚠️ WSL（不稳定）

💡 关于第三方 Claude Code：目前仅测试了官方原版，第三方 fork 版本的兼容性支持在规划中。

依赖

• Node.js 18+：运行后端服务
• cloudflared：
  • macOS: brew install cloudflare/cloudflare/cloudflared
  • Linux: 参考 官方文档
  • Windows: winget install Cloudflare.cloudflared 或从官网下载
• 飞书（可选）：
  • 需要飞书企业自建应用
  • 配置环境变量：FEISHU_APP_ID, FEISHU_APP_SECRET, FEISHU_ENCRYPT_KEY, FEISHU_VERIFICATION_TOKEN

启动方式

方式 1：使用 /mycc 命令（推荐）

直接在 Claude Code 中输入：

• /mycc - 同时启动 Web 和飞书通道（如果配置了）
• 启动 mycc
• 启动小程序后端

通道行为：

• Web 通道默认启动
• 飞书通道需要配置环境变量才会启动
• 任意通道启动失败不影响其他通道

方式 2：使用启动脚本

系统	Web 模式	飞书模式
Windows	.\start-mycc.ps1	.\start-feishu-mycc.ps1
macOS/Linux	./start-mycc.sh	./start-feishu-mycc.sh

⚠️ 首次运行：先安装依赖

cd .claude/skills/mycc/scripts && npm install && cd -

触发词

• "/mycc" - 同时启动 Web 和飞书通道
• "启动 mycc"
• "启动小程序后端"
• "检查 mycc 状态"

执行步骤

1. 安装依赖（首次）

cd .claude/skills/mycc/scripts && npm install && cd -

2. 启动后端

npx tsx .claude/skills/mycc/scripts/src/index.ts start

使用 run_in_background: true 让后端在后台持续运行。

代码会自动检测项目根目录（向上查找 .claude/ 或 claude.md），无需手动指定 cwd。

通道启动逻辑：

• Web 通道默认启动
• 飞书通道需要配置环境变量（FEISHU_APP_ID、FEISHU_APP_SECRET 等）
• 任意通道启动失败不影响其他通道

3. 读取连接信息

等待几秒后读取：

sleep 5 && cat .claude/skills/mycc/current.json

4. 告知用户

连接信息：

• 连接码（routeToken）
• 配对码（pairCode）
• 访问 https://mycc.dev 输入配对

通道状态：

• Web 通道：默认启动
• 飞书通道：配置环境变量后自动启动

飞书模式配置

环境变量

在 .env 文件中配置：

FEISHU_ENABLED=true
FEISHU_APP_ID=your_app_id
FEISHU_APP_SECRET=your_app_secret
FEISHU_ENCRYPT_KEY=your_encrypt_key
FEISHU_VERIFICATION_TOKEN=your_verification_token

飞书应用配置

1. 创建飞书企业自建应用
2. 开启权限：
   • 接收消息：im:message、im:message:group_at_msg
   • 发送消息：im:message、im:chat
   • 事件订阅：im.message.receive_v1、im.message.message_read_v1
3. 配置事件请求 URL：
   • 使用 tunnel URL + /feishu/events
   • 例如：https://xxx.trycloudflare.com/feishu/events

关键说明

• 后台运行：后端会在后台持续运行，不阻塞当前会话
• 自动检测 cwd：会向上查找项目根目录，确保 hooks 能正确加载
• 连接信息：保存在 .claude/skills/mycc/current.json
• 停止服务：
  • Windows: .\stop-mycc.ps1
  • macOS/Linux: ./stop-mycc.sh
  • 或手动：lsof -i :18080 -t | xargs kill (Unix) / taskkill /PID <pid> /F (Windows)

遇到问题？

让 AI 自己解决。 代码都在 scripts/src/ 目录下，AI 可以：

1. 读取错误日志
2. 检查代码逻辑
3. 修复问题并重试

常见问题：

• 端口被占用：lsof -i :18080 -t | xargs kill
• cloudflared 未安装：按上面的依赖说明安装
• tunnel 启动失败：检查网络，重试即可

---

连接信息格式

启动后保存在 .claude/skills/mycc/current.json：

{
  "routeToken": "XXXXXX",
  "pairCode": "XXXXXX",
  "tunnelUrl": "https://xxx.trycloudflare.com",
  "mpUrl": "https://api.mycc.dev/XXXXXX",
  "cwd": "/path/to/project",
  "startedAt": "2026-01-27T06:00:00.000Z"
}

API 端点

端点	方法	说明
/{token}/health	GET	健康检查
/{token}/pair	POST	配对验证
/{token}/chat	POST	发送消息
/{token}/history/list	GET	历史记录列表
/{token}/history/{sessionId}	GET	对话详情