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 額度。
僅供學習和研究使用，費用和合規問題由用戶自行承擔。
默認鑑權配置建議根據實際安全需求修改。