自学教程

OpenCode 简介

OpenCode v2 是新一代开源AI编码代理(AI Coding Agent),支持终端TUI、桌面客户端、IDE扩展、Web网页会话四种形态。它不是简单聊天机器人,也不是IDE代码补全插件;可以读取整个本地项目,理解完整项目上下文,直接修改本地源码、执行完整开发任务。

提示:OpenCode 是 Agent(智能体),不是 Chat(聊天)。开发模式转变:开发者描述需求 → AI执行开发任务 → 开发者审查、决策代码。

OpenCode v2 核心新特性(对比V1)

  1. 多Agent子代理系统:可定义多个角色Agent(代码审查、文档生成、测试),会话中快速切换调用
  2. 桌面图形客户端:macOS / Windows / Linux 原生桌面App,不用局限终端操作
  3. Web配对会话 opencode pair:终端启动,浏览器打开网页界面,多人协同查看会话
  4. MCP服务器、插件扩展支持,自定义命令、主题、快捷键
  5. 权限细粒度控制,对文件读写、shell命令做权限管控
  6. 配置格式升级,AGENTS.md语法更新,支持多代理配置

OpenCode v2 可以做什么

  • 阅读大型代码库,解读模块逻辑,快速接手陌生项目
  • 完整新增业务功能:接口、页面、数据库逻辑
  • 重构代码、批量修改多处文件、修复Bug、编写单元测试
  • 先输出方案(计划模式)确认后再修改真实文件,降低改错风险
  • 代码审查Agent,只分析不修改代码
  • 会话生成分享链接,团队同步开发思路

OpenCode v2 不能做什么

  • 不能替代开发者做业务决策,AI产出代码必须人工审查
  • 不会自动解决项目编译、环境依赖报错,仍需要开发者处理
  • Windows原生PowerShell/CMD不支持v2;Windows必须WSL2或者下载独立二进制包

适合本教程的读者

  • 掌握至少一门编程语言 JS/Python/Java/Go,看得懂基础语法
  • 会基础终端命令,了解项目目录结构
  • 希望借助AI完成完整开发任务,不止生成代码片段
  • 独立开发者、前端后端工程师、维护项目的团队成员

OpenCode v2 和传统AI工具对比

特性聊天AI(ChatGPT/Claude网页)Copilot IDE插件OpenCode v2(Agent)
交互入口网页对话框IDE插件终端TUI / 桌面App / Web网页会话
项目文件访问手动粘贴代码片段仅当前打开文件完整读取整个本地项目
修改本地文件仅输出文本编辑器片段补全直接修改磁盘源码
上下文能力有限对话上下文单文件局部理解项目级全局上下文,支持多Agent
任务能力给方案、输出代码片段代码补全完整执行开发任务,支持插件/MCP

相关资源

标签:

0 条笔记