安装与管理

安装 ginit CLI

还没有 ginit 命令？两行装好（国内推荐火山 TOS 加速源，秒级下载）：

curl -fsSL "https://dc-sh-public.tos-accelerate.volces.com/ginit/install.sh" -o /tmp/install.sh

GINIT_RELEASE_BASE_URL="https://dc-sh-public.tos-accelerate.volces.com/ginit" bash /tmp/install.sh

装完校验：

ginit version

第二行的 GINIT_RELEASE_BASE_URL 不能省：脚本靠它从 TOS mirror 拉二进制，不带这个变量会回落到 GitHub release（需要 gh auth login 且能直连 GitHub）
脚本自带版本感知：已装同版本会跳过，旧版自动升级（--check 只看决策不写入）
想装到用户目录：GINIT_INSTALL_DIR="$HOME/.local/bin" bash /tmp/install.sh

装好 ginit 之后，ginit device install 会把 Harness 运行时（Node + Claude Code + Codex + MCP 插件）作为 Bundle 一起拉下来——那部分不需要单独下载。

命令一览

管理 ginit 本体与运行时的命令就这几条，按顺序执行前三条即可用：

ginit login

ginit device install

ginit up

ginit doctor

ginit update

命令	作用
`ginit login`	飞书登录，建立身份与网关凭证
`ginit device install`	下载自包含 device Bundle（Harness + MCP + 技能集）
`ginit up`	一键就绪：attach 本机 + 起 supervisor（幂等，可反复跑）
`ginit doctor`	体检：版本 / 登录态 / 设备 / 长链路 / 模型可用性
`ginit update`	升级 ginit CLI 本体（`--cli-only` 只更 CLI 不动 Bundle）
`ginit device unsupervise`	停 supervisor（长链路断开）

安装 Bundle

ginit device install

预期输出：

ginit device install
  source:   tos (default)
  variant:  self
  version:  v1.4.115
  → downloading ginit-device-self-linux-amd64.tar.gz (~110 MB)
  → sha256 verified
  → installed to ~/.ginit/device-runtime/

ginit device install: OK (bundle v1.4.115, node 22.x, claude 2.1.226, codex 0.153.4)

同版本重复安装直接跳过（already installed, skipping）。分离式 Harness 运行时也各自独立安装：ginit claude install-runtime 与 ginit codex install-runtime（Codex 运行时独立 pin，当前 0.153.4）。

下载都落在哪

所有 ginit 的下载与状态都在用户家目录下，不在系统目录。虚拟机用户注意：如果你的 $HOME 在非持久化镜像层（容器、重置型 VM），以下路径会随重建丢失，需要重新 ginit device install：

路径	内容	大小量级
`~/.ginit/device-runtime/`	device Bundle：Node + Claude Code + Codex + MCP + lark/qz 技能	~1 GB
`~/.ginit/claude-runtime/`	Claude Code 独立运行时（bundle 复用优先）	~250 MB
`~/.ginit/codex-runtime/`	Codex CLI 独立运行时	~100 MB
`~/.ginit/claude-env.json`	网关凭证缓存（24h 刷新）	极小
`~/.ginit/qz-credentials.json`	QZ 账号密码（本机 only，0600）	极小
`~/.ginit/multica/state.json`	Multica 绑定状态（PAT + codebase 映射）	极小
`~/.ginit/devices/<id>/`	设备注册信息与 `managed.flag`	极小
`~/.ginit/run/supervisor.pid`	supervisor pidfile；日志在 `~/.ginit/supervisor.log`	极小
`~/.config/ginit/config.json`	多环境 profile（base_url + token）	极小

ginit CLI 二进制本身装在 /usr/local/bin/ginit（GINIT_INSTALL_DIR 可改到如 ~/.local/bin）。

--lean 变体（约 250 KB）要求宿主机自带 Node ≥ 22 与 Claude Code，默认的 self 变体无任何宿主要求。

正在加载评论…

安装 ginit CLI

命令一览

安装 Bundle

下载都落在哪

评论

本页目录