跳转到主要内容

​
这是什么

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

​
下一步