跳转到主要内容

​
概述

类型: 编码工具主要路径: OpenAI-compatible支持级别: 支持路径
OpenCode 是一个在终端中运行的开源 AI 编码助手。它支持多个 LLM 提供方，并且可以配置为使用 LemonData 的 API，以访问 300+ 模型。

​
安装

curl -fsSL https://opencode.ai/install | bash
验证安装： 
opencode --version

​
配置

​
第 1 步：设置环境变量

export OPENAI_API_KEY="sk-your-lemondata-key"
如需永久配置，请添加到 ~/.bashrc 或 ~/.zshrc： 
echo 'export OPENAI_API_KEY="sk-your-lemondata-key"' >> ~/.zshrc
source ~/.zshrc

​
第 2 步：配置 OpenCode

OpenCode 当前文档建议通过 opencode.json 或 opencode.jsonc 配置提供方。对于 LemonData，请使用自定义提供方，而不是复用内置的 openai 提供方： 
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "lemondata": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "LemonData",
      "options": {
        "baseURL": "https://api.lemondata.cc/v1",
        "apiKey": "{env:OPENAI_API_KEY}"
      },
      "models": {
        "gpt-5.4": {
          "name": "GPT-5.4"
        },
        "gpt-5-mini": {
          "name": "GPT-5 Mini"
        }
      }
    }
  },
  "model": "lemondata/gpt-5.4"
}
使用 @ai-sdk/openai-compatible 以获得 chat-completions 风格的兼容性。如果你明确需要基于 /v1/responses 构建的提供方路径，OpenCode 文档建议将 package 切换为 @ai-sdk/openai。

​
基本用法

启动交互模式： 
opencode
使用 prompt 运行： 
opencode "Explain this codebase"
指定模型： 
opencode --model lemondata/gpt-5.4 "Fix the bugs in main.py"

​
可用模型

模型最适合
gpt-5.4复杂任务、代码架构
gpt-5-mini快速修复、简单查询
claude-sonnet-4-6代码审查、文档编写
claude-opus-4-6复杂推理
gemini-2.5-flash快速响应
deepseek-r1算法设计

​
常用命令

分析代码： 
opencode "What does this function do?" < src/utils.ts
生成代码： 
opencode "Create a REST API with Express"
审查变更： 
git diff | opencode "Review these changes"
修复错误： 
opencode "Fix the TypeScript errors in this project"

​
交互命令

Command描述
/help显示可用命令
/model <name>切换到其他模型
/clear清除对话历史
/exit退出 OpenCode

​
故障排查

  • 验证 options.baseURL 是否设置为 https://api.lemondata.cc/v1
  • 检查网络连接
  • 尝试使用 curl https://api.lemondata.cc/v1/models 进行测试
  • 验证是否已设置 OPENAI_API_KEY 环境变量
  • 验证 options.apiKey 是否引用了 {env:OPENAI_API_KEY} 或其他有效的 secret 来源
  • 检查 key 是否以 sk- 开头
  • 确保该 key 在 LemonData 控制台中处于激活状态

​
最佳实践

从项目根目录运行 OpenCode，以便更好地理解你的代码库。
对简单任务使用更快的模型（gpt-5-mini），对复杂任务使用更强的模型（gpt-5.4、claude-sonnet-4-6）。
在将 AI 生成的代码应用到项目之前，务必先进行审查。