OpenCode 开源AI编程代理 · 桌面版完整指南

OpenCode 开源AI编程代理

桌面版完整指南 · 开源免费 · 支持任意模型
v1.17.14 · GitHub 183,000+ ⭐ · 750万+ 月活开发者

📥 立即下载 Windows 桌面版

下载 opencode-windows-x64.zip

SHA256: 7de99b25d32b5225a3dba667ce442fdebbc397f618b64902d888b10f7a0aa338 · 57.3MB · 2026-07-06

📌 OpenCode 是什么?

OpenCodeanomalyco 团队开发的开源AI编码代理,MIT 协议免费使用。它像一个超级编程助手,能在终端、桌面应用或 IDE 中帮助你写代码、改代码、分析和探索项目代码库。

与 Claude Code、Cursor、Codex 类似,但完全开源、支持任意 LLM 模型(包括本地模型),被全球 750万+ 开发者 每月使用。

🎯 核心功能一览

🤖

双模式代理

Build 模式(开发)+ Plan 模式(只读分析),Tab 键一键切换

🖥️

三种界面

终端 TUI + 桌面应用 + IDE 扩展,多端可用

🔌

75+ 模型支持

Claude、GPT、Gemini、DeepSeek、本地模型等

📎

LSP 智能感知

自动加载 LSP,代码理解精准

📂

多会话并行

同时运行多个代理处理不同任务

🔗

会话分享

一键生成链接分享给团队协作

🛠️

子代理系统

@general 调用子代理执行复杂搜索和任务

🔄

/undo 撤销

多级撤销/重做,改错了随时回退

📥 安装方式汇总

平台 命令 / 方式
Windows 桌面版 下载 ZIP 包,解压运行 opencode-desktop-windows-x64.exe
Windows (Scoop) scoop install opencode
Windows (Chocolatey) choco install opencode
macOS (Homebrew) brew install anomalyco/tap/opencode
macOS 桌面版 下载 opencode-desktop-mac-x64.dmg
Linux 桌面版 下载 .deb / .rpm / .AppImage
npm (全平台) npm install -g opencode-ai
Arch Linux sudo pacman -S opencode
Docker docker run -it --rm ghcr.io/anomalyco/opencode
一键脚本 curl -fsSL https://opencode.ai/install | bash

🚀 快速开始(三步)

配置模型

执行 /connect,选择 OpenCode Zen(推荐,免费模型)或连接自己的 API Key(Claude/GPT/DeepSeek 等)。

进入项目并初始化

执行 cd /path/to/your/project && opencode,然后在 OpenCode 中执行 /init

开始对话

问问题:@src/main.rs 里的错误处理逻辑是什么?
改代码:给 /settings 路由加上认证,参考 @auth.ts 的实现
先规划: → 满意后 Tab 切回 Build 模式执行 → 不满意 /undo 撤销

🎛️ 代理模式详解

Build 🛠️

默认模式
完整读写权限,可修改文件、执行命令、安装依赖

Plan 📋

Tab 切换
只读分析,做计划不改代码,执行命令前会询问确认

子代理 🧬

@general 调用
复杂多步骤任务自动派生子代理并行处理

⚙️ 高级自定义

🎨

主题

内置多套主题,可自定义配色

⌨️

快捷键

自定义所有键盘绑定

📐

格式化

配置代码自动格式化规则

🔧

自定义命令

创建自己的 /command 快捷指令

🔌

MCP 服务

连接外部 MCP 工具扩展能力

🛡️

权限策略

精细控制代理的文件和命令权限

📦

Agent Skills

编写自定义技能扩展代理功能

🔗

Git 集成

与 GitLab/GitHub 深度集成

💡 使用技巧

  • 拖拽图片到终端 — OpenCode 能读取图片内容作为参考
  • @ 文件搜索 — 提示词中用 @+文件名 可模糊搜索项目文件
  • 多级 /undo — 支持多次撤销回到任意历史版本
  • 先 Plan 再 Build — 复杂改动先用 Plan 确认方向
  • AGENTS.md 提交 Git — 让下次打开时 OpenCode 知道项目规则
  • 桌面版支持多标签页 — 可同时处理多个项目
  • 会话分享 — /share 一键生成链接给同事

🔗 相关链接

发表评论