使用 Happy 远程操作 Claude Code / Codex

简介

Happy 套件（Web/iOS/Android + Server + Cli）可以让我们远程操作 Claude Code 和 Codex。

步骤

1. 在懒猫微服安装 Happy Coder

里面整合了 Happy Web 和 Happy Server，并自动设置好了 serverUrl。

2. 在远程机器安装 Happy Cli

npm install -g happy-coder

3. 在远程机器运行 Happy Cli

export HAPPY_SERVER_URL=https://happyserver.xxx.heiyu.space
export HAPPY_WEBAPP_URL=https://happyweb.xxx.heiyu.space

# 启动 claude code
happy

# 启动 codex
happy codex

把 xxx 替换成你的懒猫设备名。

4. 在 Happy Web 中远程连接 Happy Cli

首次启动 happy，我们会看到这个界面：

选择 Mobile App，然后就会看到这样的界面：

复制红色框中的内容，回到 Web 界面中，点击「手动输入 URL」按钮，并把刚才复制的内容粘贴进去：

然后点击认证。

如果认证成功，将会看到这样的提示：

如果认证失败，请去看看 FAQ 中的解决方案。

5. 远程操作 Claude Code / Codex 即可

此时远程机器的 Claude Code / Codex 将会被 happy 接管：

我们的 Web 界面是这样的：

这时候就可以远程操作 Claude Code / Codex 了。

FAQ

一句话总结：
退出登录+ 重新认证可以解决大部分问题。

0. Happy Cli 认证成功后如何 logout？

运行下面命令

happy auth logout

然后输入 y 即可。

也可以直接删除 ~/.happy 目录。

1. 如何使用 iOS / Android 的 App ？

可以！你可以前往官网下载 App https://happy.engineering/docs/quick-start/ ，然后在右上角的按钮处修改 serverUrl 为 https://happyserver.xxx.heiyu.space （请确保结尾处没有 /）即可。

2. 为什么认证时会出现「连接终端失败」的提示？

这时候可以试试登出当前账号然后重新登录：

3. 为什么认证时出现了「终端链接成功」的提示后页面没有跳转？

这通常是该 happy://terminal.... 已经被使用过了。
请参考 FAQ 中的「Happy Cli 认证成功后如何 logout？」一节，退出登录，然后重新认证。

4. 为什么运行 Happy Cli 会报错？

报 500 错误

请参考 FAQ 中的「Happy Cli 认证成功后如何 logout？」一节，退出登录，然后重新认证。

报 405 错误

这通常是 HAPPY_SERVER_URL 填成了 web 的地址了。请确保启动 happy cli 时的环境变量是对的：

HAPPY_SERVER_URL=https://happyserver.xxx.heiyu.space HAPPY_WEBAPP_URL=https://happyweb.xxx.heiyu.space happy codex