OpenCode 操作指导书一介绍与概览适用版本OpenCode v1.18.32026-07-16 发布官方站点https://opencode.ai 文档https://opencode.ai/docs 仓库https://github.com/anomalyco/opencode本篇目标让学员在 10 分钟内理解 OpenCode 是什么、能做什么、为什么用它并建立后续学习路径。1. 什么是 OpenCodeOpenCode 是一款完全开源、构建于终端Terminal的 AI 编程智能体Coding Agent。它读取你的代码库、理解项目结构并通过大语言模型LLM帮你完成解释陌生代码、定位问题新增功能、重构、修复 Bug运行命令、读写文件、调用工具多会话并行、会话分享、GitHub 自动化它既可以在终端 TUI中使用也提供桌面端Desktop与IDE 扩展VS Code / Cursor但核心理念始终是你掌控代码AI 在本地帮你把想法变成改动。隐私优先OpenCode不会上传或存储你的源代码与上下文数据可运行在对隐私敏感的环境。2. 核心特性OpenCode原生 TUI可主题化LSP 自动加载为 LLM 提供语义多会话并行同一项目多 Agent会话分享链接调试/评审任意模型75 提供方任意编辑器终端/桌面/IDE隐私优先不上传代码特性说明学员价值原生 TUI响应式、可主题化的终端界面在 SSH / 服务器上也能用LSP 支持自动加载对应语言的 LSP让模型懂代码补全、跳转、诊断更准确多会话同一项目可同时开启多个 Agent 会话并行探索、互不干扰会话分享一条链接即可分享任意会话远程协作、复盘、求助任意模型通过 Models.dev 接入 75 提供方含本地模型不绑定单一厂商可省钱任意编辑器终端 / 桌面 / IDE 扩展均可融入既有工作流隐私优先不存储代码与上下文企业/敏感项目可用3. 工作原理架构OpenCode 在你本地运行作为编排层连接你的代码库与模型提供方API 调用差异/结果你 / 终端输入OpenCode TUIAgent 引擎build / plan / subagent工具集read/edit/bash/lsp/...LLM 提供方Anthropic/OpenAI/Google/本地项目文件系统Agent 引擎决定调用哪些工具、如何拆解任务内置 build / plan 等见第 05 篇。工具集读取、编辑、执行命令、LSP 查询、网络检索等均在你本地执行。模型提供方通过 API Key或本地推理提供推理能力OpenCode 本身不训练模型。4. 与其他工具对比维度OpenCodeClaude Code闭源商业 Agent开源✅ 完全开源❌ 闭源❌模型自由度75 提供方 本地主要 Anthropic厂商绑定运行环境终端/桌面/IDE终端/IDE多为云端多会话并行✅ 原生支持有限各异会话分享✅ 链接分享部分各异隐私不上传代码依条款依条款成本可用自有订阅/本地模型订阅制订阅制简言之OpenCode 把选择模型、运行环境、数据存储的主动权交还给你。5. 适用场景日常开发解释代码库、加功能、修 Bug、写测试。远程/服务器开发通过 TUI 在 SSH 会话中直接操作。团队协作用会话分享链接做代码评审与复盘。CI / 自动化在 GitHub 评论中opencode触发自动修复见第 07 篇。教学培训本系列文档即面向学员从零到熟练。6. 生态与版本版本当前稳定版v1.18.3发布于 2026-07-16。规模GitHub 16 万 Star、900 贡献者、月活开发者数百万级数据随版本更新以官网为准。更新opencode upgrade可一键升级见第 06 篇。7. 学习路径01 介绍与概览02 安装与配置03 界面与快捷键04 基础使用05 进阶使用06 CLI 命令参考07 实战案例08 常见问题与最佳实践建议顺序先装好02→ 熟悉界面03→ 跑通基础04→ 进阶能力05/06→ 跟着案例练07→ 查漏补缺08。8. 快速上手前置条件在开始前请准备一个现代终端模拟器WezTerm / Alacritty / Ghostty / Kitty 等。至少一个 LLM 提供方的 API Key推荐 Anthropic Claude Pro/Max性价比高也可本地模型。一个待练习的项目目录。下一步阅读02-安装与配置.md完成安装与认证。本篇为 OpenCode 操作指导书系列之一版本 v1.18.3。