# Claude Code CLI 接入 all in AI

本流程使用固定专用目录 `~/.all-in-ai/claude-guide`，保留原来的 `~/.claude`。面向 Windows PowerShell 与 macOS 的 Claude Code CLI，不等同于桌面端或编辑器扩展配置。

## 准备与模型权限

1. 确认 Claude Code CLI 已安装，`claude` 命令存在；需要 Node.js 20+ 运行统一准备工具。按统一入口校验工具后执行：

   ```text
   node "<准备工具路径>" prepare --client claude --with-image
   ```

   仅模型接入时省略 `--with-image`。它下载并校验本机对应的 `claude-manual-v2.ps1` 或 `claude-manual-v2.sh`，不启动 Claude，也不读取 Key。

2. 模型使用客户 Key 实际授权的完整 Claude ID，不能猜 `sonnet`、`opus` 等别名。若客户已在本机明确配置 `ALLINAI_API_KEY`，先运行：

   ```text
   node "<准备工具路径>" check --client claude
   ```

   仅 GET `/v1/models`。没有该变量时可由客户从本站模型广场确认完整 ID，检查结果报告“待本机权限验证”。不要从其他账号或原 Claude 登录文件中寻找 Key。

3. 用已选的完整 ID 创建无 Key 的专用配置：

   ```text
   node "<准备工具路径>" configure --client claude --model "<完整 Claude 模型 ID>"
   ```

   输出实际目录和 `settings.json`。已有相同设置时不修改；不同设置时拒绝覆盖，先检查现状并保留副本，再按用户的变更目标处理，不能自动删除。此工具不修改原 `~/.claude`，不保存 Key。

## 可选生图

本站手动启动器使用的实际 `CLAUDE_CONFIG_DIR` 为上面的专用目录。图片 Skill 必须装到同一目录中：

```text
node "<已校验本地 image-install.mjs>" --client claude --destination "<专用配置目录>/skills/allinai-image" --key-env ALLINAI_API_KEY
```

保留当前客户端自定义目录时必须使用真实 `CLAUDE_CONFIG_DIR`，不能假定 `~/.claude` 对所有会话生效。图像工具使用客户明确配置的 `ALLINAI_API_KEY`，不自动读取 Claude 登录 Token。客户可在启动 Claude 的本机终端隐藏输入自己的同一 Key 并设置该环境变量，前提是该 Key 包含图片权限；不要把明文值写到脚本、聊天或命令历史。

生图权限验证按[图片安装](https://api.muskloveai.com/skills/references/image.md)运行实际安装目录下的 `scripts/allinai-images.mjs check`，不自动生成图片。

## 客户启动

准备与只读检查结束后，交付已校验本地启动器路径。**不在只读安装验收中自动运行启动器**，因为启动客户端可能产生后台模型请求和费用。

Windows 在本机 PowerShell 运行：

```powershell
& '<已校验的 claude-manual-v2.ps1 绝对路径>'
```

macOS 在本机终端运行：

```bash
/bin/bash '<已校验的 claude-manual-v2.sh 绝对路径>'
```

客户在本机隐藏输入本站 Key，启动器仅把 Key 放进本次客户端进程环境，结束后恢复父终端相关环境。它使用 `https://api.muskloveai.com`（这里不追加 `/v1`）和专用配置，保留原登录配置；不支持企业宿主管理的连接。进入后可用 `/status` 确认地址和模型，再由客户发起任务。

官方说明：[网关接入](https://code.claude.com/docs/en/llm-gateway-connect)、[设置](https://code.claude.com/docs/en/settings)、[Skills](https://code.claude.com/docs/en/skills)。CLI／目录兼容与真实模型回复应分别验收，不能把文件写入成功说成 Claude 已实机生成通过。