安装
# 安装(需Node.js)
npm install -g opencode-ai
# 验证安装
opencode --version
ps:没有vpn的情况要切换npm国内镜像:
npm config set registry https://registry.npmmirror.com
允许系统执行脚本
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
启动opencode:opencode
opencode
plan模式生成项目框架,build模式生成代码。
tab键切换模式,build模式下输入"好,按计划执行"即可生成代码
初始化项目记忆:/init
分析项目结构并生成AGENTS.md。AGENTS.md是AI 在这个项目里的长期记忆说明书。
你应该在里面写清楚:
- 技术栈
- 构建与测试命令
- 代码规范
- 分层约束
- 异常处理方式
- 团队约定
- 禁止事项
例如:
- ORM 用 jOOQ,不许用 Hibernate
- 所有 public 方法必须写 Javadoc
- Controller 不能直接调 Repository
- 异常统一进 GlobalExceptionHandler
- 禁止循环内查数据库
这类信息对 AI 来说价值极高。
上下文压缩:/compact
大任务做久了,上下文会变重。
压缩会话,把关键上下文保留住,减轻 token 压力。
/compact