OpenCode 简介
什么是OpenCode？
OpenCode是一个功能强大的开源AI编程助手，专为终端环境打造。它是Claude Code的免费开源替代方案，提供完整的TUI（终端用户界面）体验，支持75+个AI提供商。
OpenCode基于Go语言开发，具有出色的性能和跨平台兼容性。它不仅仅是一个简单的命令行工具，而是一个完整的AI编程生态系统，集成了代码生成、调试、重构、文档编写等多种功能。
为什么选择OpenCode？
原生终端体验
基于Bubble Tea框架构建的流畅TUI界面，完全适配终端环境，提供类似现代GUI的交互体验。
多AI提供商支持
支持75+个AI提供商，包括OpenAI、Anthropic Claude、Google Gemini、AWS Bedrock、Groq等主流平台。
智能会话管理
基于SQLite的持久化存储，支持保存和管理多个对话会话，轻松切换不同项目上下文。
强大工具集成
AI可以执行命令、搜索文件、修改代码，集成Vim风格编辑器和LSP语言服务器支持。
团队协作分享
生成唯一URL分享会话记录，支持团队协作和知识共享，提高开发效率。
智能代码分析
通过LSP集成提供语义级代码理解，支持多种编程语言的智能补全和重构。
安装与部署
系统要求
• Go ≥ 1.24（开发环境）
• Node.js ≥ 最新版本（工具链支持）
• 4GB+ RAM
• 现代终端模拟器
• SQLite支持
快速安装
方法1：一键安装脚本（推荐）
支持Linux和macOS系统的自动安装脚本：
# 安装最新版本
curl -fsSL https://opencode.ai/install | bash
# 安装指定版本
curl -fsSL https://opencode.ai/install | VERSION=0.1.0 bash
方法2：包管理器安装
使用各平台的包管理器进行安装：
# macOS - Homebrew
brew install sst/tap/opencode
# 通用 - npm/yarn/pnpm
npm i -g opencode-ai@latest
yarn global add opencode-ai@latest
pnpm add -g opencode-ai@latest
# Arch Linux
paru -S opencode-bin
方法3：手动二进制安装
从GitHub Releases下载预编译二进制文件：
# Linux x64
curl -L https://github.com/opencode-ai/opencode/releases/latest/download/opencode-linux-amd64 -o opencode
chmod +x opencode
sudo mv opencode /usr/local/bin/
# 验证安装
opencode --version
Windows安装说明
Windows特殊处理
目前Windows的自动安装脚本存在问题，建议：
• 从 GitHub Releases 下载Windows二进制文件
• 或使用WSL（Windows Subsystem for Linux）环境
OpenAI API 配置
多提供商支持
OpenCode支持75+个AI提供商，本教程以OpenAI为例。您也可以选择Anthropic Claude、Google Gemini等其他提供商。
获取OpenAI API密钥
创建OpenAI账户
访问 OpenAI Platform 创建账户。注意：ChatGPT Plus订阅与API账户是分开计费的。
设置预付费账单
在OpenAI控制台设置预付费账单。API采用按使用量计费模式，比月订阅更灵活经济。
成本控制建议
建议设置消费限制以控制成本，可在账单设置中配置每月支出上限。
生成API密钥
在API Keys页面生成新的密钥：
- 访问 API Keys页面
- 点击"Create new secret key"
- 设置权限为"All"（推荐）
- 为密钥命名（如"OpenCode-API"）
- 复制并安全保存密钥
安全提醒
API密钥只显示一次，请妥善保存。遗失后需重新生成。
OpenCode身份验证配置
交互式认证（推荐）
使用OpenCode的内置认证向导：
# 启动认证流程
opencode auth login
按照TUI界面提示：
- 选择AI提供商（选择OpenAI）
- 输入API密钥
- 确认配置
环境变量配置
OpenCode会自动检测常用环境变量：
# 在 ~/.bashrc 或 ~/.zshrc 中添加
export OPENAI_API_KEY="your-api-key-here"
# 或创建项目级 .env 文件
echo "OPENAI_API_KEY=your-api-key-here" > .env
2025年OpenAI定价参考
| 模型 | 输入价格（每1K tokens） | 输出价格（每1K tokens） | 上下文长度 | 特点 |
|---|---|---|---|---|
| GPT-4o | $0.0025 | $0.01 | 128k | 平衡性能和成本 |
| GPT-4o-mini | $0.00015 | $0.0006 | 16k | 最经济选择 |
| GPT-4 | $0.03 | $0.06 | 32k | 最高性能 |
| GPT-3.5-Turbo | $0.0005 | $0.0015 | 16k | 轻量任务 |
基础使用教程
首次启动
启动OpenCode
# 在当前目录启动
opencode
# 指定项目目录启动
opencode -c /path/to/your/project
# 启用调试日志
opencode -d
项目初始化
首次在项目中使用OpenCode时，建议初始化项目：
# 在OpenCode中执行
/init
这将分析项目结构并创建 AGENTS.md 文件，建议提交到Git。
选择AI模型
在OpenCode界面中选择合适的模型：
# 列出可用模型
/models
# 切换到GPT-4o-mini（经济型）
/model gpt-4o-mini
# 切换到GPT-4o（平衡型）
/model gpt-4o
快速上手
现在您可以开始与OpenCode对话了！试试问它："请介绍一下你的功能"或者"生成一个Python快速排序函数"。
常用命令详解
交互模式命令
会话管理命令
# 保存当前会话
/save session-name
# 加载历史会话
/load session-name
# 列出所有会话
/sessions
# 清除当前对话
/clear
模型和提供商管理
# 列出可用模型
/models
# 切换模型
/model gpt-4o-mini
# 查看当前配置
/config
# 设置系统提示
/system "你是一个专业的Python开发助手"
文件操作命令
# 文件搜索（按@键触发）
@filename
# 读取文件内容
请分析 @src/main.py 这个文件
# 创建新文件
创建一个名为utils.py的工具文件，包含常用的字符串处理函数
非交互模式命令
# 获取JSON格式响应
opencode -p "生成一个Python快速排序实现" -f json
# 静默模式（适用于脚本）
opencode -p "检查这段代码是否有bug" -q
# 管道输入
cat buggy-code.js | opencode -p "修复这段代码中的错误"
高级功能
LSP集成
OpenCode自动集成语言服务器协议，提供智能代码分析：
语义理解
自动识别项目语言和框架，启动相应LSP服务器，提供语义级代码理解。
项目结构分析
智能分析代码库结构，理解模块间依赖关系和架构模式。
会话分享
OpenCode支持生成可分享的会话链接：
# 生成分享链接
/share
# 设置分享权限
/share --public # 公开访问
/share --team # 团队访问
常见问题解决
安装问题
命令未找到
问题症状
bash: opencode: command not found
解决方案：
# 检查安装路径
which opencode
# 手动添加到PATH
echo 'export PATH="/usr/local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
API配置问题
# 检查认证状态
opencode auth list
# 重新登录
opencode auth logout
opencode auth login
最佳实践
高效使用技巧
精确描述问题
提供具体的上下文、错误信息和期望结果，避免模糊描述。
分步骤处理
将复杂任务分解为小步骤，逐步完成，便于调试和验证。
版本控制集成
在进行大型重构前创建Git分支，便于回滚和对比变更。
会话管理
为不同项目和任务创建专门的会话，保持上下文清晰。
恭喜完成学习！
您已经掌握了OpenCode的完整使用方法。现在可以开始用它来提高编程效率了！记住：OpenCode是强大的助手工具，最重要的仍然是您的编程思维和解决问题的能力。