opencode 2.2.6为opencode run加入新工作树运行选项，适合需要把脚本会话放在独立git工作目录中的场景。它与普通打开项目不同，参数、历史会话和后台任务的边界需要分别核对。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

OpenCode官方CLI文档中的项目运行入口

先确认版本与当前项目

使用包含这项功能的2.2.6或后续版本，并在对应Git项目中运行命令。已有未提交修改、分支状态和工作树约束应先检查，不要把创建工作树误解为自动提交或自动合并代码。

自动生成或指定工作树名称

opencode run -w "概述这个项目的结构，不修改文件"
opencode run --worktree=topic-a "检查项目的主要入口，不修改文件"

裸-w会使用自动生成的名称。需要指定名称时，用等号形式--worktree=topic-a；参数解析不会把空格后面的提示词自动当作工作树名。--worktree不能同时搭配--continue或--session。

脚本会话可以创建后直接归档

opencode run --archived "概述这个项目的结构，不修改文件"

归档可以让脚本与CI运行记录不出现在常用收件箱、首页和会话列表，并且不会被--continue选中。归档不是删除，也不代表代码变更已被接受；需要继续查看结果时应按会话记录核对。

如知AI笔记

一款支持Markdown和AI能力的在线笔记工具，可用于记录、整理和搜索知识内容，并辅助用户进行文本创作与信息处理。

下载

CI需要另行安排超时

新版run会等待它启动的后台Shell命令、子任务和图片任务，并让模型处理结果后退出。如果提示词启动了持续运行的服务器或文件监听，命令可能一直等待。应结合CI工具设置合理超时，不把没有退出直接等同于程序卡死。