# Claude Code 安装与接入 4SToken

Claude Code 使用 Anthropic Messages API（`POST /v1/messages`）。4SToken 网关会把请求路由到 Portal 配置的 Claude / GPT / OpenRouter 模型，GPT 系列也已支持这条消息线路。

脚本会写入 `~/.claude/settings.json`，并生成 `~/.claude/gateway-profiles/openrouter-free.json` 作为备用 profile。Claude Code 的 `ANTHROPIC_BASE_URL` 使用 Gateway 根地址，不要追加 `/v1`。

## 安装前准备

1. 已创建 Portal Client Key，格式为 `sk-...`。
2. 已安装 Node.js LTS 与 npm。
3. 确认网关 Base URL：`https://api.4stoken.cn/api`。
4. 确认要使用的 Claude Code 档位或 modelCode，例如 `sonnet`、`opus`、`haiku`、`claude-opus-4-8`、`gpt-5.5`、`openrouter-free`。

## Windows 安装与配置

1. 安装 Node.js LTS；如 PowerShell 环境受限，可使用 Git Bash。
2. 打开 PowerShell。
3. 安装 Claude Code：

```powershell
npm install -g @anthropic-ai/claude-code
```

4. 执行配置脚本：

```powershell
$f = Join-Path $env:TEMP 'claude-code.ps1'
Invoke-WebRequest -Uri '{PORTAL}/docs/scripts/claude-code.ps1' -OutFile $f -UseBasicParsing
powershell -NoProfile -ExecutionPolicy Bypass -File $f -ApiKey sk-你的Key
```

脚本会写入：

```text
%USERPROFILE%\.claude\settings.json
%USERPROFILE%\.claude\gateway-profiles\openrouter-free.json
```

关闭并重新打开终端，进入项目目录执行 `claude`。

## macOS / Linux 安装与配置

1. 安装 Node.js LTS。
2. 打开终端。
3. 安装 Claude Code：

```bash
npm install -g @anthropic-ai/claude-code
```

4. 执行配置脚本：

```bash
curl -fsSL '{PORTAL}/docs/scripts/claude-code.sh' \
  | GATEWAY_BASE_URL='https://api.4stoken.cn/api' bash -s -- sk-你的Key
```

如需覆盖默认模型档位：

```bash
GATEWAY_CLAUDE_SONNET_MODEL=claude-sonnet-4-6 \
GATEWAY_CLAUDE_OPUS_MODEL=claude-opus-4-8 \
GATEWAY_CLAUDE_HAIKU_MODEL=claude-haiku-4-5 \
curl -fsSL '{PORTAL}/docs/scripts/claude-code.sh' \
  | GATEWAY_BASE_URL='https://api.4stoken.cn/api' bash -s -- sk-你的Key
```

重新打开终端后进入项目目录执行 `claude`。

## 核心配置

- `ANTHROPIC_BASE_URL = https://api.4stoken.cn/api`
- `ANTHROPIC_AUTH_TOKEN = sk-你的Key`
- `ANTHROPIC_DEFAULT_SONNET_MODEL = claude-sonnet-4-6`
- `ANTHROPIC_DEFAULT_OPUS_MODEL = claude-opus-4-8`
- `ANTHROPIC_DEFAULT_HAIKU_MODEL = claude-haiku-4-5`
- `GATEWAY_OPENROUTER_FREE_MODEL = openrouter-free`
- `~/.claude/gateway-profiles/openrouter-free.json` 可作为备用 profile

## 模型映射

| Claude Code 档位 / profile | 默认 modelCode | 使用场景 |
| --- | --- | --- |
| `sonnet` | `claude-sonnet-4-6` | 默认主力模型，适合日常代码任务 |
| `opus` | `claude-opus-4-8` | 高复杂度规划、重构与长上下文分析 |
| `claude-opus-4-7` | `claude-opus-4-7` | 可用的 Opus 兼容档位 |
| `claude-opus-4-6` | `claude-opus-4-6` | 可用的 Opus 兼容档位 |
| `haiku` | `claude-haiku-4-5` | 轻量问答、快速修改与低成本验证 |
| `gpt-5.5` | `gpt-5.5` | GPT 系列主力模型，兼容 `/v1/messages` |
| `gpt-5.4` | `gpt-5.4` | GPT 系列稳定通道，兼容 `/v1/messages` |
| `gpt-5.4-mini` | `gpt-5.4-mini` | 轻量 GPT 档位，兼容 `/v1/messages` |
| `gpt-5.3-codex` | `gpt-5.3-codex` | Codex 定向模型，可在 Claude Code 中使用 |
| `gpt-5.3-codex-xhigh` | `gpt-5.3-codex-xhigh` | 高推理 Codex 档位，可在 Claude Code 中使用 |
| `gpt-5.2` | `gpt-5.2` | 通用 GPT 档位，兼容 `/v1/messages` |
| `gpt-5.4-nano` | `gpt-5.4-nano` | 低成本快速验证，兼容 `/v1/messages` |
| `openrouter-free` | `openrouter-free` | 脚本额外生成 profile，可作为免费/备用线路 |

完整可用模型以 Portal「模型与价格」或 `GET /v1/models` 为准。

## 配置检查

```bash
claude --version
curl -sS 'https://api.4stoken.cn/api/v1/models' -H 'Authorization: Bearer sk-你的Key'
claude
```

进入 Claude Code 后可执行 `/status`，确认当前 Base URL 与模型已生效。

## 手动配置

脚本不可用时，可直接编辑 `~/.claude/settings.json` 或 `%USERPROFILE%\.claude\settings.json`：

```json
{
  "model": "claude-sonnet-4-6",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.4stoken.cn/api",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "GATEWAY_OPENROUTER_FREE_MODEL": "openrouter-free"
  }
}
```

如果要默认使用 `gpt-5.5`，可以改成：

```json
{
  "model": "gpt-5.5",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.4stoken.cn/api",
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.5",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-8",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-haiku-4-5",
    "GATEWAY_OPENROUTER_FREE_MODEL": "openrouter-free"
  }
}
```

手动配置时请确认：

- `ANTHROPIC_BASE_URL` 不带 `/v1`
- `ANTHROPIC_AUTH_TOKEN` 已写入 Client Key
- `~/.claude/settings.json` 已更新

## 常见问题

### 终端里找不到 claude

请确认 `npm install -g @anthropic-ai/claude-code` 已完成，并重新打开终端。

### Windows 环境变量不生效

脚本优先写入 Claude Code 配置文件。请关闭所有终端窗口后重新打开，必要时重启系统；若企业策略限制脚本执行，可使用上方手动配置。

### Claude Code 里显示的不是新模型

请完全退出 Claude Code 后重新打开，并在会话内执行 `/status` 检查。只关闭当前会话可能不会重新读取 `~/.claude/settings.json`。

### 返回模型路由错误

Claude Code 默认走 `POST /v1/messages`。请确认对应 modelCode 在 Gateway 已配置可用路由；如使用 GPT / OpenRouter 模型，也需要该模型可被 Anthropic Messages 入站适配。

详情见 Portal：`/tools/claude-code`