OpenCode 使用指北

OpenCode 是一款旨在将高级 AI 编辑器功能带入终端的开源工具，支持代码分析、自动计划和文件改写。

• 官方网站
• GitHub 仓库

DeepSeek vs Ollama vs OpenCode

维度	DeepSeek	Ollama	opencode
本质	大语言模型 (LLM)	本地模型管理与运行框架	AI 编程智能体 (Agent)
角色	提供思考和生成能力的“源头”	负责把模型安装并跑在你的硬件上	调用模型来帮你完成具体的编程任务
功能	理解语义、编写代码、逻辑推理	下载模型、提供 API 接口、管理显存	自动修改项目文件、修复 Bug、运行代码
类比	一本书里的知识	一个书架或阅读器	一个会查书并帮你代写论文的学生

1. 安装

• 通用安装方式

npm install -g opencode-ai

2. 配置

OpenCode 的配置主要通过 opencode.json 文件完成，它决定了使用的 AI 模型、API 密钥以及行为偏好。

1. 全局配置

• Linux/macOS： ~/.config/opencode/opencode.json
• Windows：%USERPROFILE%\.config\opencode\opencode.json

2. 项目级配置: 位于项目根目录下的 opencode.json

• 项目级配置会覆盖全局配置

2.1 opencode.json 配置文件示例

{
	"$schema": "https://opencode.ai/config.json",
	"permission": {
		"*": "allow"
	},
	"provider": {
		"myProvider": {
			"npm": "@ai-sdk/openai-compatible",
			"id": "myProvider",
			"name": "myProvider",
			"options": {
				"baseURL": "https://xxx/v1",
				"apiKey": "sk-xxx"
			},
			"models": {
				"MyModel": {
					"name": "MyModel-1.0",
					"limit": {
						"context": 65000,
						"output": 10000
					}
				}
			}
		}
	},
	"model": "myProvider/MyModel"
}

3. 运行

在终端中进入你的代码项目目录，直接输入：

# 启动交互模式
# 进入 TUI（终端用户界面）后，你可以像使用 ChatBox 一样直接描述你的编程任务。
opencode

#非交互式运行:直接在命令行中快速执行任务：
opencode run "重构当前目录下的 index.js 文件，提取冗余函数"

# 启动带有 Web 交互界面的本地服务
opencode web

3.1 常用命令

命令	说明
/init	在当前目录初始化项目上下文（生成 AGENTS.md）
/connect	快速配置 AI 提供商和 API Key
/model [name]	临时切换当前使用的模型
/undo	撤销上一步 AI 对文件所做的修改
/redo	重新执行被撤销的修改
@filename	在对话中手动提及某个文件作为背景资料
exit	退出 OpenCode