4SToken
返回工具目录
CLI / Agent

Claude Code

Anthropic CLI；/v1/messages，含 openrouter-free profile

/v1/messages一键写入配置docs/ai-gateway-editor-claude-code.md
创建 API Key
Base URLhttps://api.4stoken.cn
鉴权方式Authorization: Bearer sk-...
协议/v1/messages
Download

下载安装教程

先安装工具本体，再运行 4SToken 配置脚本。Windows 与 macOS / Linux 分开操作。

官方下载 / 安装入口
安装前准备
准备已创建 Portal Client Key，格式为 sk-...
准备已安装 Node.js LTS 与 npm
准备目标 Claude / GPT / OpenRouter modelCode 已在 Gateway 配置可用路由
Windows
1安装 Node.js LTS；如 PowerShell 受限可改用 Git Bash
2执行 npm install -g @anthropic-ai/claude-code
3打开 PowerShell 执行本页 Windows 脚本
4脚本会写入 %USERPROFILE%\.claude\settings.json 与 openrouter-free profile
5关闭并重新打开终端，进入项目目录执行 claude
macOS / Linux
1确认 node -v 与 npm -v 可正常输出
2执行 npm install -g @anthropic-ai/claude-code
3运行本页 macOS / Linux 脚本写入 ~/.claude/settings.json
4需要覆盖默认档位时设置 GATEWAY_CLAUDE_SONNET_MODEL / OPUS / HAIKU 后重跑脚本
5进入项目目录执行 claude
Install

配置命令

将命令中的 YOUR_API_KEY 替换成你的 Client Key。

macOS / Linux
curl -fsSL https://4stoken.cn/docs/scripts/claude-code.sh | GATEWAY_BASE_URL='https://api.4stoken.cn' bash -s -- YOUR_API_KEY
Windows PowerShell
$f = Join-Path $env:TEMP 'claude-code.ps1'; Invoke-WebRequest -Uri 'https://4stoken.cn/docs/scripts/claude-code.ps1' -OutFile $f -UseBasicParsing; powershell -NoProfile -ExecutionPolicy Bypass -File $f -ApiKey YOUR_API_KEY

查看 bash 脚本源码查看 PowerShell 脚本源码

Verify

配置检查

按顺序检查：先测接口连通，再做模拟调用，最后回到具体软件核对配置是否真正生效。

连通性检查

先确认 Key、Base URL 与模型列表接口可达。

执行模型列表查询，确认返回 200 且能看到可用模型
curl https://api.4stoken.cn/v1/models -H "Authorization: Bearer YOUR_API_KEY"

模拟调用

绕开客户端先打一次最小请求，确认网关协议与模型路由正确。

执行最小请求，确认没有 401、403、404、模型不存在或无路由错误
curl https://api.4stoken.cn/v1/messages -H "x-api-key: YOUR_API_KEY" -H "anthropic-version: 2023-06-01" -H "Content-Type: application/json" -d "{\"model\":\"claude-sonnet-4-6\",\"max_tokens\":64,\"messages\":[{\"role\":\"user\",\"content\":\"hello\"}]}"

其他

回到具体软件内确认配置文件、界面设置或重启步骤已经生效。

执行 claude --version
启动 claude
在 Claude Code 内执行 /status，确认 Base URL 与模型已生效
Models

模型映射

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

Claude Code 走 POST /v1/messages，脚本会把 ANTHROPIC_BASE_URL 指向 Gateway 根地址，不要追加 /v1。

这里的 GPT 系列也已加入 /v1/messages 兼容模型列表，可直接在 Claude Code 里切换使用。

Manual

Claude Code 手动配置

脚本不可用时，可直接编辑 ~/.claude/settings.json 或 %USERPROFILE%\.claude\settings.json；Base URL 保持 Gateway 根地址。

默认三档配置：

{
  "model": "claude-sonnet-4-6",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.4stoken.cn",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_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，直接把主模型和常用档位指向同一个 modelCode：

{
  "model": "gpt-5.5",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.4stoken.cn",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_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"
  }
}

也可以新建 ~/.claude/gateway-profiles/gpt-5.5.json，需要时用 /model gpt-5.5 切换：

{
  "model": "gpt-5.5",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.4stoken.cn",
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "gpt-5.5"
  }
}
Notes

接入边界

  • 脚本仅修改本机工具配置文件，可通过上方源码链接审计。
  • 执行前可设置 GATEWAY_BASE_URL 覆盖默认网关地址。
  • GET /v1/realtime 未开放，不影响编程工具接入。