gewe-cc-0.1.0 is not a library.

gewe-cc

Claude Code 远程协作模式命令行工具

gewe-cc 是一个命令行工具，允许你通过微信远程控制 Claude Code 的工作流程。当任务完成时，自动发送微信通知并等待你的下一个指令，实现真正的远程协作。

✨ 特性

🔄 全局远程模式：一键启用/禁用远程模式
📱 微信集成：通过 gewe-cli 发送通知和接收指令
🎯 智能循环：根据回复自动继续工作或停止
⚡ 零 Python 依赖：纯 Rust 实现，跨平台支持
🛡️ 会话隔离：基于 session_id 的状态管理
📦 易于安装：cargo install 一键安装

📦 安装

使用 Cargo 安装（推荐）

cargo install gewe-cc

从源码编译

git clone https://github.com/wangnov/gewe-cc.git
cd gewe-cc
cargo build --release

使用安装脚本

curl -fsSL https://raw.githubusercontent.com/wangnov/gewe-cc/main/install.sh | sh

🚀 快速开始

1. 安装依赖

gewe-cc 需要以下依赖：

gewe-cli: 微信消息收发工具

cargo install gewe-cli
# 或
brew install gewe-cli

Claude Code: Anthropic 官方 CLI

curl -fsSL https://install.claudecode.com | sh

2. 初始化

gewe-cc init

这将：

✅ 检查所有依赖是否已安装
✅ 生成配置文件 ~/.gewe-cc/config.toml
✅ 提供详细的安装指引（如有缺失依赖）

3. 安装 Claude Code Plugin

方式 1：从 GitHub 安装（推荐）

# 1. 添加 gewe-cc marketplace
claude plugin marketplace add wangnov/gewe-cc

# 2. 安装 plugin
claude plugin install gewe-cc

方式 2：本地安装（开发模式）

# 1. 克隆仓库
git clone https://github.com/wangnov/gewe-cc.git
cd gewe-cc

# 2. 添加本地 marketplace
claude plugin marketplace add ./plugin

# 3. 安装 plugin
claude plugin install gewe-cc

验证安装

# 查看已安装的插件
claude plugin list

# 应该能看到 gewe-cc 插件

4. 启用远程模式

gewe-cc on

或在 Claude Code 中输入：

会话级别命令（只影响当前会话）：

>remote-on       # 启用当前会话的远程模式
>remote-off      # 禁用当前会话的远程模式
>remote-status   # 查看全局远程模式状态

全局级别命令（影响所有会话）：

gewe-cc on       # 全局启用远程模式
gewe-cc off      # 全局禁用远程模式

5. 开始工作

claude

在 Claude Code 中：

创建一个文件 test.txt

任务完成后会自动：

📤 发送微信通知
⏳ 等待你的回复
🔄 根据回复继续工作或停止

6. 远程控制

通过微信回复：

添加单元测试 → Claude 继续工作
优化性能 → Claude 继续工作
停止 → 结束远程模式

📖 命令

gewe-cc init

初始化环境（检查依赖、生成配置）

gewe-cc init

gewe-cc on

启用全局远程模式

gewe-cc on

gewe-cc off

禁用全局远程模式，或仅关闭当前会话

# 禁用全局远程模式（所有任务不再进入远程控制）
gewe-cc off

# 仅关闭当前会话（保持全局远程模式，后续任务仍会进入远程控制）
gewe-cc off --session-id <会话ID>

会话 ID 可以从 Stop Hook 的提示中获取。

gewe-cc status

查看远程模式状态

gewe-cc status

gewe-cc config

查看或修改配置

# 查看当前配置
gewe-cc config

# 修改微信 ID
gewe-cc config --wxid wxid_new_value

# 修改监听地址
gewe-cc config --listen 0.0.0.0:5000

# 同时修改多个配置
gewe-cc config --wxid wxid_new --listen 0.0.0.0:5000

gewe-cc wait-reply

发送消息并等待回复（自动使用配置文件中的 wxid 和 listen）

# 使用配置文件中的默认值
gewe-cc wait-reply -M "任务完成了"

# 临时覆盖目标微信
gewe-cc wait-reply -M "测试消息" --to-wxid wxid_test

# 设置超时（秒）
gewe-cc wait-reply -M "需要回复" --timeout 60

# 完整示例
gewe-cc wait-reply -M "【Claude Code】任务完成" --to-wxid wxid_xxx --listen 0.0.0.0:4399 --timeout 300

gewe-cc notify

发送通知（不等待回复）

# 使用配置文件中的默认值
gewe-cc notify -M "构建成功"

# 临时覆盖目标微信
gewe-cc notify -M "部署完成" --to-wxid wxid_ops

gewe-cc hook (内部命令)

处理 Claude Code Hook 事件（由 plugin 调用，非用户命令）

gewe-cc hook user-prompt-submit < input.json
gewe-cc hook stop < input.json

⚙️ 配置

配置文件位置：~/.gewe-cc/config.toml

[remote]
# 全局远程模式开关
enabled = false

[notification]
# 通知渠道
channel = "wechat"

# 微信配置
wxid = "wxid_xxxxxxxx"
listen = "0.0.0.0:4399"

[gewe_cli]
# gewe-cli 命令路径
command = "gewe-cli"

# 超时设置（秒，0 表示无限等待）
timeout = 0

🏗️ 架构

┌─────────────────────────────────────┐
│          gewe-cc CLI                 │
├─────────────────────────────────────┤
│  • init    - 初始化环境              │
│  • on/off  - 控制远程模式            │
│  • status  - 查看状态                │
│  • hook    - Hook 处理 (内部)       │
└─────────────────────────────────────┘
         ↓                    ↓
    ┌────▼────┐          ┌────▼────┐
    │gewe-cli │          │ Claude  │
    │         │          │  Code   │
    │微信通信 │          │ Plugin  │
    └─────────┘          └─────────┘

📚 文档

🔧 开发

编译

cargo build

测试

cargo test

发布

使用 release-plz 自动管理版本和发布：

# 创建 PR 更新版本
# GitHub Actions 会自动处理

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 License

MIT License - 详见 LICENSE 文件

🙏 致谢

gewe-cli - 微信消息收发工具
Claude Code - Anthropic 官方 CLI
cargo-dist - Rust 二进制分发工具
release-plz - 自动版本管理

注意：此工具仅用于个人学习和合法用途。请遵守微信使用规范。

gewe-cc 0.1.0