hicloud

⚠️ 注意：此版本为 Imou 企业定制版，非官方 happy 项目。

Imou 企业定制版。关键是 happy！移动端远程 AI 编程工具。

安装

npm install -g happy-imou-cloud

使用方法

Claude（默认）

hicloud

将会执行以下操作：

1. 启动 Claude Code 会话
2. 显示二维码，可通过移动设备连接
3. 实现 Claude Code 与移动端之间的实时会话共享

Gemini

hicloud gemini

启动具有远程控制功能的 Gemini CLI 会话。

首次设置：

# 使用 Google 账号认证
hicloud connect gemini

命令

主命令

• hicloud – 启动 Claude Code 会话（默认）
• hicloud gemini – 启动 Gemini CLI 会话
• hicloud codex – 启动 Codex 模式

实用命令

• hicloud auth – 管理认证
• hicloud connect – 在 Happy 云端存储 AI 服务商的 API 密钥
• hicloud notify – 向设备发送推送通知
• hicloud daemon – 管理后台服务
• hicloud doctor – 系统诊断和故障排除

Connect 子命令

hicloud connect gemini     # 使用 Google 账号认证 Gemini
hicloud connect claude    # 使用 Anthropic 账号认证
hicloud connect codex     # 使用 OpenAI 账号认证
hicloud connect status    # 显示所有服务商的连接状态

Gemini 子命令

hicloud gemini                      # 启动 Gemini 会话
hicloud gemini model set <model>    # 设置默认模型
hicloud gemini model get            # 显示当前模型
hicloud gemini project set <id>     # 设置 Google Cloud 项目 ID（用于企业账号）
hicloud gemini project get          # 显示当前 Google Cloud 项目 ID

可用模型： gemini-2.5-pro、gemini-2.5-flash、gemini-2.5-flash-lite

选项

Claude 选项

• -m, --model <model> - 使用的 Claude 模型（默认：sonnet）
• -p, --permission-mode <mode> - 权限模式：auto、default 或 plan
• --claude-env KEY=VALUE - 为 Claude Code 设置环境变量
• --claude-arg ARG - 向 Claude CLI 传递额外参数

全局选项

• -h, --help - 显示帮助信息
• -v, --version - 显示版本号

环境变量

hicloud 配置

• HAPPY_SERVER_URL - 自定义服务器地址（默认：https://happycloudcode.imou.com）
• HAPPY_HOME_DIR - Happy 数据自定义主目录（默认：~/.happy）
• HAPPY_DISABLE_CAFFEINATE - 禁用 macOS 睡眠阻止（设置为 true、1 或 yes）
• HAPPY_EXPERIMENTAL - 启用实验性功能（设置为 true、1 或 yes）

Gemini 配置

• GEMINI_MODEL - 覆盖默认 Gemini 模型
• GOOGLE_CLOUD_PROJECT - Google Cloud 项目 ID（企业账号必需）

Gemini 认证

个人 Google 账号

个人 Gmail 账号可直接使用：

hicloud connect gemini
hicloud gemini

Google Workspace 企业账号

Google Workspace（组织）账号需要 Google Cloud 项目：

1. 在 Google Cloud Console 创建项目
2. 启用 Gemini API
3. 设置项目 ID：

hicloud gemini project set your-project-id

或使用环境变量：

GOOGLE_CLOUD_PROJECT=your-project-id hicloud gemini

指南： https://goo.gle/gemini-cli-auth-docs#workspace-gca

环境要求

• Node.js >= 20.0.0

对于 Claude

• 已安装并登录 Claude CLI（PATH 中可使用 claude 命令）

对于 Gemini

• 已安装 Gemini CLI（npm install -g @google/gemini-cli）
• 已通过 hicloud connect gemini 进行 Google 账号认证

许可证

MIT

📢 官方项目

本项目基于 happy 开源项目定制开发。

如需使用官方原版，请访问：https://github.com/slopus/happy