OpenCode：你的开源 AI 编程助手完全教程

你可能正面临的痛点

• 手动查找代码片段耗时导致开发效率低下。
• 不同项目的环境配置繁琐，常常出现依赖冲突。
• 使用商业 AI 助手时担心代码泄露和隐私风险。
• 在 IDE 与终端之间切换，缺乏统一的 AI 辅助体验。
• 需要频繁在多个模型之间切换，却找不到统一入口。

OpenCode 是一个开源的 AI 编程助手，能够在终端、桌面应用或 IDE 中直接为你生成、修改和解释代码。不过，项目已在 GitHub 获得数千星标，拥有上百名贡献者。每月有超过 65 万 开发者使用。怎么说呢，

主要特性

• 🚀 开箱即用：内置免费模型。也可无缝连接 Claude、GPT、Gemini 等任意提供商。
• 💻 多网站支持：终端 TUI、桌面客户端还有 VS Code、Cursor 等 IDE 均可使用，同一套指令跨环境统一。
• 🔀 LSP 支持：自动为大语言模型加载合适的语言服务器，实现智能补全与错误检查。
• 👥 多会话协作：同一项目可并行启动多个代理，团队成员可以分别处理不同子任务。
• 🔗 分享功能：一键生成会话链接，便于调试或知识沉淀。
• 🔒 隐私优先：所有代码和上下文仅保存在本地，不会上传至 OpenCode 服务器。

二、快速开始

1️⃣ 安装 OpenCode

a）一键安装脚本

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

b）使用包管理器

• Node.js / npm / Yarn / Bun：

npm install -g opencode-ai
# 或者
yarn global add opencode-ai
# Bun
bun install -g opencode-ai

• macOS / Linux – Homebrew：

brew install anomalyco/tap/opencode

• Windows – Chocolatey：

choco install opencode

• Windows – Scoop：

scoop bucket add extras
scoop install extras/opencode

• Arch Linux – Paru：

paru -S opencode-bin

2️⃣ 配置 AI 模型提供商

首次使用需绑定一个模型提供商。新手推荐使用 OpenCode Zen——官方精选的高性价比模型集合：

1. 运行 /connect
2. 选择 opencode
opencode.ai/auth 登录并获取 API Key。

If you prefer or providers,simply run:

/connect
# 选择对应的提供商并输入对应的 API Key 即可。怎么说呢，

3️⃣ 初始化项目

cd /path/to/your/project
opencode # 启动交互式界面
/init # 自动生成 AGENTS.md。帮助 OpenCode 了解项目结构

三、基础使用——尽快处理“手动查找代码慢”问题

❓ 常见交互方式

• # 提问与请求： 
•  自动把文件内容注入对话。
• # 运行 Shell 命令：   把命令输出作为工具结果返回。

⌨️ Slash 命令速查表