Trae命令行工具使用指南

🚀 核心命令实战

基础操作

命令	作用	示例
trae	启动Trae主界面	trae
trae [项目路径]	在Trae中打开指定项目	trae ~/code/my-app
trae --new [项目名]	创建新项目并打开	trae --new demo-api
trae --builder	直接进入Builder模式	trae --builder

Builder模式自动化开发

用自然语言生成完整项目：

trae --builder "用React 18+TypeScript创建购物车应用，需含商品筛选和结算功能"

➔ Trae自动执行：
1. 创建项目结构ecommerce-cart/
2. 生成核心组件Cart.tsx、ProductList.tsx
3. 配置Redux状态管理
4. 启动本地开发服务器

🌐 国际版与国内版命令差异

功能点	国际版命令	国内版命令
账号登录	trae --login github	trae --login juejin
代理设置	trae --proxy 127.0.0.1:7890	无需手动设置
模型切换	trae --model claude-3.7	trae --model moonshot

⚠️ 避坑提示：
– 国内版登录需手机验证码（国际版需Github账号）
– 若遇command not found错误，检查~/.zshrc或~/.bashrc是否包含：

export PATH="$PATH:/Applications/Trae.app/Contents/Resources/bin"

🛠️ 高级场景应用

项目文件操作

# 用AI重命名组件文件并同步更新引用
trae --refactor src/components/Button.jsx --name "PrimaryButton"

# 自动生成单元测试
trae --test src/utils/calcPrice.ts

Python语音生成实例

trae --cmd "写Python脚本：用edge-tts将txt文本转语音，保存为output.mp3"

生成代码自动包含：
1. 安装依赖pip install edge-tts
2. 封装TTS转换函数
3. 错误重试机制

💡 高效技巧合集

1. 快速修复代码
   

   trae --fix src/components/CheckoutForm.tsx

2. AI解释复杂命令
   

   trae --explain "docker-compose up --build"

3. 跨项目操作
   

   trae --project api-server --cmd "npm install axios"

❓ 高频问题速查

Q：命令行调用Builder模式卡顿？
→ 检查网络连接，国内用户建议用--region cn参数：

trae --builder "创建Node.js天气API服务" --region cn

Q：无法识别已安装的trae命令？
→ 手动添加路径（macOS示例）：

ln -s /Applications/Trae.app/Contents/Resources/bin/trae /usr/local/bin/

最后的小贴士：善用trae --help获取实时命令文档，Trae会主动根据你的操作历史推荐个性化参数！🎯