Skip to content

Latest commit

 

History

3 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

dsh-trae-api (Trae Local API)

将 Trae Work CN 的积分/额度转化为本地 OpenAI/Anthropic 兼容 API 服务,让 Claude Code、Cursor、Cline、Windsurf 等第三方 AI 编程工具直接调用 Trae 底层模型(GLM、DeepSeek、Qwen、Kimi、MiniMax 等)。

本项目是一个 DeepSeek Harness (DSH) 插件,安装后随 dsh 启动自动运行代理服务;也可以独立运行。

原理

  1. 本机已安装并登录 Trae Work CN(或 TRAE SOLO CN / Trae SG / TRAE SOLO)
  2. 脚本自动从本地 storage.json 中解密认证 Token
  3. 启动本地 Express 服务器,提供 OpenAI/Anthropic 兼容的 API 端点
  4. 第三方 Agent 将请求发送到本地服务器,本地服务器转发到 Trae 上游 API
  5. 消耗的是 Trae 的积分,无需额外付费

支持的 Trae 版本

版本 IDE 名称 上游端点
cn Trae CN 国内版 trae-api-cn.mchost.guru
solo TRAE SOLO CN 独立部署版 trae-api-cn.mchost.guru
sg Trae 国际版 a0ai-api-sg.byteintlapi.com
solo-sg TRAE SOLO 国际版 a0ai-api-sg.byteintlapi.com

功能

  • 自动解密四版本认证数据,无需手动配置 Token
  • 提供 OpenAI (/v1/chat/completions) 和 Anthropic (/v1/messages) 兼容接口
  • 支持 OpenAI Responses API (/v1/responses)
  • Token 过期自动刷新,自动保存到 .env
  • 支持流式输出 (SSE)
  • 完整支持 Claude Code 工具调用
  • 3 级 API 端点回退机制
  • 上下文窗口自动截断,避免超出 Token 限制

前置条件

  • Node.js >= 18(内置 fetch 支持)
  • 已安装并登录以下任一 Trae IDE:Trae CN、TRAE SOLO CN、Trae(国际版)、TRAE SOLO(国际版)

快速开始

方式 A:作为 DSH 插件安装(推荐)

# 安装到 web profile
dsh plugin --profile web add dsh-trae-api
# 重启 dsh 使插件生效
dsh web

插件启动后,代理服务自动运行在 http://localhost:9220

卸载:

dsh plugin --profile web remove dsh-trae-api

方式 B:独立运行

npm install
start.bat    # Windows 一键启动

首次运行会自动从本机 Trae IDE 的 storage.json 解密认证数据并保存到 .env,之后直接读取 .env 启动。

连接第三方 Agent

Claude Code:

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

Cursor / Cline / Windsurf: 配置 OpenAI Compatible Provider,Base URL 为 http://localhost:9220/v1,API Key 为 trae-local-api

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
)

API 接口

方法 路径 说明
GET /v1/status 服务状态
GET /v1/models 模型列表
POST /v1/chat/completions OpenAI 格式对话
POST /v1/messages Anthropic 格式对话
POST /v1/messages/count_tokens 估算 Token 数
POST /v1/responses OpenAI Responses API

环境变量

变量 说明 默认值
TRAE_EDITION Trae 版本 (cn/solo/sg/solo-sg) cn
API_KEY 本服务的 API Key trae-local-api
PORT 监听端口 9220
HOST 监听地址 127.0.0.1
MAX_CONTEXT_TOKENS 最大上下文 Token 数 200000

完整环境变量列表见 .env.example

注意事项

  • 本工具仅在你已经拥有 Trae 积分的情况下有效,本质上是将 Trae 的 API 额度通过本地代理暴露为标准接口
  • 默认仅监听 127.0.0.1,局域网与公网无法访问
  • 默认启用 API Key 鉴权(默认值 trae-local-api,建议修改)
  • 请勿将 .env 文件提交到版本控制(已在 .gitignore 中忽略)

免责声明

本工具仅供学习和研究使用。使用本工具调用 Trae API 所产生的费用和合规问题由用户自行承担。请遵守 Trae 平台的使用条款。

License

MIT

About

DSH plugin: expose Trae Work CN credits as a local OpenAI/Anthropic compatible API

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages