OpenCode使用教程

模型中立不绑定任何AI厂商支持超75家模型提供商。终端优先在终端里运行启动快资源占用低。本地优先代码和对话历史默认存储在本地支持离线部署。 第一步安装与环境准备在安装前请确保你的电脑上有 Node.js 18 或更高版本。主要安装方式npm最常用在终端执行 npm install -g opencode-ai。一键安装脚本适合新手执行 curl -fsSL https://opencode.ai/install | bash。包管理器macOS/Linux (Homebrew)brew install sst/tap/opencodeWindows (Scoop)scoop install opencodeWindows (WSL)如果遇到兼容性问题推荐在WSL环境中运行。Snap (Linux)sudo snap install opencode --classic验证安装安装完成后运行 opencode --version如果出现版本号即表示成功。 第二步配置AI模型最关键的一步OpenCode本身免费但需要你自行配置AI模型的API Key。方式一环境变量最快在终端中设置环境变量例如Claude (Anthropic)export ANTHROPIC_API_KEY“你的密钥”OpenAIexport OPENAI_API_KEY“你的密钥”Google Geminiexport GEMINI_API_KEY“你的密钥”Windows PowerShell使用 $env:变量名 “值” 格式方式二交互式登录更直观在终端运行 opencode auth login然后根据提示选择你的AI提供商如Anthropic, OpenAI等并输入API Key。方式三配置文件最灵活配置文件位置macOS / Linux: ~/.config/opencode/opencode.jsonWindows: C:\Users你的用户名.config\opencode\opencode.json一个配置文件的示例{“$schema”: “https://opencode.ai/config.json”,“provider”: {“deepseek”: {“api”: “openai-compatible”,“name”: “DeepSeek”,“options”: {“baseURL”: “https://api.deepseek.com/v1”},“models”: {“deepseek-chat”: {}}}}}你可以通过修改 baseURL 和 models 来接入不同的模型甚至是通过AI网关或本地模型如Ollama。 第三步基本使用与核心命令启动在项目目录终端输入 opencode。初始化首次必做在OpenCode界面中输入 /init。它会扫描项目生成 AGENTS.md 文件作为后续对话的上下文。开始对话直接在界面输入自然语言指令比如“解释一下这个 auth.js 文件的作用”。核心斜杠命令 (/)/init初始化项目配置/add将特定文件添加到上下文供AI分析支持通配符如 *.ts/models查看并切换当前使用的AI模型/undo撤销AI上一次的修改操作/share生成当前对话的公开分享链接/compact压缩对话历史在对话过长或跑题时使用/web让AI联网搜索最新信息/review让AI对代码进行审查️ 第四步核心工作流与高级功能Plan / Build 双模式这是OpenCode提高效率的核心机制。Plan模式规划AI只分析代码并生成修改计划不会修改任何文件。适合进行代码审查或复杂功能的前期设计。Build模式构建AI根据确定的计划直接执行代码的创建和修改。最佳实践先让AI在Plan模式下生成计划并确认无误后再按 Tab键 切换到Build模式执行。这种“先规划后执行”的策略能显著提升代码质量。强大的内置工具OpenCode内置了丰富的工具让AI能深度操作系统。你可以在项目根目录的 opencode.json 文件中通过 permission 字段精细控制每个工具的权限allow允许, deny禁止, ask询问。文件操作类read读取文件、edit修改文件、write创建新文件检索与查询类grep正则搜索内容、glob匹配文件路径终端与网络类bash执行终端命令、webfetch获取网页内容 第五步实用技巧与场景修复Bug直接说“修复 api/users.ts 里的类型错误”OpenCode会自动定位并修改。添加功能例如“给Express项目加个用户注册接口需要邮箱验证和密码加密”它会生成路由、控制器等一系列文件。国内用户如果没有稳定的网络环境推荐使用国产模型如DeepSeek或通义千问或者使用Ollama运行本地模型。