# CLI 镜像下载

`https://help.clomio.ai` 是 Clomio 的 CLI 安装镜像,只用于**安装、更新、确认 Claude Code / Codex / Grok CLI 版本**。模型调用请配置 API 网关 `https://api.clomio.ai`,不要把镜像域名当成 API Base URL。

---

## 一键安装

打开终端,执行对应命令:

| 工具 | macOS / Linux | Windows PowerShell |
|------|------|------|
| Claude Code | `curl -fsSL https://help.clomio.ai/claude/install.sh \| bash` | `irm https://help.clomio.ai/claude/install.ps1 \| iex` |
| Codex | `curl -fsSL https://help.clomio.ai/codex/install.sh \| bash` | `irm https://help.clomio.ai/codex/install.ps1 \| iex` |
| Grok | `curl -fsSL https://help.clomio.ai/grok/install.sh \| bash` | `irm https://help.clomio.ai/grok/install.ps1 \| iex` |

---

## 更新到最新版

安装和更新是同一条命令。想更新哪个工具,重新跑它的安装命令即可:

```bash
curl -fsSL https://help.clomio.ai/claude/install.sh | bash
curl -fsSL https://help.clomio.ai/codex/install.sh | bash
curl -fsSL https://help.clomio.ai/grok/install.sh | bash
```

```powershell
irm https://help.clomio.ai/claude/install.ps1 | iex
irm https://help.clomio.ai/codex/install.ps1 | iex
irm https://help.clomio.ai/grok/install.ps1 | iex
```

指定版本时,在命令末尾传版本号,例如:

```bash
curl -fsSL https://help.clomio.ai/grok/install.sh | bash -s 0.2.73
```

---

## 确认版本

安装或更新后,重开终端,分别执行:

```bash
claude --version
codex --version
grok --version
```

能看到版本号就说明 CLI 本体已经装好。接下来还需要按工具配置 API Key 和 Base URL:

- Claude Code / Anthropic-compatible:`https://api.clomio.ai`(不带 `/v1`)
- Codex / OpenAI-compatible / Grok:`https://api.clomio.ai/v1`(带 `/v1`)

下一步按你要用的工具继续配置:

- [Claude Code 接入](#/claude-code)
- [Codex 接入](#/codex)
- [Grok 接入](#/grok)
- [Base URL 与 /v1 规则](#/base-url-matrix)

---

## 先查看脚本再执行

如果你不想直接 `curl | bash`,可以先把脚本下载到本地查看:

```bash
curl -fsSL https://help.clomio.ai/claude/install.sh -o claude-install.sh
sed -n '1,220p' claude-install.sh
bash claude-install.sh
```

Codex / Grok 同理把路径换成 `/codex/install.sh` 或 `/grok/install.sh`。Windows 可将文件名换成 `install.ps1`,先用 `irm` 下载后再查看。脚本只负责下载对应平台的 CLI 文件、写入本地用户目录、提示 PATH;不会读取你的 Clomio API Key。

---

## 版本、校验和下载位置

| 工具 | 版本指针 | 安装脚本内下载基址 | 说明 |
|------|------|------|------|
| Claude Code | `https://help.clomio.ai/claude/latest` | `https://help.clomio.ai/claude` | 按 manifest 下载对应平台二进制 |
| Codex | `https://help.clomio.ai/codex/latest` | `https://help.clomio.ai/codex` | 版本目录内提供 `codex-package_SHA256SUMS` |
| Grok | `https://help.clomio.ai/grok/stable` | `https://help.clomio.ai/grok` | 支持分片下载和指定版本 |

确认当前镜像版本:

```bash
curl -fsSL https://help.clomio.ai/claude/latest
curl -fsSL https://help.clomio.ai/codex/latest
curl -fsSL https://help.clomio.ai/grok/stable
```

Codex 包可按版本目录里的 SHA256 文件做完整性校验。Claude/Grok 的校验逻辑以安装脚本和上游包信息为准;如果你在公司网络或安全审计环境里使用,建议先下载脚本和目标包,再由本机安全策略扫描后执行。

---

## 卸载和清理

镜像安装默认写入当前用户目录,常见位置是 `~/.local/bin`、`~/.grok/bin` 或工具自己的配置目录。卸载时先查看命令位置:

```bash
which claude || true
which codex || true
which grok || true
```

然后删除对应二进制或安装目录。配置文件、登录状态和项目规则通常在 `~/.claude`、`~/.codex`、`~/.grok` 等目录;如果只是重装 CLI,不要直接删配置目录,避免丢失本地设置。

---

## 常见安装提醒

- 如果终端下载超时,先完全退出 Clash、V2Ray、机场客户端等代理软件后重试。
- 如果提示 `command not found`,重开终端;仍不行再检查安装脚本提示的 PATH。
- 如果公司代理会替换证书,先按公司安全规范导入证书或换到可信网络;不要为了安装临时关闭系统证书校验。
- `help.clomio.ai` 是唯一镜像域名;不要使用其他不存在的镜像域。

> 镜像只负责安装 CLI。模型调用、Key、分组和线路排障见 [5 分钟快速开始](#/quickstart)、[服务状态](#/status) 与 [故障排查](#/troubleshooting)。