模型：理解与判断
它理解你的目标、阅读已有信息，并决定下一步最值得做的事情。
OPEN CODE · 新用户入门
第一次用
OpenCode
不需要先懂 AI Agent，也不必记住一堆命令。告诉 OpenCode 你想完成什么，它会陪你读懂项目、规划步骤，再动手修改。
先提问 再确认 始终由你决定
~/my-project opencode
✦ 你好，我已经准备好了。想先了解这个项目吗？
你 这个项目是做什么的？从哪里开始看？
✦ 我会先阅读项目说明和主要目录，然后用简单的话告诉你：
- 项目解决什么问题
- 最重要的文件在哪里
- 下一步可以尝试什么
正在了解你的项目
›输入你想完成的事情⌘↵
01 / 从一个问题开始
不用先懂全部
从真实问题开始
先看再改
始终保有选择
02 / 先理解 Agent
它不只是会写代码的
聊天框。
模型负责理解和判断；Agent 则把模型、你的项目和可调用的工具放进一个循环。它读取事实，做下一步，再根据结果继续。
工具：读取与操作
工具让 Agent 能查看文件、搜索代码、执行命令和检查改动，而不只是生成文字。
上下文：当前的事实
项目文件、错误信息、命令输出和你的约束，都会影响它下一次的判断。
03 / Agent Loop
一次可靠执行，
会经历一个循环。
这不是“让 AI 直接把代码写完”。每个可见步骤都会产生新的事实，Agent 据此决定是继续、调整还是结束。
- 01
理解任务
提取目标、范围和完成标准。
- 02
检查现状
读取相关文件、错误和项目约定。
- 03
制定下一步
选择最小、最有信息量的动作。
- 04
调用工具
搜索、编辑、运行命令或测试。
- 05
观察结果
把输出、差异和失败变成新上下文。
- 06
验证与汇报
检查结果是否满足目标；不满足就进入下一轮。
对新手最重要的一点：不要只看最终答案。查看它读了什么、计划做什么、改了什么，以及如何验证。
04 / 怎样给任务
好任务不是越长越好，
而是信息刚刚好。
给 Agent 足够的事实，能减少猜测、缩小范围，也让你更容易检查它是否完成了工作。
你想得到什么
“修复移动端按钮溢出”
它需要知道什么
“发生在登录页，宽度 390px”
哪些事情不要做
“不要改其他页面或视觉样式”
怎样算完成
“运行测试，并检查桌面与手机”
05 / 三步入门
今天就能
完成第一次对话。
先在一个你熟悉的小项目中试试。目标不是立刻写出功能，而是建立一次清楚、可控的协作过程。
安装并打开你的项目
安装 OpenCode 后，在项目文件夹中运行 opencode。第一次只需让它认识你的项目。
问一个没有风险的问题
从“这个项目是做什么的？”、“入口文件在哪里？”开始。先观察回答，不急着让它改代码。
再尝试一个小改动
让它先说明计划，再帮你改一处文字或修复一个小问题。阅读差异，确认后再继续。
06 / 第一次怎么问
不知道说什么？
从这里开始。
选择一句复制到 OpenCode。它们都适合第一次接触一个项目，不会直接要求修改代码。
07 / 现在开始
打开终端，
说出你的第一个问题。
第 1 步：安装
$ npm install -g opencode-ai进入一个项目文件夹后，运行 opencode，然后试试上面的第一个问题。