St Claude CLI Bridge — Development skill for Claude Code

Claude CLI Bridge

把本机已登录的 **Claude Code CLI** 包装成 **OpenAI Chat Completions 兼容接口**，供各类聊天／角色扮演前端（如 SillyTavern 的 Custom (OpenAI-compatible) 源）直接调用。Node.js 22+，无第三方运行时依赖，不需要填写 Anthropic API Key，也不读取或复制登录凭据。

使用

git clone https://github.com/Mar7thLover/st-claude-cli-bridge.git
cd st-claude-cli-bridge
npm run doctor
npm start

Windows 下也可以双击 `start.cmd`。桥接地址：`http://127.0.0.1:8788/v1`。Claude Code 未登录时，先在自己的终端运行 `claude auth login`。

Windows 后台运行可使用 `./start-background.ps1`，停止使用 `./stop-background.ps1`。停止前先取消正在进行的生成；日志和 PID 存于 `.runtime`。前台和后台两种启动方式选一种，避免重复占用端口。

在前端中按 OpenAI Chat Completions 接口配置：

配置	值
接口类型	OpenAI Chat Completions 兼容（SillyTavern：API 选 Chat Completion，Source 选 Custom (OpenAI-compatible)）
Base URL	http://127.0.0.1:8788/v1
API Key	默认留空；设置 server.apiKey（或 BRIDGE_API_KEY）后填相同值
模型	从 /v1/models 列表中选择，如 sonnet；也可指定 Claude Code 支持的完整模型 ID

角色卡、预设、Persona、世界书、作者注释等由前端负责组装（宏展开、世界书触发、深度注入、正则和历史分支选择）；桥接器只接收组装后的完整消息，不再次拼接，避免重复注入。

模型和思考控制

桥接器每次启动，通过 Claude Code SDK 的 `initialize` 控制消息读取当前账号的模型菜单和 effort 能力；发现菜单不发起模型生成，也不保存账号身份信息。由于 CLI 菜单只列最新模型，桥接器另外补充官方仍在服务的历史模型目录。`GET /v1/models` 返回菜单项、完整 ID、常用别名及旧版模型。`npm run models` 可随时重新查询，`npm run models -- --json` 输出详细能力。菜单随 Claude Code 版本、账号与提供商变化；用户额外配置的模型标记为 `configured`。

2026-10-16，Claude Code 2.1.301、firstParty 登录发现以下 13 个 ID／别名（归属于 4 个模型）。effort 档位取自 CLI 菜单，上下文和默认值取自[官方模型概览](https://platform.claude.com/docs/en/about-claude/models/overview)，「关闭思考」一栏是经桥接器实测的结果：

模型	可传入的 model 值	effort（API 默认）	关闭思考
Opus 5.5	default、opus、opus[1m]、claude-opus-5-5	low～max 五档（medium）	不允许：模型始终思考
Fable 5.1	fable、best、claude-fable-5-1、claude-fable-5-1[1m]	五档（high）	不允许：模型始终思考
Sonnet 5.5	sonnet、sonnet[1m]、claude-sonnet-5-5	五档（high）	不允许：CLI 的关闭设置对它不生效
Haiku 5.5	haiku、claude-haiku-5-5	五档（medium）	不允许：同上

四个模型都是 1M 上下文、128K 最大输出。`default` 当前解析为 `claude-opus-