Post

用手机远程控制Claude Code

介绍通过`happy-coder`或`hapi`用手机远程控制服务器上的 Claude Code

用手机远程控制Claude Code

1. 引言

介绍通过happy-coderhapi用手机远程控制服务器上的 Claude Code

  • happy 官方仓库: https://github.com/slopus/happy
  • hapi 官方仓库: https://github.com/tiann/hapi

说明:本文的操作都是通过手机聊天让小龙虾远程执行的,如果要具体操作步骤,网上资料很多,可参考这篇:我用手机玩Claude/Codex,直接控制终端!

2. 安装步骤

2.1. 安装 happy-coder

happy-coder 是连接手机和服务器的桥梁。在服务器上npm安装:npm install -g happy-coder

happy claude/happy启动服务,会出来扫描和URL(让小龙虾自动执行了,若手动操作可参考上面链接)

happy auth logout退出后需重新认证。

happy daemon status查看守护进程,若没自动启动,可以happy daemon start启动

1
2
3
4
5
6
7
8
9
10
11
12
[root@xdlinux ➜ ~clauded ]$ happy -h
happy - Claude Code On the Go
Usage:
  happy [options]         Start Claude with mobile control
  happy auth              Manage authentication
  happy codex             Start Codex mode
  happy gemini            Start Gemini mode (ACP)
  happy connect           Connect AI vendor API keys
  happy notify            Send push notification
  happy daemon            Manage background service that allows
                            to spawn new sessions away from your computer
  happy doctor            System diagnostics & troubleshooting

2.2. 手机端安装

在手机应用商店搜索 “happy-coder” 或通过官方渠道下载 App。安装完成后打开,会看到扫码连接的界面。

happy-coder 扫码连接界面

3. 配置流程

3.1. 扫码配对

打开手机端 happy-coder,点击”添加设备”,扫描服务器端生成的二维码。扫码或输入URL成功后,手机会显示设备已连接。(由于我是远程操作,是让小龙虾执行后提供了认证URL)

happy-coder 设备列表

3.2. 设备命名

在设置界面,可以给这台服务器重命名,方便后续识别。如果有多台服务器,建议用有意义的名称(如 home-serverwork-station)。

3.3. 设置工作目录

在设备详情界面,配置工作目录为 ~/happy_workspace,不存在会自动创建。这个目录将作为 Claude Code 的默认工作区,所有项目文件都会在这里读写。

happy-coder 设备详情

4. 使用

happy-coder 支持长连接,即使手机锁屏,任务也会继续在服务器运行。下次打开手机时查看结果即可。

4.1. 多会话

happy-coder 多会话管理

4.2. 命令自动提示

使用时也像命令行里一样会自动提示,使用superpower Skill示例:

happy-coder 命令提示

4.3. 修改权限模式

happy-coder Skill 执行

5. hapi试用

hapihappy-code类似,安全性好一点。但是貌似需要在一个局域网(比如连接wifi),或者配置公网。没有单独的app,但是可以发送文件,感觉下来使用体验不如happy-code

hapi 聊天界面

6. 实战案例:通过手机远程分析Claude Code泄漏的源码

有了happy-coder,可以在手机上随时随地让 Claude Code 处理复杂任务。比如最近 Claude Code 源码泄露事件,我用手机让 Claude Code 分析了别人用 Rust 重写的版本:claw-code

任务:分析 https://github.com/instructkr/claw-code 的架构,梳理代码结构并提交改进。

Claw Code 架构分析报告

完成的任务清单

Claw Code 任务完成清单

如截图所示,Claude Code 完成了以下 6 项任务:

  1. ✅ 拉取并分析 claw-code 仓库
  2. ✅ 梳理 Rust 核心架构(对话运行时、钩子系统、工具注册表、权限控制、自动压缩)
  3. ✅ 安装 Rust 工具链并成功构建 CLI
  4. ✅ 创建独立配置文件(隔离于主 Claude Code 配置)
  5. ✅ 保存架构分析文档到 docs/superpowers/specs/
  6. ✅ 提交并推送文档(同时保护了 API Key 不被泄露)

结果

  • ✅ 识别出项目定位:Claude Code 的 Python/Rust 重构版本
  • ✅ 梳理了仓库状态:Rust 分支 (dev/rust) 正在积极开发中
  • ✅ 生成了完整的架构与代码梳理报告
  • ✅ 待办清单清晰展示分析进度
This post is licensed under CC BY 4.0 by the author.