最近我在研究 Trae IDE 的本地能力时，发现了一个挺有意思的开源项目：Trae Local API。它可以在本机启动一个兼容 OpenAI 与 Anthropic 请求格式的接口，让 Claude Code、Cursor、Cline 等工具通过统一的本地地址接入 Trae。

先说明：本文仅用于技术研究、兼容性测试和个人学习。请只使用自己的 Trae 账号与本机数据，并遵守 Trae、模型服务商及相关软件的使用条款。不要共享账号认证信息，也不要将本地接口暴露到公网。

项目能做什么？

简单来说，它在 Trae IDE 与第三方 AI 工具之间增加了一层本地适配服务。客户端仍然按照熟悉的 OpenAI 或 Anthropic 格式发起请求，项目负责完成格式转换、流式响应和模型选择。

功能	说明
OpenAI 兼容接口	提供 /v1/chat/completions，可供兼容客户端调用
Anthropic 兼容接口	提供 /v1/messages，适配 Claude Code 等工具
流式输出	使用 SSE 实时返回生成内容
模型映射	支持按名称映射模型，并提供分档与降级配置
多模态适配	遇到图片输入时，可按配置切换到支持视觉的模型
本地日志	提供 Dashboard 与请求日志，方便排查调用问题

整体链路：Claude Code / Cursor / Cline → 本地兼容 API → Trae IDE 的本机登录状态与服务能力 → 流式返回结果。

准备工作

• Windows、macOS 或 Linux 环境
• Node.js 18 或更高版本，建议使用 Node.js 20+
• 已安装 Trae IDE，并使用自己的账号正常登录
• Git，以及一个用于存放项目的本地目录

安装完成后，可以先在终端检查 Node.js 与 npm：

node --version
npm --version

下载并安装项目

使用 Git 获取源码：

git clone https://github.com/ZedeX/trae-local-api.git
cd trae-local-api
npm install

不方便使用 Git 的朋友，也可以在文末通过 GitHub 或网盘下载压缩包。解压后进入项目目录，再执行 npm install。

配置环境变量

复制项目提供的环境变量模板，并将其命名为 .env。下面是一份适合本机测试的基础配置：

TRAE_EDITION=cn
API_KEY=请替换为你自己生成的高强度随机密钥
PORT=19900
WORKSPACE_DIR=./output

TRAE_EDITION 用于选择 Trae 版本；API_KEY 是本地客户端访问接口时使用的密钥；PORT 是监听端口；WORKSPACE_DIR 是文件输出目录。

不要把真实的 .env、JWT、刷新令牌、Trae 本地存储文件或请求日志上传到 GitHub、网盘及公开文章中。

启动本地服务

npm start

正常启动后，终端会显示本地服务地址，默认是 http://127.0.0.1:19900。浏览器打开该地址，还可以查看项目提供的 Dashboard。

建议始终让服务只监听本机回环地址。不要直接在路由器、安全组或防火墙中开放 19900 端口。

检查服务状态

将示例中的密钥替换成你在 .env 中设置的值：

curl http://127.0.0.1:19900/health

curl http://127.0.0.1:19900/v1/models \
  -H "Authorization: Bearer 你的本地API密钥"

测试 OpenAI 兼容接口

curl -N http://127.0.0.1:19900/v1/chat/completions \
  -H "Authorization: Bearer 你的本地API密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"auto","messages":[{"role":"user","content":"你好，请简单介绍一下你自己。"}],"stream":true}'

如果终端开始持续返回 SSE 数据，说明本地接口已经能够正常接收并转发请求。

接入 Claude Code

在 PowerShell 中临时设置环境变量：

$env:ANTHROPIC_BASE_URL = "http://127.0.0.1:19900"
$env:ANTHROPIC_API_KEY = "你的本地API密钥"
claude

这里的密钥不是云平台密钥，而是你在本地 .env 中自行设置的访问口令。

接入 Cursor 或 Cline

配置项	填写内容
Provider	OpenAI Compatible
Base URL	http://127.0.0.1:19900/v1
API Key	你在 .env 中设置的本地密钥
Model	auto，或项目支持的模型名称

常见问题

启动后提示没有可用的认证信息

先确认 Trae IDE 已安装并正常登录，再在 Trae 内完成一次普通对话，然后重启本地服务。不要从他人设备复制认证文件。接口返回 401

先检查请求中的本地 API Key 是否与 .env 一致。如果是 Trae 登录状态过期，请重新打开 Trae IDE 完成登录，再重启项目。能在服务器上部署吗？

这个项目依赖本机 Trae 登录状态，更适合个人电脑上的本地实验。将它部署到公网服务器会显著增加账号凭据泄露、接口被滥用和费用异常等风险，不建议这样做。为什么客户端连接不上？

检查服务是否仍在运行、端口是否被其他程序占用、Base URL 是否多写或漏写了 /v1，以及系统代理是否改写了本地请求。

安全与合规提醒

1. 只处理自己的账号、本机文件和合法授权的数据。
2. 服务仅绑定 127.0.0.1，不要向公网开放端口。
3. 为本地接口设置随机、足够长的 API Key。
4. 妥善保护 .env、Trae 本地存储、日志和工作区输出。
5. 项目更新后先查看代码变更，再重新安装依赖和运行。
6. Trae 或上游接口发生变化时，项目可能暂时失效。
7. 请遵守相关产品服务条款，不要用于绕过权限、转售服务或批量滥用。

写在最后

从技术角度看，Trae Local API 的价值主要在于“协议适配”：它把不同 AI 工具的调用方式统一到了常见接口格式，降低了本地联调和 Agent 工具切换的成本。

不过，这类项目会接触账号认证与本地数据，使用时最重要的不是追求公网部署，而是守好边界：仅限个人研究、只在本机运行、定期检查源码，并确保任何敏感信息都不离开自己的设备。

项目地址：GitHub – ZedeX/trae-local-api

备用网盘下载：

参考来源：吾爱破解原技术讨论帖

---

本文由小鑫 Alexin 整理，仅作技术学习与项目体验记录。