想要在手机上随时随地唤醒 Codex 帮你处理代码？通过 KittyLitter 终端配合 SSH 协议，你可以轻松将手机与远程电脑（Host）打通。

本指南以 Windows 作为远程宿主机为例，带你完成全链路配置。

🛠️ 第一阶段：宿主机（Host）基础环境配置

在远程电脑端，我们需要先搞定网络代理并安装 Codex 命令行工具。

1. 配置终端网络代理（可选，国内环境推荐）

为了确保后续下载组件或运行测试不卡顿，可以在 PowerShell 中临时设置代理（仅对当前窗口有效，请根据实际情况修改端口）：

# 设置 HTTP 代理
$env:HTTP_PROXY = "http://127.0.0.1:7890"

# 设置 HTTPS 代理
$env:HTTPS_PROXY = "http://127.0.0.1:7890"

2. 安装并认证 Codex CLI

确保系统已安装 Node.js，然后在终端中使用 npm 全局安装 Codex（推荐使用淘宝镜像加速）：

# 使用国内镜像极速安装
sudo npm install -g @openai/codex --registry=https://registry.npmmirror.com

安装完成后，执行登录认证：

codex login
# 或 codex auth login，根据 CLI 版本提示完成浏览器授权

3. 开启 Codex 远程连接权限

为了允许移动端远程调用，必须开启 Alpha 远程功能。
打开或创建 Codex 的配置文件 ~/.codex/config.toml，写入以下内容：

[features]
remote_connections = true

🛡️ 第二阶段：配置 Windows OpenSSH 服务器

KittyLitter 需要通过 SSH 协议“潜入”你的 Windows 系统。我们需要开启 Windows 自带的 OpenSSH 服务。

1. 一键安装 OpenSSH Server

以管理员身份运行 PowerShell，执行以下命令检查并安装：

# 检查并在线安装 OpenSSH Server
Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0

(等待进度条走完，若显示 Path: ... Online: True 即代表安装成功。如果喜欢图形化操作，也可前往：开始菜单 > 设置 > 系统 > 可选功能 > 添加 OpenSSH 服务器)

2. 启动并固化 SSH 服务

安装完成后，启动服务并将其设置为开机自启：

# 启动 SSH 服务
Start-Service sshd

# 设置为开机自启，一劳永逸
Set-Service -Name sshd -StartupType 'Automatic'

# 确认服务状态（状态应显示为 Running）
Get-Service sshd

3. 放行防火墙 22 端口

为了让手机的网络请求能顺畅进门，需要配置 Windows 防火墙放行 SSH 默认的 22 端口：

if (!(Get-NetFirewallRule -Name "OpenSSH-Server-In-TCP" -ErrorAction SilentlyContinue)) {
    New-NetFirewallRule -Name "OpenSSH-Server-In-TCP" -DisplayName "OpenSSH Server (sshd)" -Enabled True -Direction Inbound -Protocol TCP -LocalPort 22 -Action Allow
}

🚀 第三阶段：手机端直连 (KittyLitter)

宿主机全部就绪后，最后一步在手机上完成：

1. 在手机上下载并打开 KittyLitter APP。
2. 创建一个新的 SSH 连接。
3. 填入你 Windows 电脑的 IP 地址（局域网 IP 或已穿透的公网 IP）、用户名及密码。
4. 点击连接！

成功登入后，你就可以直接在手机终端里输入 codex 命令，让远端的算力为你所用了！