# Claude Code for VS Code（自建模型网关）

本目录用于安装 Anthropic 官方的 Claude Code VS Code 扩展，并连接到自建的 Anthropic Messages API 网关。模型推理请求发送到配置的网关；Claude Code 扩展及其工具仍由 Anthropic 发布。

> **兼容性说明：** Claude Code 官方不支持将它路由到非 Claude 模型。即使网关兼容 Anthropic Messages API，工具调用、权限、模型名和扩展升级仍可能有兼容性问题。本配置已在当前网关和模型上验证过。

## Linux / Remote SSH 一键安装

在 VS Code 的 **Remote - SSH 集成终端**中运行：

```bash
chmod 700 install.sh
./install.sh
```

脚本会：

1. 通过 `code` 命令安装或更新 `Anthropic.claude-code` 扩展。
2. 将网关、认证 Token、模型 ID、上下文和输出长度写入 VS Code Server 的 machine 设置。
3. 保留同一设置文件中的其他 Claude Code 环境变量及其他 JSON 设置。
4. 在普通 VS Code 用户设置中关闭登录提示，并将含 Token 的设置文件权限设为 `600`。

运行成功后，在 VS Code 按 `Ctrl+Shift+P`，执行 **Developer: Reload Window**，关闭旧 Claude 对话并新建对话。

需要先安装 VS Code，并通过 Remote - SSH 连接目标 Linux 主机。脚本要求 `code` 命令可用；如果找不到，请在 VS Code Remote SSH 集成终端中运行，或先从远程扩展面板安装 Claude Code。

若 VS Code 命令不在 `PATH` 中，可通过 `CODE_CLI=/绝对路径/code ./install.sh` 指定命令行启动器。

默认 machine 设置路径：

```text
~/.vscode-server/data/Machine/settings.json
```

如 VS Code Server 使用自定义数据目录，可设置 `VSCODE_SERVER_DATA` 后运行脚本。

## 当前网关配置

| 项目 | 值 |
|---|---|
| 网关地址 | `https://pro5000.cdxyl.online` |
| 模型 ID | `Qwen3.8-27B-FP8` |
| 认证方式 | `ANTHROPIC_AUTH_TOKEN`（Bearer Token） |
| 上下文窗口 | `131072` tokens |
| 最大输出 | `8192` tokens |
| 后台快速模型 | 与主模型相同 |

`install.sh` 和本 README 中的设置示例包含明文网关 Token，方便在受信任的个人电脑间直接复用。**这会把 Token 交给任何能读取该目录或副本的人。** 不要上传到公开仓库、网盘或聊天中；只在可信设备使用，并将脚本限制为自己可读写。Token 曾在聊天中暴露，建议先在网关轮换，再同步更新脚本和下方示例。

当前脚本中的配置值：

```text
ANTHROPIC_BASE_URL=https://pro5000.cdxyl.online
ANTHROPIC_AUTH_TOKEN=sk-llm-local-change-me
ANTHROPIC_MODEL=Qwen3.8-27B-FP8
ANTHROPIC_SMALL_FAST_MODEL=Qwen3.8-27B-FP8
CLAUDE_CODE_MAX_CONTEXT_TOKENS=131072
CLAUDE_CODE_MAX_OUTPUT_TOKENS=8192
```

如果 Token 轮换，只需将 `install.sh` 中的 `AUTH_TOKEN` 以及本 README 的示例值更新为新 Token，然后重新运行脚本。

## Remote SSH 手动检查

Remote SSH 下，扩展运行在 SSH 目标机的 VS Code Server 中。扩展环境变量属于 machine 范围，因此必须写入远程端的 `Machine/settings.json`，仅修改本机 VS Code 设置或项目的 `.vscode/settings.json` 不够。脚本会自动写入正确位置。

预期的机器设置结构如下（示例 Token 与脚本相同）：

```json
{
  "claudeCode.environmentVariables": [
    { "name": "ANTHROPIC_BASE_URL", "value": "https://pro5000.cdxyl.online" },
    { "name": "ANTHROPIC_AUTH_TOKEN", "value": "sk-llm-local-change-me" },
    { "name": "ANTHROPIC_MODEL", "value": "Qwen3.8-27B-FP8" },
    { "name": "ANTHROPIC_SMALL_FAST_MODEL", "value": "Qwen3.8-27B-FP8" },
    { "name": "CLAUDE_CODE_MAX_CONTEXT_TOKENS", "value": "131072" },
    { "name": "CLAUDE_CODE_MAX_OUTPUT_TOKENS", "value": "8192" }
  ]
}
```

## 使用及常见问题

- **登录提示：** 自建网关配置不需要 Claude 账号登录。若出现 `Not logged in · Please run /login`，确认脚本是在正确的 Remote SSH 主机执行，并检查 `~/.vscode-server/data/Machine/settings.json` 中是否有 `ANTHROPIC_AUTH_TOKEN`；保存后重载窗口并新建对话。
- **401 / 403：** 检查 Token 是否有效、是否已轮换，以及网关是否允许当前客户端访问。不要将 Token 发给他人排错。
- **模型不存在：** 检查网关注册的模型 ID 和大小写。
- **模型未识别警告但仍能回复：** `CLAUDE_CODE_MAX_CONTEXT_TOKENS` 已指定 `131072`，用于告诉 Claude Code 按网关实际上下文估算。
- **VS Code 可用但 CLI 不可用：** 本脚本安装和配置 VS Code 扩展，不会安装独立 Claude Code CLI。CLI 需要另外安装，并配置 `~/.claude/settings.json`。

## Windows

`install.ps1` 只从 VS Code 扩展市场安装扩展，不会写入网关凭据。Windows 用户请在 VS Code 的 **Preferences: Open Settings (UI)** 中配置 **Claude Code: Environment Variables**，使用上表相同的变量和值；将 `claudeCode.disableLoginPrompt` 设为 `true` 后重载窗口。

## 文件列表

| 文件 | 用途 |
|---|---|
| `install.sh` | Linux / Remote SSH 安装并配置扩展和网关 |
| `install.ps1` | Windows 安装扩展（网关变量需手动设置） |
| `README.md` | 安装、网关参数及故障排除说明 |
