# @smaihub/cli

一条命令把本机的 Claude Code、Codex、OpenCode、OpenClaw、DeepSeek Harness 接到 smai.ai：检测已安装的工具，经你同意后安装缺少的，按各工具自己的格式写入地址、Key 和固定的模型列表，最后用每个工具的真实协议发一次请求确认能用。

```bash
npx @smaihub/cli                                          # 交互式：粘贴 Key、勾选工具、选模型
npx @smaihub/cli setup --tool claude-code,codex,opencode  # 非交互
npx @smaihub/cli setup --tool all --install --yes         # 全部工具，缺的直接安装
```

全局安装后命令是 `smai`：`npm i -g @smaihub/cli`，然后 `smai setup --tool all`。

Key 在 https://api.smai.ai/console/token 创建。非交互时用 `SMAI_API_KEY` 环境变量传入；`--key` 也行，但会留在 shell 历史里。

## 命令

| 命令 | 作用 |
|---|---|
| `npx @smaihub/cli` / `npx @smaihub/cli init` | 交互式向导 |
| `npx @smaihub/cli setup` | 非交互配置，见下方参数 |
| `npx @smaihub/cli status` | 各工具是否已安装、当前指向哪里 |
| `npx @smaihub/cli test [--tool <ids>]` | 按各工具当前配置发一次真实请求 |
| `npx @smaihub/cli undo [--force]` | 还原上一次运行改过的文件 |

## 参数

| 参数 | 说明 |
|---|---|
| `--tool <ids>` | `claude-code`、`codex`、`opencode`、`openclaw`、`deepseek-harness`，逗号分隔，或 `all`；默认是本机已安装的 |
| `--key <key>` | API Key，默认读 `SMAI_API_KEY` |
| `--install` | 缺少的工具直接用 npm 安装，不再询问 |
| `--yes`, `-y` | 写入前不再确认 |
| `--print` | 只显示改动（Key 打码），不写入 |
| `--no-verify` | 写入后不发验证请求 |
| `--base-url <url>` | 网关地址，默认 `https://api.smai.ai` |
| `--home <dir>` | 写到另一个 home 目录（测试用），也可用 `SMAI_HOME` |

## 模型

模型是固定的，不需要选择：

| 工具 | 默认模型 | 配置里的模型 |
|---|---|---|
| Claude Code | `claude-opus-5-5` | Opus / Sonnet / Haiku 别名分别指向 `claude-opus-5-5`、`claude-sonnet-5-5`、`claude-haiku-5-5`；`claude-fable-5-1` 在 `/model` 里手动选 |
| Codex | `gpt-6.1-sol` | 可用 `/model` 切到 `gpt-5.6-terra`、`gpt-6-astra` |
| OpenCode、OpenClaw | `claude-opus-5-5` | 四个 Claude 模型和三个 GPT 模型 |
| DeepSeek Harness | `claude-opus-5-5` | `claude-opus-5-5`、`gpt-6.1-sol`、`deepseek-v4.1-flash` |

## 写入的内容

和 CC Switch 4.0.26 导入服务商时的写法一致：

| 工具 | 文件 | 内容 |
|---|---|---|
| Claude Code | `~/.claude/settings.json` | `env` 里的 `ANTHROPIC_BASE_URL`（根地址）、`ANTHROPIC_AUTH_TOKEN`、`ANTHROPIC_MODEL`，以及 `ANTHROPIC_DEFAULT_OPUS/SONNET/HAIKU_MODEL` 三个别名 |
| Codex | `~/.codex/config.toml` + `~/.codex/auth.json` | `model_provider = "smai"`、`model`、`[model_providers.smai]`（`/v1`、`wire_api = "responses"`、`requires_openai_auth = true`）；Key 写进 `auth.json` 的 `OPENAI_API_KEY` |
| OpenCode | `~/.config/opencode/opencode.json` | `provider.smai`（`@ai-sdk/openai-compatible`、`/v1`、内联 Key）和顶层 `model` |
| OpenClaw | `~/.openclaw/openclaw.json` | `models.providers.smai`（`/v1`、内联 Key、`openai-completions`）和 `agents.defaults.model.primary` |
| DeepSeek Harness | `~/.dsh/profiles/web/cordis.patch.yml` + `~/.dsh/.credentials.yaml` | patch 里是 `llm-pi-ai` 的 `providers.smai`（`/v1`、`openai-completions`、`apiKeyEnv: SMAI_API_KEY`）；Key 写进 DeepSeek Harness 自己的凭据文件 `refs.SMAI_API_KEY`，其他 Key 和记录原样保留 |

写入前会清掉旧服务商留下的关键字段（地址、Key、模型），其余键原样保留。DeepSeek Harness 的 patch 会替换整个 `llm-pi-ai` 配置，原文件同样在备份里。DeepSeek Harness 通过 `npx @deepseek-ai/dsh web` 运行，不需要安装，但要求 Node.js 24.9 及以上。Codex 的 `auth.json` 会整份替换：原来的 ChatGPT 登录保存在备份里，`npx @smaihub/cli undo` 能恢复。

## 安全

- 写入前展示完整 diff（Key 打码）并确认；每个文件先备份为 `<文件>.smai.bak-<时间>`，再原子写入。含 Key 的文件权限为 0600。
- `~/.smai/setup/history/` 里的运行记录只存内容的 sha256，不存 Key。
- Key 只写进各工具自己的配置文件，并通过请求头发给网关。不打印，不记日志，也不放进 URL。
- 安装只执行固定的 `npm i -g <官方包名>`。交互模式会先显示命令再询问；非交互模式要加 `--install` 才会安装。
- 不做后台刷新，也不自动更新。

## 环境要求

Node.js 18 及以上。安装工具时还要满足各工具自己的要求：Claude Code 需要 Node 22 及以上，OpenClaw 需要 Node 24.16 及以上。不满足时会提示原因，配置照常写入。

## 开发

```bash
npm test
```

测试在临时 home 目录里运行，并在 127.0.0.1 上起一个假网关，不会碰真实配置，也不访问网络。

第三方代码的来源和许可证见 [THIRD_PARTY_NOTICES.md](THIRD_PARTY_NOTICES.md)。
