跳到主要内容

OpenCode 使用指南

OpenCode 是一款开源的终端 AI 编程工具，是 Claude Code 的开源替代品。可通过 OPE.AI 使用任意模型。

安装 OpenCode​

macOS / Linux​

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

使用 Go 安装​

go install github.com/opencode-ai/opencode@latest

验证安装​

opencode --version

配置 OPE.AI​

方式一：环境变量配置（推荐）​

在 shell 配置文件中添加以下环境变量：

~/.zshrc 或 ~/.bashrc
export OPENAI_API_KEY=<您的 OPE.AI API Key>
export OPENAI_BASE_URL=https://api.ope.ai/v1

配置后重新加载配置文件：

source ~/.zshrc  # 或 source ~/.bashrc

方式二：配置文件​

创建或编辑 OpenCode 配置文件：

~/.config/opencode/config.toml
[providers.aitk]
api_key = "<您的 OPE.AI API Key>"
base_url = "https://api.ope.ai/v1"

[models.default]
provider = "aitk"
model = "Claude-4.6-Sonnet"

验证配置​

运行以下命令测试配置：

opencode "你好，请介绍一下你自己"

如果配置正确，OpenCode 会使用配置的模型回复。

推荐模型​

应用场景推荐模型特性说明
日常编程Claude-4.6-Sonnet综合能力强，性价比高
复杂任务Claude-4.6-Opus顶级推理能力，适合架构设计
快速响应Claude-4.5-Haiku极速响应，成本低
超长上下文GPT-5.4-Pro1M 上下文，适合大型项目
成本优化DeepSeek-V3.2极低成本，高频使用首选

完整模型列表请查看 模型价格说明。

常用命令​

代码生成​

opencode "用 Python 写一个快速排序算法"

代码解释​

opencode "解释这段代码" < script.py

代码重构​

opencode "将这个函数重构为 TypeScript" < function.js

Bug 修复​

opencode "修复这个文件中的 bug" < buggy_code.py

交互模式​

opencode chat

高级配置​

切换模型​

在配置文件中修改默认模型：

~/.config/opencode/config.toml
[models.default]
provider = "aitk"
model = "Claude-4.6-Opus"  # 切换到更强大的模型

或通过命令行参数指定：

opencode --model Claude-4.5-Haiku "快速问答"

自定义温度参数​

~/.config/opencode/config.toml
[models.default]
provider = "aitk"
model = "Claude-4.6-Sonnet"
temperature = 0.7
max_tokens = 4096

常见问题​

提示 API Key 无效​

  • 确认 API Key 格式正确（以 sk- 开头）
  • 检查环境变量是否正确设置：echo $OPENAI_API_KEY
  • 确认配置文件路径正确：~/.config/opencode/config.toml
  • 登录 OPE.AI 控制台 确认 Key 有效

提示模型不存在​

  • 确认模型名称拼写正确（注意大小写，如 Claude-4.6-Sonnet）
  • 检查 base_url 配置是否正确：https://api.ope.ai/v1
  • 参考上方推荐模型表格使用正确的模型 ID

响应速度慢​

  • 尝试切换到更快的模型（如 Claude-4.5-Haiku）
  • 检查网络连接，确认能访问 https://api.ope.ai
  • 减小 max_tokens 参数限制输出长度

command not found​

  • 确认 OpenCode 安装成功：which opencode
  • 如使用 Go 安装，确认 $GOPATH/bin 在 $PATH 中
  • 尝试重新安装：go install github.com/opencode-ai/opencode@latest
信息

OpenCode 的具体配置方法可能随版本更新而变化，详细信息请参考 OpenCode 官方文档。