🔓 开源工具

OpenCode 配置教程

使用 LuckyAPI 中转 —— 开源版 Claude Code，自由选择模型。

什么是 OpenCode？

OpenCode 是一款开源的终端 AI 编程助手，支持任意 OpenAI 兼容 API。简单来说，它是「开源版 Claude Code」，可以自由选择模型，无需绑定特定厂商，完全开放透明。

  • 完全开源，代码可审计
  • 支持任意 OpenAI 兼容 API
  • 自由切换 Claude、GPT、Gemini 等模型
  • 终端 TUI 界面，操作直观
  • 通过 LuckyAPI 接入，成本极低

与 Claude Code 功能对比

功能OpenCodeClaude Code
开源✅ 完全开源❌ 闭源
多模型支持✅ 任意兼容 API⚠️ 主要 Claude
代码理解能力⚠️ 取决于模型✅ 深度优化
终端集成✅✅
多文件编辑✅✅
自定义配置✅ 高度可配⚠️ 有限

一键配置方案

自动检测 Node.js、安装 OpenCode、创建配置目录并生成配置文件：

bash curl -fsSL https://code.claudexai.com/opencode-install.sh | bash

分步配置

  1. 通过 npm 镜像安装 OpenCode

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

  2. 存储 API 凭证

    bash opencode auth login

    按提示输入 LuckyAPI 密钥和 API 地址 https://api.claudexai.com。

  3. 编辑配置文件

    json { "$schema": "https://opencode.ai/config.json", "provider": { "luckyapi": { "api": "https://api.claudexai.com/v1", "name": "LuckyAPI" } }, "model": "luckyapi/claude-sonnet-4-6" }

  4. 启动并验证

    opencode

    成功启动后进入 TUI 界面，即可开始使用。

支持的模型与推荐场景

模型推荐场景
claude-sonnet-4-6日常主力工作，速度与质量均衡
claude-opus-4-6复杂架构设计、大规模重构
gpt-5.4算法调试、数学推理
gemini-3多模态任务、长上下文处理

配置文件位置

操作系统配置路径
macOS / Linux~/.config/opencode/opencode.json
Windows%USERPROFILE%\.config\opencode\opencode.json

故障排除

Provider 无法识别？

确认配置文件中 provider 字段的 key 名称与 model 字段中的前缀一致。例如 provider 定义为 luckyapi，model 应写 luckyapi/模型名。

授权失败 (401)？

重新运行 opencode auth login，确认输入的 API Key 正确无误，并检查 Base URL 末尾不要有多余的斜杠。

模型不可用？

访问 LuckyAPI 控制台 确认你的账户已充值，且所选模型在你的分组权限内。

TUI 界面乱码？

确认终端支持 UTF-8 编码，并设置字体为支持 Nerd Font 或等宽字体（如 JetBrains Mono、Fira Code）。

← 上一篇 Codex CLI