OpenCode + OpenCode Zen 安装配置指南：开源AI编程工具实践

字数：约3500字 | 阅读时间：10分钟
“不绑定任何一家模型厂商，才是程序员该有的自由。”

为什么选 OpenCode？

在AI编程工具爆发的2026年，OpenCode是目前最成熟、社区最活跃的开源方案。

几个核心优势：

不锁定模型厂商。 OpenCode 支持 75+ 模型——OpenAI、Google Gemini、智谱 GLM、通义千问、Ollama 本地模型，随便切换。这意味着你可以根据任务类型选最合适的模型，而不是被一家厂商绑架。

完全开源，可审计。 代码托管在 GitHub（anomalyco/opencode），145K+ stars。你的代码和上下文数据不会被发送到第三方服务器存储，对隐私敏感的企业环境很友好。

TUI 界面体验好。 OpenCode 提供终端 TUI 界面，也支持桌面客户端和 IDE 插件。日常在终端里直接用，交互体验流畅。

免费使用。 OpenCode 本身免费，你只需要付模型 API 的费用。相比闭源订阅制，成本更可控。

一句话总结：如果你在国内开发、需要灵活切换模型、或者重视开源透明，OpenCode 是目前最好的选择。

安装

前置条件

不管用哪种安装方式，你需要：

  • 操作系统：macOS、Linux、Windows（推荐 WSL）
  • 终端：支持真彩色和 Unicode 的现代终端（iTerm2、WezTerm、Alacritty、Ghostty、Kitty 都行，macOS 自带的 Terminal.app 渲染效果一般）
  • API Key：至少一个 LLM 提供商的 Key（后面细说）

方式一：安装脚本（最快）

1
curl -fsSL https://opencode.ai/install | bash

一行搞定，自动检测系统架构，下载对应二进制文件。macOS 和 Linux 通用。

验证安装：

1
opencode --version

方式二：包管理器

macOS 用户可以用 Homebrew：

1
brew install opencodeai/opencode/opencode

Linux 用户可以用 apt：

1
2
echo 'deb [trusted=yes] https://apt.opencode.ai /' | sudo tee /etc/apt/sources.list.d/opencode.list
sudo apt update && sudo apt install opencode

方式三：源码编译

如果你想要最新功能，或者在 ARM 架构上运行：

1
2
3
4
git clone https://github.com/anomalyco/opencode.git
cd opencode
cargo build --release
./target/release/opencode

配置

模型选择

OpenCode 的核心优势是灵活切换模型。第一次启动会引导你配置：

1
2
opencode config set openai.api_key sk-xxxx
opencode config set openai.model gpt-4-turbo

或者用国内模型：

1
2
3
4
5
6
7
# 智谱 GLM
opencode config set zhipu.api_key $ZHIPU_API_KEY
opencode config set zhipu.model glm-4

# 通义千问
opencode config set qwen.api_key $DASHSCOPE_API_KEY
opencode config set qwen.model qwen-turbo

多模型配置

如果你想同时用多个模型，可以在 ~/.config/opencode/models.yaml 里配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
models:
  - name: gpt-4-turbo
    provider: openai
    api_key: ${OPENAI_API_KEY}
    default: true
  
  - name: glm-4
    provider: zhipu
    api_key: ${ZHIPU_API_KEY}
  
  - name: qwen-turbo
    provider: qwen
    api_key: ${DASHSCOPE_API_KEY}

然后在 OpenCode 里用 /model <name> 切换。

OpenCode Zen（界面增强）

OpenCode Zen 是可选的桌面客户端，提供更丰富的界面：

1
2
3
4
# macOS
brew install opencodeai/opencode/opencode-zen

# 或从官网下载：https://opencode.ai/zen

Zen 提供：

  • 可视化项目管理
  • 代码历史和差异对比
  • 内置终端和文件浏览器
  • 模型切换面板

快速开始

基本操作

启动 OpenCode：

1
opencode

你会看到一个终端 TUI 界面。常用命令：

命令 说明
/new 创建新对话
/model <name> 切换模型
/context 查看当前上下文
/history 查看历史会话
/export 导出对话记录

项目理解功能

OpenCode 最实用的功能是”项目理解”：

1
2
3
4
5
6
# 在项目根目录启动
cd /path/to/your/project
opencode

# 然后问它
What is the structure of this project?

它会扫描项目结构，给出：

  • 目录树
  • 核心模块
  • 依赖关系
  • 关键文件

这个功能对 Spring Boot 项目特别友好。

代码补全和生成

基本补全：

直接在文件里输入，OpenCode 会自动弹出补全建议。按 Tab 接受，Esc 拒绝。

代码生成：

1
/generate 生成一个用户登录的 REST API

OpenCode 会：

  1. 分析你的项目结构
  2. 生成符合项目风格的代码
  3. 放在当前光标位置

多轮对话改进

OpenCode 支持追问，这是它比简单补全更强大的地方：

1
2
> 这个接口的异常处理不太对
> 请改用全局异常处理器

上下文会保留，不需要重复说明项目背景。

进阶用法

自定义 Commands

你可以定义自己的命令模板。在 ~/.config/opencode/commands/ 下创建：

1
2
3
4
5
6
7
8
9
10
# ~/.config/opencode/commands/spring-rest.yaml
name: spring-rest
description: 生成符合项目规范的 Spring REST 接口
template: |
  请为 {{entity}} 生成一个完整的 REST API，包括：
  - Controller（带 @RestController 和 @RequestMapping）
  - Service（带事务注解）
  - Repository（如果有数据库操作）
  - 请求/响应 DTO
  - 使用当前项目的包结构和命名规范

然后在 OpenCode 里用 /spring-rest User 调用。

Git Hook 集成

你可以把 OpenCode 集成到 Git Hook 里，实现自动化代码审查：

1
2
3
# .git/hooks/pre-commit
#!/bin/bash
opencode review --file $1

每次提交前自动检查代码质量。

连接远程模型

如果你有 Ollama 在远程服务器上运行：

1
2
opencode config set ollama.url http://192.168.1.100:11434
opencode config set ollama.model llama3

局域网内的模型也能用，延迟更低。

常见问题

Q: 怎么不让代码发送到第三方？

A: 用本地模型（Ollama）或私有化部署。云服务版本默认不保存上下文，但如果你很在意，可以完全离线运行：

1
opencode --offline

Q: 响应速度慢怎么办？

A: 几个优化方向：

  1. 用本地模型（Ollama + Qwen2.5）延迟最低
  2. 选择近期的服务器（如果用云服务）
  3. 减少上下文量（不要把整个代码库都扔进去）

Q: 怎么切换模型？

A: 在对话里用 /model <name>，或者在 Zen 客户端的模型面板里点选。

Q: 中文支持怎么样？

A: OpenCode 对中文支持很好。智谱 GLM、通义千问都是国产模型，中文理解能力强。用国内模型，速度和中文效果都更优。

总结

OpenCode 是2026年最值得尝试的开源AI编程工具：

维度 评价
模型灵活性 ⭐⭐⭐⭐⭐ 支持75+模型
开源透明 ⭐⭐⭐⭐⭐ 完全开源可审计
中文支持 ⭐⭐⭐⭐⭐ 国产模型优化
安装体验 ⭐⭐⭐⭐ 脚本安装很方便
界面体验 ⭐⭐⭐⭐ Zen客户端可选

如果你还在用闭源工具，不妨试试 OpenCode——灵活、透明、免费。

有问题或经验想分享？欢迎在评论区聊聊。