使用 Happy 远程操作 Claude Code / Codex

## 简介
[Happy](https://happy.engineering/docs/quick-start/) 套件（Web/iOS/Android + Server + Cli）可以让我们远程操作 Claude Code 和 Codex。

## 步骤

**1. 在懒猫微服安装 Happy Coder**

https://appstore.lazycat.cloud/#/shop/detail/cloud.lazycat.app.happycoder

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

![image.png](https://dl.playground.lazycat.cloud/guidelines/799/a57d254e-703d-4308-8bbd-b3f73cdfdf5f.png "image.png")

**2. 在远程机器安装 Happy Cli**

```sh
npm install -g happy-coder
```

**3. 在远程机器运行 Happy Cli**

```sh
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`，我们会看到这个界面：
![image.png](https://dl.playground.lazycat.cloud/guidelines/799/04a5854f-88b5-478c-8d5f-8ef2389892d8.png "image.png")

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

![image.png](https://dl.playground.lazycat.cloud/guidelines/799/bf6ac05e-9c18-4d29-92d3-d82841da6886.png "image.png")

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

![image.png](https://dl.playground.lazycat.cloud/guidelines/799/4ef6278d-c19e-4dfb-b431-38debd861521.png "image.png")

然后点击认证。

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

![image.png](https://dl.playground.lazycat.cloud/guidelines/799/c99a39f3-eef0-42da-a953-e0389e0a142f.png "image.png")

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


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

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

![image.png](https://dl.playground.lazycat.cloud/guidelines/799/1188d730-625e-4bdc-ae69-c0b4c9616f31.png "image.png")


我们的 Web 界面是这样的：


![image.png](https://dl.playground.lazycat.cloud/guidelines/799/bbd65903-ff50-47fb-bdd7-baf3908adb7f.png "image.png")

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

![image.png](https://dl.playground.lazycat.cloud/guidelines/799/7935aa33-c1fc-4838-97d8-90708c8e9e23.png "image.png")



## FAQ

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


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

运行下面命令

```
happy auth logout
```

![image.png](https://dl.playground.lazycat.cloud/guidelines/799/9fb29421-2ce5-4dbb-8039-9400354a5094.png "image.png")

然后输入 `y` 即可。

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


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

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

![image.png](https://dl.playground.lazycat.cloud/guidelines/799/ec4ac2fd-1750-479f-96cd-ac4d4c92e951.png "image.png")


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

![image.png](https://dl.playground.lazycat.cloud/guidelines/799/dca27fd1-bb55-48ef-b8d6-e98d3dae443b.png "image.png")

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

![image.png](https://dl.playground.lazycat.cloud/guidelines/799/c8b51a0a-da40-4044-8952-03cedab8b771.png "image.png")

![image.png](https://dl.playground.lazycat.cloud/guidelines/799/7affee95-20bd-4d97-861d-58b692d910c9.png "image.png")

![image.png](https://dl.playground.lazycat.cloud/guidelines/799/1058eb78-9fdb-4f4c-807f-6830999c958b.png "image.png")


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

![image.png](https://dl.playground.lazycat.cloud/guidelines/799/8913691a-024e-4e75-804a-c3dee1be94de.png "image.png")

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


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

> 报 500 错误
![image.png](https://dl.playground.lazycat.cloud/guidelines/799/adb62cae-e6c5-41e5-bc8c-aed0f6b3b6c0.png "image.png")

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

> 报 405 错误
![image.png](https://dl.playground.lazycat.cloud/guidelines/799/f7da55de-7b5f-4411-a319-f90cccf05080.png "image.png")

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

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