dsh-trae-api: 将 Trae 积分转化为本地 OpenAI 兼容 API

前言¶

第三方 AI 编程工具（如 Claude Code、Cursor、Windsurf）通常要求使用 OpenAI 或 Anthropic 兼容的 API 端点。如果你持有 Trae Work CN 的积分或额度，可以通过 DSH 插件 dsh-trae-api 在本地运行一个代理服务，将这些额度转化为标准接口。

该插件作为一个 DeepSeek Harness (DSH) 插件（npm 包名 @casually/dsh-trae-api），随 dsh 进程启动自动运行代理服务，也可以独立运行。

前置条件¶

已安装并登录 Trae IDE（支持 Trae CN、TRAE SOLO CN、Trae SG、TRAE SOLO）。
Node.js 版本 >= 18。
对应 IDE 的 %APPDATA% 目录下存在 globalStorage/storage.json。

安装与启用¶

推荐通过 DSH 插件管理器安装。

# 安装到 web profile
dsh plugin --profile web add @casually/dsh-trae-api

# 重启 dsh 使插件生效
dsh web

安装后，代理服务默认运行在 http://localhost:9220。

核心功能¶

插件提供以下能力：

自动解密认证数据：自动从本地 storage.json 中解密认证 Token，支持 tc 加密和明文格式。
兼容接口：提供 OpenAI (/v1/chat/completions) 和 Anthropic (/v1/messages) 兼容接口。
流式输出：支持 SSE 流式响应。
工具调用支持：完整支持 Claude Code 工具调用。
端点回退机制：3 级 API 端点回退机制，提升稳定性。
格式自适应：自适应 CN/SG 两种 SSE 事件格式。
自动刷新：Token 过期时自动刷新并回写 .env 文件。
上下文截断：自动截断上下文以避免超出 Token 限制。
Web 设置页面：提供 DSH Web 设置页面，支持实时状态查看、请求统计、Token 管理、配置热更新等。

接入示例¶

Claude Code¶

$env:ANTHROPIC_BASE_URL = "http://localhost:9220"
$env:ANTHROPIC_API_KEY = "trae-local-api"
claude

Cursor¶

Base URL: http://localhost:9220/v1
API Key: trae-local-api
Model: 任意模型名（如 claude-sonnet-4-6、gpt-4o、auto）

Python (OpenAI SDK)¶

from openai import OpenAI

client = OpenAI(base_url="http://localhost:9220/v1", api_key="trae-local-api")

response = client.chat.completions.create(
    model="auto",
    messages=[{"role": "user", "content": "Hello!"}],
    stream=True
)

for chunk in response:
    if chunk.choices[0].delta.content:
        print(chunk.choices[0].delta.content, end="", flush=True)

配置与安全¶

默认鉴权：默认启用 API Key 鉴权，默认值为 trae-local-api。
网络限制：默认监听 127.0.0.1，CORS 仅允许 localhost 来源。
局域网访问：如需局域网访问，需设置 HOST=0.0.0.0 并同时设置强 API_KEY。
Token 管理：Token 过期会自动刷新并保存到 .env，请勿将 .env 文件提交到版本控制。
环境变量：
- TRAE_EDITION: Trae 版本 (cn/solo/sg/solo-sg)，默认 cn。
- API_KEY: 本服务 API Key，默认 trae-local-api。
- PORT: 监听端口，默认 9220。
- HOST: 监听地址，默认 127.0.0.1。

注意事项¶

本工具仅在已拥有 Trae 积分时有效，本质上是消耗 Trae 的 API 额度。
仅供学习和研究使用，费用和合规问题由用户自行承担。
默认鉴权配置建议根据实际安全需求修改。