Trae CLI 延伸阅读
指南中发布的、面向 Trae CLI 设计工作的教程、文档和演练。
如何在 OpenDesign 中用 Trae CLI 设计界面:你带来的模型、每一步都由真实浏览器进行校验、一个从 brief 到审阅完成文件的落地页任务,以及开始前需要了解的局限。
“一个可以在真实浏览器中
逐次检查的产品页面。”
一次完整的 Trae CLI 设计流程
你交付的简报与约束、返回的产物,以及在你说完成之前仍需做的检查。下面的界面是专为本页制作的示例,并非一次真实的 Trae CLI 运行记录。
Brief为一个文档产品设计落地页:首屏主视觉、看起来像实时的搜索演示、三项优势,以及客户 logo。在真实浏览器中按两种宽度检查每一轮。
data-od-id 挂钩撰写简报、选择设计系统,并定义验收标准。
规划布局,编写 HTML、CSS 和 JavaScript,然后按请求修改。
提供设计系统与技能,渲染预览,并将每个版本存为项目文件。
在交付前检查视觉层级、8px 网格间距、两个断点,以及每一处交互。
首屏主视觉与优势区落在 8px 网格上;搜索演示保持固定高度,页面不会跳动。
标题、搜索演示,然后是优势区;强调色只用于开始按钮。
文案在前,随后是演示,再是优势模块;logo 在其所在行内水平滚动。
聚焦演示区域,依次查看两个 CTA,滚动 logo 行。
Fit
兼容性
本指南介绍通过 OpenDesign 桌面应用连接的 Trae CLI。所引用的公开资料核对于 2026 年 9 月 6 日。
Trae CLI 是字节跳动开源的(MIT)终端 AI 代理,以 trae-agent 项目发布。它能读取你的代码库、编辑文件,并根据自然语言任务运行 shell 命令。如果你需要判断 OpenDesign 是替代还是补充 Trae IDE,请参阅OpenDesign 与 Trae 的对比。本页讨论的是通过 OpenDesign 用 Trae CLI 设计界面,而非 Trae CLI 自身的界面。OpenDesign 的设置说明列出了可用的代理。
你自己的 LLM 提供方 API 密钥(BYOK)——OpenAI、Anthropic、Google、OpenRouter、Doubao、Azure 或本地 Ollama。用你自己的 LLM 提供方密钥(BYOK)进行身份验证——凭据留在你的机器上。本页不承诺任何配额或价格。
桌面版构建请查看下载页。源码快速开始中的 Node.js 与 pnpm 要求适用于从源码运行,而非安装桌面安装包。最低兼容的 Trae CLI 版本:此处未核实。
按照您安装版本中显示的连接说明操作,然后运行一个小任务。确认 Trae CLI 已处理该任务,并且产物可以打开。仅完成下载并不代表已建立可用连接。
从桌面应用开始
先下载,针对你安装的版本完成 Trae CLI 设置,然后检查一个小结果。这条路径不要求从源码构建 OpenDesign。
选择适合您电脑的软件包,安装并打开该应用。
下载 OpenDesign按照您安装版本中的 Trae CLI 说明操作。使用您自己的 LLM 提供商 key(BYOK)进行身份验证——凭据保留在您的本机上。
Trae documentation# 1. Get Trae CLI (trae-agent) from source — needs uv
git clone https://github.com/bytedance/trae-agent.git
cd trae-agent
uv sync --all-extras
source .venv/bin/activate
# 2. Authenticate by pointing it at your LLM provider key
# set it in the environment (or a trae_config.yaml file)
export OPENAI_API_KEY=... # or ANTHROPIC_API_KEY, GOOGLE_API_KEY, etc.摘自已发布指南中的 Trae CLI 设置说明;请查阅供应商文档以获取当前命令。
从一个足够小的简报开始,小到能评判整个闭环,包括一次修改。
构建一个设置页面,包含个人资料表单和保存确认提示。使用我的设计规则。在桌面和移动端宽度下进行检查。
若要从源代码运行 OpenDesign,请参阅技术快速入门。
Trae CLI 设计工作流
一个产品页会走完 Trae CLI 的简报、规则、构建、浏览器评审与修改各环节。每一步都点明你的输入、Trae CLI 的动作、OpenDesign 的贡献以及你的检查。
三到六行朴素文字:受众、页面用途、目标平台。
设计系统加上硬性约束,是品牌贴合的输出与 AI 默认样式之间的分界线。
Trae CLI 生成一个自包含的 HTML 文件:布局、样式、交互与稳定挂点。
OpenDesign 按你指定的宽度渲染文件。这是做判断的时刻。
data-od-id 目标,供评论与编辑使用。指向预览元素即可请求修改。每次修改都会生成新文件;不会静默覆盖。
资源
指南中发布的、面向 Trae CLI 设计工作的教程、文档和演练。
限制
常见问题
# 1. Get Trae CLI (trae-agent) from source — needs uv
git clone https://github.com/bytedance/trae-agent.git
cd trae-agent
uv sync --all-extras
source .venv/bin/activate
# 2. Authenticate by pointing it at your LLM provider key
# set it in the environment (or a trae_config.yaml file)
export OPENAI_API_KEY=... # or ANTHROPIC_API_KEY, GOOGLE_API_KEY, etc.
# 3. Run a task in your project
trae-cli run "Create a hello world page"
# or hold a session:
trae-cli interactive
# 4. Check the resolved configuration (keys are masked)
trae-cli show-configtrae-cli interactive
# in the session:
> Implement the attached reference design in React + Vite + Tailwind + TypeScript.
Reuse my existing design-system components and tokens.
Match spacing, layout, and hierarchy; make it responsive.
Run the dev server, render it in the browser, and iterate until it
matches the references across breakpoints.先运行一个精简任务;判断往返效果,然后再带上完整需求。选择与你的设置匹配的选项;本页不会自动检测。