必须完成开发环境配置才能启用trae work的code模式，包括切换至【code】模式、打开含工程标识文件的项目根目录、配置云端沙箱运行环境、启用git工作树隔离，并通过“检查当前开发环境状态”验证各字段是否就绪。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
在TRAE Work中启用Code模式进行真实项目开发前，必须完成开发环境配置——这一步跳过会导致AI无法读取项目结构、无法运行代码、无法调用终端命令，所有Agent任务会卡在“等待环境就绪”状态。
确认当前已切换至Code模式
点击界面左上角模式切换按钮，确保显示为【Code】而非Work或Design。若仍显示Work，后续所有配置将无效，AI会默认以文档处理逻辑响应代码需求。
网页版用户需刷新页面；桌面版用户若此前长期使用Work模式，建议重启客户端以清空缓存上下文。
打开真实项目文件夹
File → Open Folder → 选择含package.json、tsconfig.json或requirements.txt等工程标识文件的根目录。
不要打开单个文件，也不要打开空文件夹或桌面/文档等系统路径——AI需要识别完整项目拓扑才能加载依赖、解析跨文件引用、执行npm run dev等命令。
首次打开时右下角会出现“正在索引项目…”提示，耗时取决于文件数量，大型项目可能需10～90秒，期间勿关闭窗口或切换标签页。
配置云端沙箱运行环境
点击右下角终端图标旁的齿轮按钮 → 选择“沙箱环境设置” → 点击“自动检测并安装依赖”。
TRAE会扫描package.json或pyproject.toml，在隔离云端环境中安装对应Node.js/Python版本及依赖包。此过程不可跳过，本地已装的npm或pip不会被复用。
若检测到Dockerfile或docker-compose.yml，系统将自动启用容器化沙箱——此时终端面板会显示docker exec -it …前缀，表示所有命令均在容器内执行。
启用Git工程隔离（worktree）
第一步：点击左侧边栏Git图标 → 点击“初始化工作树”按钮。
第二步：输入分支名（如feat/login-validation），确认后TRAE将在云端创建独立代码快照，与你本地主分支完全隔离。
第三步：所有Code模式下的AI修改（包括Builder/Coder/Test智能体操作）仅作用于该worktree，不会触碰本地main或develop分支。
【关键前提】本地仓库必须已初始化Git且存在至少一个提交，否则“初始化工作树”按钮置灰不可点。
验证配置是否生效
在对话框输入：“检查当前开发环境状态”，AI将返回包含以下字段的JSON报告：
• projectRoot: 显示绝对路径
• language: 自动识别为TypeScript/Python/Java等
• dependencies: 列出已安装的包及版本
• gitBranch: 当前worktree分支名
• sandboxStatus: “ready”表示可执行代码
若任意字段为空或status为“pending”，说明某环节配置未完成，需回溯前四步逐一排查。
