Claude Code 中文站

Appearance

OpenCode 配置教程 ​

OpenCode 是一个开源的终端 AI 编程助手，支持任意 OpenAI 兼容 API。本教程教你通过 LuckyAPI 中转，使用 Claude、GPT、Gemini 等多种模型。

简单说：开源版 Claude Code，自由选模型。

一键配置（推荐） ​

复制以下命令到终端运行，自动完成 安装 + 配置：

bash
curl -fsSL https://claude-zh.cn/scripts/opencode-config.sh | bash

脚本功能

一键配置脚本会自动：

  1. 检测 Node.js 安装状态
  2. 自动安装 OpenCode（通过 npmmirror 镜像加速，国内友好）
  3. 创建配置目录 ~/.config/opencode
  4. 引导输入 LuckyAPI Key
  5. 生成 opencode.json 配置文件，包含 baseURL 和模型列表
  6. 设置文件权限保护 API Key

注意

  • 需要 Node.js 18.0+
  • 脚本会提示输入 LuckyAPI Key，请在 LuckyAPI 获取
  • 默认主力模型：claude-sonnet-4-6

完成后直接 opencode 启动即可。

分步配置 ​

如果你更喜欢手动操作，可以按以下步骤配置。

1. 安装 OpenCode ​

bash
npm install -g opencode-ai --registry=https://registry.npmmirror.com

为什么用镜像

官方 npm registry 在国内经常超时。npmmirror 是原淘宝镜像，速度快很多。如果你不在国内，去掉 --registry=... 即可。

如果 npm 装不上，也可以用官方安装脚本：

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

验证：

bash
opencode --version

2. 注册凭证（可选，推荐） ​

OpenCode 支持把 API Key 存在本地密钥管理器中，避免明文硬编码到配置文件：

bash
opencode auth login
  • 选择类型：列表底部的 other（可直接打字搜索）
  • 定义 ID：输入 luckyapi
  • 录入密钥：粘贴 LuckyAPI Key（sk-xxxx）

获取 LuckyAPI Key

访问 LuckyAPI 控制台，新建令牌，复制以 sk- 开头的字符串。

也可以不用 auth login

直接把 apiKey 写在下一步的 opencode.json 里也行（一键脚本就是这么做的）。

3. 配置第三方 API ​

OpenCode 通过 opencode.json 文件来解析服务商参数。请根据你的操作系统定位并新建/编辑该文件。

配置文件路径 ​

系统路径
macOS / Linux / WSL~/.config/opencode/opencode.json
Windows%USERPROFILE%\.config\opencode\opencode.json

如果目录不存在，先创建：

bash
mkdir -p ~/.config/opencode

配置模板 ​

把以下内容写入 opencode.json：

json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "luckyapi": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "luckyapi",
      "options": {
        "baseURL": "https://cn.luckyapi.chat/v1"
      },
      "models": {
        "claude-sonnet-4-6":   { "name": "claude-sonnet-4-6" },
        "claude-opus-4-6":     { "name": "claude-opus-4-6" },
        "claude-haiku-4-5":    { "name": "claude-haiku-4-5" },
        "gpt-5.4":             { "name": "gpt-5.4" },
        "gpt-5.3-codex-xhigh": { "name": "gpt-5.3-codex-xhigh" },
        "gemini-3-pro-preview":{ "name": "gemini-3-pro-preview" }
      }
    }
  }
}

注意

  • provider.luckyapi 中的 luckyapi 必须和第 2 步 opencode auth login 时输入的 Provider ID 完全一致。
  • baseURL 务必带 /v1 后缀。
  • 模型名以 LuckyAPI 实际支持的为准，可在 LuckyAPI 模型市场 查看最新列表。

4. 启动与验证 ​

配置完成后，重启客户端以加载新的映射关系。

1. 启动主程序：

bash
opencode

2. 在交互栏输入指令调出模型菜单：

/models

3. 若配置无误，你将在列表中看到自定义的 LuckyAPI 平台及其模型。

选择任一模型即可开始使用。

推荐模型 ​

模型推荐场景
claude-sonnet-4-6主力模型，工具调用稳定
claude-opus-4-6复杂重构、架构设计
gpt-5.4算法、调试、推理
gpt-5.3-codex-xhigh大量代码生成
gemini-3-pro-preview长上下文，阅读大型代码库

常见问题 ​

1. Provider not found / 模型菜单看不到 LuckyAPI ​

  • 检查 opencode.json 里 provider 下的 key 和 opencode auth login 时输入的 ID 是否一致
  • 检查 JSON 格式（多/少逗号、尾随逗号）
  • 重启 OpenCode

2. 401 Unauthorized ​

  • Key 输错了：重新运行 opencode auth login 覆盖
  • Key 余额不足或被禁用：到 LuckyAPI 控制台 检查

3. 模型 404 ​

LuckyAPI 模型列表会更新，可能某个模型名变了。在 LuckyAPI 模型市场 查看当前可用模型，更新 opencode.json 中的 models。

4. 和 Claude Code 有什么区别？ ​

维度OpenCodeClaude Code
开源✅ MIT❌ 闭源
Provider任意 OpenAI 兼容仅 Anthropic
多模型并用✅❌
上手难度配置稍多一条命令

需要 Claude Code 教程？看 Claude Code 安装。

相关链接 ​

API 服务由 LuckyAPI 提供

© 2025 Claude Code 中文站