通过 CLI 快速使用 HubTo

这是什么

hubtoai 是 HubTo CLI 的 npm 包和命令。它用于登录 HubTo，并把凭证自动写入本机 AI CLI，例如 Claude Code、Codex、OpenCode、Gemini CLI 和 Pi。

最快使用

方式一：不安装，直接运行

npx hubtoai@latest login

方式二：全局安装后运行

npm install -g hubtoai
hubtoai login

运行后，按提示选择要配置的 AI CLI，并在浏览器中完成 HubTo 登录。登录完成后，重启已经打开的 AI CLI，让新配置生效。

会配置什么

hubtoai 会自动处理这些信息：

HubTo 登录状态
API Key
Base URL
目标 CLI 的本地配置

当前支持的目标 CLI：

claude-code：Claude Code
codex：Codex
opencode：OpenCode
gemini：Gemini CLI
pi：Pi

指定目标 CLI

只配置 Gemini CLI：

hubtoai login --target gemini

同时配置 Claude Code 和 Codex：

hubtoai login --target claude-code --target codex

配置所有已检测到的目标：

hubtoai login --all

常用命令

查看当前状态：

hubtoai status

检查登录、接口和本地配置：

hubtoai doctor

刷新登录状态并同步到目标 CLI：

hubtoai refresh --use-saved-targets

退出登录并清理配置：

hubtoai logout --use-saved-targets

远程环境登录

如果服务器或容器不能自动打开浏览器，先打印登录链接：

hubtoai login --print-auth-url

在浏览器中完成登录后，把最终回调地址复制回终端：

hubtoai login complete "<callback-url>"

常见问题

登录后没有生效

请先重启对应 AI CLI。如果仍然无效，运行：

hubtoai status
hubtoai doctor

找不到目标 CLI

请确认目标名称使用的是：

claude-code
codex
opencode
gemini
pi

需要更新 hubtoai

重新安装最新版：

npm install -g hubtoai@latest

下一步

获取 API Key：参见快速上手
查看接口文档：参见接口参考

​这是什么

​最快使用

​方式一：不安装，直接运行

​方式二：全局安装后运行

​会配置什么

​指定目标 CLI

​常用命令

​远程环境登录

​常见问题

​登录后没有生效

​找不到目标 CLI

​需要更新 hubtoai

​下一步