OpenCode1. OpenCode 是什么OpenCode 是一个开源的 AI 编程助手可以在终端、桌面应用和 IDE 插件中使用。它的核心作用是让 AI 直接理解你的项目目录帮你分析代码、修改文件、运行命令、生成项目。常用资源资源链接官网https://opencode.ai/中文文档https://opencode.ai/docs/zh-cnGitHubhttps://github.com/anomalyco/opencode下载页面https://opencode.ai/download关键数据截至 2026 年GitHub Star160,000贡献者900月活开发者7,500,0002. 为什么选择 OpenCodeOpenCode 的主要特点开源工具本身开放可由社区维护和扩展。模型灵活可以连接 OpenAI、Google、DeepSeek、Qwen、Ollama 等不同模型支持 75 LLM 提供商。可定制可以通过配置文件、Agent、Skills、MCP 等方式扩展能力。成本灵活工具免费主要成本来自你选择的模型服务。适合国内开发者可以接入国产模型也可以使用本地模型降低单一平台不可用的风险。隐私优先不存储任何代码或上下文数据适合对隐私敏感的环境。OpenCode vs Claude Code 对比对比项OpenCodeClaude Code开源情况开源闭源商业产品模型选择支持 75 模型供应商主要绑定 Claude定制能力高可配置 Agent、Skills、MCP相对有限使用成本工具免费模型按供应商计费通常需要 Claude 订阅运行方式终端 / 桌面应用 / IDE 插件终端 / 桌面应用 / IDE 插件适合人群想灵活控制工具链的开发者想要 Claude 原生体验的开发者3. 安装 OpenCode官方下载地址https://opencode.ai/download3.1 环境准备安装前确认以下条件条件说明操作系统macOS / Linux / Windows推荐 WSL终端工具WezTerm、Alacritty、Ghostty、Kitty 等现代终端API Key需要配置至少一个 AI 服务商的密钥3.2 Windows 安装方式一NPM 安装需先安装 Node.jsnpm install-g opencode-ai方式二Scoop 安装scoop install opencode方式三Chocolatey 安装choco install opencode推荐Windows 用户建议使用 WSL体验通常更稳定。详见 WSL 安装指南。3.3 Linux 安装# 一键安装推荐curl-fsSLhttps://opencode.ai/install|bashArch Linux 用户sudopacman-Sopencode3.4 macOS 安装# 推荐使用官方 tap更新更快brewinstallanomalyco/tap/opencode# 或使用官方 brew formula更新较慢brewinstallopencode3.5 Docker 运行dockerrun-it--rmghcr.io/anomalyco/opencode3.6 VS Code 插件安装OpenCode 也提供了 VS Code 插件可以在扩展市场中搜索opencode安装。3.7 桌面应用BetaOpenCode 还提供桌面应用支持 macOS、Windows 和 Linux平台下载macOS (Apple Silicon)opencode-desktop-mac-arm64.dmgmacOS (Intel)opencode-desktop-mac-x64.dmgWindowsopencode-desktop-windows-x64.exeLinux.deb / .rpm / .AppImage下载地址https://opencode.ai/download3.8 验证安装在终端执行opencode--version如果输出类似1.14.23的版本号说明安装成功。启动 OpenCodeopencode启动后即可看到 OpenCode 的 TUI 界面在底部输入框中输入问题即可开始对话。4. 打开项目OpenCode 必须在某个项目目录中运行这个目录就是它的工作目录。方式一先切换目录再启动cd你的项目目录 opencode方式二直接指定目录opencode d:/projects/my-app注意进入 OpenCode 后不能像普通终端一样随意切换工作目录。如果要处理另一个项目建议退出后重新在目标目录启动。4.1 项目内搜索文件进入项目后OpenCode 会自动索引项目文件。当你提出需求时AI 会主动搜索相关文件。可以使用符号后面跟上文件名进行搜索文件名5. 两种工作模式AgentOpenCode 内置两个 Agent可以用Tab键切换5.1 plan 模式plan模式偏向“分析和规划”是一个只读Agent。它适合用来阅读和理解项目。分析问题和制定方案。解释代码逻辑。探索不熟悉的代码库。特点默认拒绝编辑文件。运行 bash 命令前会请求许可。更安全适合初学者探索。5.2 build 模式build模式偏向“执行和修改”是一个全权限Agent。它适合用来创建文件。修改代码。运行命令。完成具体开发任务。5.3 模式切换演示在 TUI 中按Tab键切换plan和build模式。课堂演示请为我生成一个 README.md 文件分别在plan和build模式下执行观察 AI 的反馈差异模式预期行为plan分析项目结构给出 README 建议但不创建文件build直接创建 README.md 文件并写入内容6. 常用命令6.1 命令菜单在 OpenCode 中输入/可以打开命令菜单查看所有可用命令。上图输入/后弹出的命令列表包括/agents、/compact、/init、/mcp等常用命令。使用快捷键Ctrl P可以打开命令面板快速切换模型、会话等。上图CtrlP打开的命令面板可以快速搜索命令、切换会话和模型。6.2/init— 初始化项目规则用于初始化项目规则。执行后会生成AGENTS.md这个文件相当于写给 AI 的项目说明书。示例规则本项目生成的代码必须在方法上添加注释。 作者统一写为潜心。以后让 AI 修改代码时它会参考这些规则。6.3/undo和/redo— 撤销与恢复/undo撤销上一次 AI 修改。/redo恢复刚刚撤销的修改。适合在 AI 修改多个文件后快速回滚。6.4/new和/sessions— 会话管理/new创建一个新会话。/sessions查看并切换历史会话。上图会话列表界面显示今天的所有会话支持用快捷键删除ctrld或重命名ctrlr。提示OpenCode 支持多会话可以在同一个项目中并行启动多个 Agent。不同任务建议放在不同会话中避免上下文互相干扰。注意会话不是 Git 版本控制。如果多个会话修改同一个文件仍然需要小心冲突。6.5/models— 切换模型输入/models可以查看和切换可用的 AI 模型。也可以使用快捷键Ctrl P快速选择模型。6.6/mcp— 查看 MCP 状态输入/mcp可以检查已配置的 MCP 服务是否正常启用。6.7 执行 Shell 命令OpenCode 中可以让 AI 执行命令也可以通过命令查看项目状态。例如ls# Linux / macOSdir# Windows6.8 引用文件你可以让 AI 针对某个文件处理问题。示例请阅读 OrderService.java并为其中的方法补充注释。7. 配置模型供应商OpenCode 支持切换不同模型供应商通过opencode.json配置文件管理。7.1 配置文件位置平台路径macOS / Linux~/.config/opencode/opencode.jsonWindowsC:\Users\用户名\.config\opencode\opencode.json项目级项目根目录下的opencode.json7.2 配置文件加载顺序OpenCode 会从多个位置读取配置后面的配置会覆盖前面的配置远程配置全局配置~/.config/opencode/opencode.json自定义配置OPENCODE_CONFIG环境变量项目配置项目中的opencode.json.opencode目录内联配置OPENCODE_CONFIG_CONTENT环境变量配置是合并不是简单替换。7.3 OpenAI 兼容供应商示例很多国产模型服务都提供 OpenAI 兼容接口可以这样配置{$schema:https://opencode.ai/config.json,// 提供商配置定义AI服务提供商的连接信息provider:{// my-provider: 自定义的提供商名称可根据需要修改my-provider:{// npm包名使用兼容OpenAI接口的客户端库npm:ai-sdk/openai-compatible,// 提供商的显示名称仅用于标识name:my-provider,// 提供商的具体配置选项options:{// API服务的基准URL地址baseURL:https://api.example.com/openai,// API密钥从环境变量 MY_API_KEY 中读取避免硬编码apiKey:{env:MY_API_KEY}},// 模型配置定义可用的AI模型models:{// my-model: 自定义的模型名称my-model:{// 模型的实际名称需要提供商支持name:my-model}}}}}安全提示建议把 API Key 放到环境变量里不要直接写在配置文件中。7.4 阿里云百炼配置示例以阿里云百炼为例配置接入国产模型{$schema:https://opencode.ai/config.json,// 提供商配置定义AI服务提供商的连接信息provider:{// bailian: 百炼平台阿里云模型服务的配置bailian:{// npm包名使用Anthropic兼容的客户端库因为百炼兼容Anthropic接口npm:ai-sdk/anthropic,// 提供商的显示名称name:Alibaba Cloud Model Studio,// 提供商的具体配置选项options:{// API服务的基准URL百炼平台的Anthropic兼容接口地址baseURL:https://dashscope.aliyuncs.com/apps/anthropic/v1,// API密钥建议替换为实际密钥或使用环境变量如 {env:BAILIAN_API_KEY}apiKey:YOUR_API_KEY},// 模型配置定义可用的AI模型models:{// qwen3.6-plus: 自定义的模型别名qwen3.6-plus:{// 模型的实际名称通义千问3.6 Plus版本name:Qwen3.6 Plus,// 模型特定的配置选项options:{// thinking: 思考模式配置部分模型支持深度思考thinking:{// type: 思考模式的启用状态enabled启用disabled禁用type:enabled,// budgetTokens: 思考模式的最大token预算8192个token用于思考过程budgetTokens:8192}}}}}}}配置完成后重启 OpenCode输入/models选择模型即可。8. Skills 简介Skill 可以理解为“给 AI 的专项工作说明书”。它本质上是一个固定名称的 Markdown 文件SKILL.md可以告诉 AI遇到某类任务时应该怎么做。使用什么流程。遵守什么规范。产出什么格式。8.1 Skills 搜索路径OpenCode 会自动搜索以下目录.opencode/skills/技能名称/SKILL.md ~/.config/opkills/技能名称/SKILL.md .claude/skills/技能名称/SKILL.md .agents/skills/技能名称/SKILL.md8.2 查看可用 Skills进入 OpenCode 后输入/skills可以查看当前可用的技能列表。9. MCP 简介MCP 的全称是Model Context Protocol模型上下文协议可以理解为 AI 工具的通用扩展协议。它可以让 OpenCode 连接外部服务例如地图服务数据库浏览器文件系统企业内部系统9.1 高德 MCP 示例在opencode.json中添加配置{$schema:https://opencode.ai/config.json,mcp:{amap:{type:remote,url:https://mcp.amap.com/sse?key你的高德Key,enabled:true}}}9.2 验证 MCP进入 OpenCode 后输入/mcp检查 MCP 服务是否启用。9.3 测试 MCP 功能配置完成后可以直接用自然语言提问北京到上海有多远AI 会自动调用高德 MCP 服务获取距离信息。10. 实战案例以下是使用 OpenCode 的一些实际场景截图帮助你直观了解它的能力。10.1 生成网页游戏AI 可以根据自然语言描述直接生成可运行的网页游戏。可以使用前端设计的skills让网页写的更精美第一个就是专门做前端网页设计的skills然后将下面这段提示词直接粘贴到输入框中直接回车即可 游戏规则 游戏在一个4x4或5x5的网格上进行。你需要通过方向键或滑动屏幕控制所有数字方块向同一方向移动。 核心玩法每次移动时相邻且数字相同的方块会合并成一个新方块其数字是两者之和例如2和2合并成44和4合并成8。 随机生成每次移动并合并后会在空白的格子处随机生成一个新的数字通常是1或2或4。 获胜目标游戏的最终目标就是通过不断合并在网格中拼出一个数字为“1024”的方块 1024小程序开发具体请参考项目目录中的rules.md项目说明生成一个基于htmlcssjs的前端页面。11. 实用技巧汇总技巧说明Tab键切换 plan / build 模式Ctrl P快速选择模型/init初始化项目规则文件/undo//redo撤销 / 恢复 AI 修改/new创建新会话/sessions查看历史会话/models查看和切换模型/skills查看可用技能/mcp查看 MCP 服务状态/exit退出程序general调用通用子 Agent 处理复杂搜索
OpenCode
发布时间：2026/5/28 23:37:34
OpenCode1. OpenCode 是什么OpenCode 是一个开源的 AI 编程助手可以在终端、桌面应用和 IDE 插件中使用。它的核心作用是让 AI 直接理解你的项目目录帮你分析代码、修改文件、运行命令、生成项目。常用资源资源链接官网https://opencode.ai/中文文档https://opencode.ai/docs/zh-cnGitHubhttps://github.com/anomalyco/opencode下载页面https://opencode.ai/download关键数据截至 2026 年GitHub Star160,000贡献者900月活开发者7,500,0002. 为什么选择 OpenCodeOpenCode 的主要特点开源工具本身开放可由社区维护和扩展。模型灵活可以连接 OpenAI、Google、DeepSeek、Qwen、Ollama 等不同模型支持 75 LLM 提供商。可定制可以通过配置文件、Agent、Skills、MCP 等方式扩展能力。成本灵活工具免费主要成本来自你选择的模型服务。适合国内开发者可以接入国产模型也可以使用本地模型降低单一平台不可用的风险。隐私优先不存储任何代码或上下文数据适合对隐私敏感的环境。OpenCode vs Claude Code 对比对比项OpenCodeClaude Code开源情况开源闭源商业产品模型选择支持 75 模型供应商主要绑定 Claude定制能力高可配置 Agent、Skills、MCP相对有限使用成本工具免费模型按供应商计费通常需要 Claude 订阅运行方式终端 / 桌面应用 / IDE 插件终端 / 桌面应用 / IDE 插件适合人群想灵活控制工具链的开发者想要 Claude 原生体验的开发者3. 安装 OpenCode官方下载地址https://opencode.ai/download3.1 环境准备安装前确认以下条件条件说明操作系统macOS / Linux / Windows推荐 WSL终端工具WezTerm、Alacritty、Ghostty、Kitty 等现代终端API Key需要配置至少一个 AI 服务商的密钥3.2 Windows 安装方式一NPM 安装需先安装 Node.jsnpm install-g opencode-ai方式二Scoop 安装scoop install opencode方式三Chocolatey 安装choco install opencode推荐Windows 用户建议使用 WSL体验通常更稳定。详见 WSL 安装指南。3.3 Linux 安装# 一键安装推荐curl-fsSLhttps://opencode.ai/install|bashArch Linux 用户sudopacman-Sopencode3.4 macOS 安装# 推荐使用官方 tap更新更快brewinstallanomalyco/tap/opencode# 或使用官方 brew formula更新较慢brewinstallopencode3.5 Docker 运行dockerrun-it--rmghcr.io/anomalyco/opencode3.6 VS Code 插件安装OpenCode 也提供了 VS Code 插件可以在扩展市场中搜索opencode安装。3.7 桌面应用BetaOpenCode 还提供桌面应用支持 macOS、Windows 和 Linux平台下载macOS (Apple Silicon)opencode-desktop-mac-arm64.dmgmacOS (Intel)opencode-desktop-mac-x64.dmgWindowsopencode-desktop-windows-x64.exeLinux.deb / .rpm / .AppImage下载地址https://opencode.ai/download3.8 验证安装在终端执行opencode--version如果输出类似1.14.23的版本号说明安装成功。启动 OpenCodeopencode启动后即可看到 OpenCode 的 TUI 界面在底部输入框中输入问题即可开始对话。4. 打开项目OpenCode 必须在某个项目目录中运行这个目录就是它的工作目录。方式一先切换目录再启动cd你的项目目录 opencode方式二直接指定目录opencode d:/projects/my-app注意进入 OpenCode 后不能像普通终端一样随意切换工作目录。如果要处理另一个项目建议退出后重新在目标目录启动。4.1 项目内搜索文件进入项目后OpenCode 会自动索引项目文件。当你提出需求时AI 会主动搜索相关文件。可以使用符号后面跟上文件名进行搜索文件名5. 两种工作模式AgentOpenCode 内置两个 Agent可以用Tab键切换5.1 plan 模式plan模式偏向“分析和规划”是一个只读Agent。它适合用来阅读和理解项目。分析问题和制定方案。解释代码逻辑。探索不熟悉的代码库。特点默认拒绝编辑文件。运行 bash 命令前会请求许可。更安全适合初学者探索。5.2 build 模式build模式偏向“执行和修改”是一个全权限Agent。它适合用来创建文件。修改代码。运行命令。完成具体开发任务。5.3 模式切换演示在 TUI 中按Tab键切换plan和build模式。课堂演示请为我生成一个 README.md 文件分别在plan和build模式下执行观察 AI 的反馈差异模式预期行为plan分析项目结构给出 README 建议但不创建文件build直接创建 README.md 文件并写入内容6. 常用命令6.1 命令菜单在 OpenCode 中输入/可以打开命令菜单查看所有可用命令。上图输入/后弹出的命令列表包括/agents、/compact、/init、/mcp等常用命令。使用快捷键Ctrl P可以打开命令面板快速切换模型、会话等。上图CtrlP打开的命令面板可以快速搜索命令、切换会话和模型。6.2/init— 初始化项目规则用于初始化项目规则。执行后会生成AGENTS.md这个文件相当于写给 AI 的项目说明书。示例规则本项目生成的代码必须在方法上添加注释。 作者统一写为潜心。以后让 AI 修改代码时它会参考这些规则。6.3/undo和/redo— 撤销与恢复/undo撤销上一次 AI 修改。/redo恢复刚刚撤销的修改。适合在 AI 修改多个文件后快速回滚。6.4/new和/sessions— 会话管理/new创建一个新会话。/sessions查看并切换历史会话。上图会话列表界面显示今天的所有会话支持用快捷键删除ctrld或重命名ctrlr。提示OpenCode 支持多会话可以在同一个项目中并行启动多个 Agent。不同任务建议放在不同会话中避免上下文互相干扰。注意会话不是 Git 版本控制。如果多个会话修改同一个文件仍然需要小心冲突。6.5/models— 切换模型输入/models可以查看和切换可用的 AI 模型。也可以使用快捷键Ctrl P快速选择模型。6.6/mcp— 查看 MCP 状态输入/mcp可以检查已配置的 MCP 服务是否正常启用。6.7 执行 Shell 命令OpenCode 中可以让 AI 执行命令也可以通过命令查看项目状态。例如ls# Linux / macOSdir# Windows6.8 引用文件你可以让 AI 针对某个文件处理问题。示例请阅读 OrderService.java并为其中的方法补充注释。7. 配置模型供应商OpenCode 支持切换不同模型供应商通过opencode.json配置文件管理。7.1 配置文件位置平台路径macOS / Linux~/.config/opencode/opencode.jsonWindowsC:\Users\用户名\.config\opencode\opencode.json项目级项目根目录下的opencode.json7.2 配置文件加载顺序OpenCode 会从多个位置读取配置后面的配置会覆盖前面的配置远程配置全局配置~/.config/opencode/opencode.json自定义配置OPENCODE_CONFIG环境变量项目配置项目中的opencode.json.opencode目录内联配置OPENCODE_CONFIG_CONTENT环境变量配置是合并不是简单替换。7.3 OpenAI 兼容供应商示例很多国产模型服务都提供 OpenAI 兼容接口可以这样配置{$schema:https://opencode.ai/config.json,// 提供商配置定义AI服务提供商的连接信息provider:{// my-provider: 自定义的提供商名称可根据需要修改my-provider:{// npm包名使用兼容OpenAI接口的客户端库npm:ai-sdk/openai-compatible,// 提供商的显示名称仅用于标识name:my-provider,// 提供商的具体配置选项options:{// API服务的基准URL地址baseURL:https://api.example.com/openai,// API密钥从环境变量 MY_API_KEY 中读取避免硬编码apiKey:{env:MY_API_KEY}},// 模型配置定义可用的AI模型models:{// my-model: 自定义的模型名称my-model:{// 模型的实际名称需要提供商支持name:my-model}}}}}安全提示建议把 API Key 放到环境变量里不要直接写在配置文件中。7.4 阿里云百炼配置示例以阿里云百炼为例配置接入国产模型{$schema:https://opencode.ai/config.json,// 提供商配置定义AI服务提供商的连接信息provider:{// bailian: 百炼平台阿里云模型服务的配置bailian:{// npm包名使用Anthropic兼容的客户端库因为百炼兼容Anthropic接口npm:ai-sdk/anthropic,// 提供商的显示名称name:Alibaba Cloud Model Studio,// 提供商的具体配置选项options:{// API服务的基准URL百炼平台的Anthropic兼容接口地址baseURL:https://dashscope.aliyuncs.com/apps/anthropic/v1,// API密钥建议替换为实际密钥或使用环境变量如 {env:BAILIAN_API_KEY}apiKey:YOUR_API_KEY},// 模型配置定义可用的AI模型models:{// qwen3.6-plus: 自定义的模型别名qwen3.6-plus:{// 模型的实际名称通义千问3.6 Plus版本name:Qwen3.6 Plus,// 模型特定的配置选项options:{// thinking: 思考模式配置部分模型支持深度思考thinking:{// type: 思考模式的启用状态enabled启用disabled禁用type:enabled,// budgetTokens: 思考模式的最大token预算8192个token用于思考过程budgetTokens:8192}}}}}}}配置完成后重启 OpenCode输入/models选择模型即可。8. Skills 简介Skill 可以理解为“给 AI 的专项工作说明书”。它本质上是一个固定名称的 Markdown 文件SKILL.md可以告诉 AI遇到某类任务时应该怎么做。使用什么流程。遵守什么规范。产出什么格式。8.1 Skills 搜索路径OpenCode 会自动搜索以下目录.opencode/skills/技能名称/SKILL.md ~/.config/opkills/技能名称/SKILL.md .claude/skills/技能名称/SKILL.md .agents/skills/技能名称/SKILL.md8.2 查看可用 Skills进入 OpenCode 后输入/skills可以查看当前可用的技能列表。9. MCP 简介MCP 的全称是Model Context Protocol模型上下文协议可以理解为 AI 工具的通用扩展协议。它可以让 OpenCode 连接外部服务例如地图服务数据库浏览器文件系统企业内部系统9.1 高德 MCP 示例在opencode.json中添加配置{$schema:https://opencode.ai/config.json,mcp:{amap:{type:remote,url:https://mcp.amap.com/sse?key你的高德Key,enabled:true}}}9.2 验证 MCP进入 OpenCode 后输入/mcp检查 MCP 服务是否启用。9.3 测试 MCP 功能配置完成后可以直接用自然语言提问北京到上海有多远AI 会自动调用高德 MCP 服务获取距离信息。10. 实战案例以下是使用 OpenCode 的一些实际场景截图帮助你直观了解它的能力。10.1 生成网页游戏AI 可以根据自然语言描述直接生成可运行的网页游戏。可以使用前端设计的skills让网页写的更精美第一个就是专门做前端网页设计的skills然后将下面这段提示词直接粘贴到输入框中直接回车即可 游戏规则 游戏在一个4x4或5x5的网格上进行。你需要通过方向键或滑动屏幕控制所有数字方块向同一方向移动。 核心玩法每次移动时相邻且数字相同的方块会合并成一个新方块其数字是两者之和例如2和2合并成44和4合并成8。 随机生成每次移动并合并后会在空白的格子处随机生成一个新的数字通常是1或2或4。 获胜目标游戏的最终目标就是通过不断合并在网格中拼出一个数字为“1024”的方块 1024小程序开发具体请参考项目目录中的rules.md项目说明生成一个基于htmlcssjs的前端页面。11. 实用技巧汇总技巧说明Tab键切换 plan / build 模式Ctrl P快速选择模型/init初始化项目规则文件/undo//redo撤销 / 恢复 AI 修改/new创建新会话/sessions查看历史会话/models查看和切换模型/skills查看可用技能/mcp查看 MCP 服务状态/exit退出程序general调用通用子 Agent 处理复杂搜索
