【OpenCode 下载并接入 Claude API】

IiEomH

1404人浏览 · 2026-04-14 18:44:47

IiEomH · 2026-04-14 18:44:47 发布

OpenCode 下载并接入第三方 API：开源的终端 AI 编程助手

摘要

OpenCode 是 2026 年最火的开源 AI 编程工具之一，GitHub 星标超过 14 万。它不绑定任何厂商，支持接入 Claude、GPT、Gemini 等主流大模型，且完全免费开源。本文以 Windows 环境为主，手把手教你下载安装 OpenCode，并接入第三方 Claude API 中转服务，零成本获得强大的终端 AI 编程能力。

前言

如果你想在终端中用上 AI 编程助手，但又不想被某个平台绑定、不想花钱订阅——OpenCode 是目前最佳选择之一。

OpenCode 是一款开源的终端 AI 编程代理，由社区驱动开发，不绑定任何模型厂商。它支持 Claude、GPT、Gemini、DeepSeek 等 75+ 模型提供商，你可以自由选择用哪家的 API 来驱动它。

本文将带你完成三件事：

下载安装 OpenCode
接入你自己的 Claude API（通过第三方中转服务,本文采用ClaudeAPI平台）
验证配置并开始使用

全程命令行操作，10 分钟搞定。

第一章：OpenCode 是什么？

1.1 产品定位

OpenCode 是一款开源的终端 AI 编程代理（AI Coding Agent），基于 Go 语言构建，提供精美的 TUI（终端用户界面）。它不是某个厂商的专属工具，而是一个模型无关的开放平台——你可以接入任何 AI 模型来驱动它。

1.2 核心能力

能力	说明
智能代码生成	通过自然语言描述生成代码，支持所有主流编程语言
双代理模式	Build 代理（可读写文件、执行命令）+ Plan 代理（只读分析，不做修改）
多模型支持	不绑定厂商，支持 Claude、GPT、Gemini、DeepSeek 等 75+ 提供商
LSP 集成	自动加载语言服务协议，终端中也有 IDE 级别的代码补全和诊断
多会话管理	可同时运行多个代理会话，互不干扰
GitHub 集成	在 Issue/PR 中 @opencode 即可触发 AI 处理

1.3 为什么选择 OpenCode？

完全免费开源：无订阅费、无使用限制，代码透明可审计
不绑定厂商：今天用 Claude，明天可以切 GPT，后天换 DeepSeek，一行配置搞定
隐私友好：所有数据留在本地，不经过第三方服务器（除了你主动调用的 API）
社区活跃：GitHub 14 万+ 星标，850+ 贡献者，更新迭代极快

第二章：下载安装 OpenCode

2.1 系统要求

Windows 10+ / macOS 12+ / Linux
建议使用 Git Bash 或 WSL 作为终端（Windows 原生 CMD 兼容性有限）

2.2 安装方式（Windows）

OpenCode 提供多种安装方式，选择最适合你的一种即可：

方式一：通过 npm 安装（需要 Node.js v18+）

npm install -g opencode-ai

方式二：通过 Scoop 安装

scoop bucket add extras
scoop install extras/opencode

方式三：通过 Chocolatey 安装

choco install opencode

方式四：一键脚本安装（Git Bash / WSL）

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

2.3 验证安装

安装完成后，打开终端执行：

opencode --version

如果输出版本号，说明安装成功。

⚠️ 如果提示 'opencode' 不是内部或外部命令：

npm 安装的用户：检查 npm config get prefix 路径是否在系统 PATH 中

Scoop 安装的用户：重新打开终端即可

第三章：获取 Claude API Key

OpenCode 本身只是一个"外壳"，需要接入大模型 API 才能工作。接下来我们获取 Claude API 的访问凭证。

3.1 为什么用第三方中转服务？

Anthropic 官方 API 在国内存在访问限制，且注册门槛较高。第三方中转服务提供兼容的 API 端点，国内可直连，注册即用。

3.2 获取 API Key 和 Base URL

本文以 ClaudeAPI 为例进行演示，其他同类平台操作基本一致

访问 http://claudeapi.com 注册并登录
进入主页，找到「API Keys」或「令牌管理」
点击「创建新密钥」，备注名称（如 opencode-dev）
复制 API Key（格式为 sk-xxxxxxxx）
在文档或设置页找到 Base URL（本平台的推荐URL为 https://hk.claudeapi.com）

需要记录的两项信息：

配置项	示例值	用途
Base URL	`https://hk.claudeapi.com`	API 服务端点地址
API Key	`sk-xxxxxxxxxxxxxxxx`	身份验证密钥

⚠️ API Key 等同于账户密码，切勿分享或提交至公开仓库。

第四章：配置 OpenCode 接入 Claude API（核心步骤）

OpenCode 支持两种配置方式：配置文件和交互式命令。推荐使用配置文件，更清晰可控。

4.1 方式一：编辑配置文件（推荐）

OpenCode 的全局配置文件路径：

Windows: C:\Users\你的用户名\.config\opencode\opencode.json
Linux/macOS: ~/.config/opencode/opencode.json

如果文件或目录不存在，手动创建即可。

用记事本或任意编辑器打开，写入以下内容：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        "baseURL": "https://claudeapi.com/v1",
        "apiKey": "sk-你的密钥"
      },
      "models": {
        "claude-sonnet-4-6": {
          "name": "claude-opus-4-6"
        },
        "claude-haiku-4-5-20251001": {
          "name": "claude-sonnet-4-6"
        },
        "claude-opus-4-6": {
          "name": "claude-haiku-4-5-20251001"
        }
      }
    }
  }
}

字段说明：

字段	作用
`"anthropic"`	提供商标识，告诉 OpenCode 使用 Anthropic 协议
`baseURL`	你的中转平台 API 地址，注意末尾需要加 `/v1`
`apiKey`	从中转平台获取的密钥
`models`	声明你要使用的模型及其显示名称

⚠️ 注意 baseURL 末尾需要带 /v1，这与 Claude Code 的配置不同。

4.2 方式二：交互式配置（/connect 命令）

如果你不想手动编辑 JSON，也可以启动 OpenCode 后通过交互命令配置：

打开终端，输入 opencode 启动
在界面中输入 /connect
按提示选择 Anthropic 作为提供商
依次填入 API Key 和 Base URL
选择要启用的模型

4.3 项目级配置（可选）

如果你希望不同项目使用不同的 API 配置，可以在项目根目录创建 opencode.json：

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "anthropic": {
      "npm": "@ai-sdk/anthropic",
      "options": {
        "baseURL": "https://hk.claudeapi.com/v1",
        "apiKey": "sk-项目专用密钥"
      },
      "models": {
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6"
        }
      }
    }
  }
}

项目级配置会覆盖全局配置。配置优先级：项目配置 > 全局配置 > 远程配置。

第五章：验证配置并开始使用

5.1 启动 OpenCode

opencode

启动后你会看到一个精美的终端界面（TUI），底部有输入框。

5.2 测试对话

在输入框中输入：

你好，请用一句话介绍你自己。

预期回复：

我是 Claude，由 Anthropic 开发的 AI 助手，擅长编程、分析和创作。

收到正常回复，说明 API 配置成功。

5.3 测试代码能力

试一下代码生成：

用 Python 写一个快速排序算法，附带注释。

OpenCode 会直接在终端中展示格式化的代码输出。

5.4 测试文件操作（Build 代理）

在一个项目目录中启动 OpenCode，然后输入：

帮我分析当前项目的目录结构，创建一个 README.md 文件。

OpenCode 的 Build 代理会读取项目文件、生成内容并写入文件——全自动完成。

5.5 非交互模式

如果只想快速问一个问题，不进入 TUI 界面：

opencode -p "解释一下 Go 语言中 context 的用法"

直接输出结果，适合集成到脚本中。

第六章：进阶技巧

6.1 双代理模式

OpenCode 内置两个代理，各有分工：

代理	权限	适用场景
Build（默认）	可读写文件、执行命令	代码生成、重构、创建文件
Plan	只读，修改前会请求确认	代码分析、方案设计、安全审查

切换方式：在 OpenCode 界面中输入 /agent plan 或 /agent build。

💡 做代码审查和分析时用 Plan 代理，避免意外修改文件。

6.2 切换模型

如果你在配置中声明了多个模型，可以在对话中切换：

/model claude-opus-4-6

日常编码用 Sonnet，遇到复杂问题切 Opus。

6.3 多会话管理

OpenCode 支持同时运行多个会话，互不干扰。启动时指定不同的会话名称：

opencode --session "backend-refactor"
opencode --session "frontend-debug"

6.4 与 IDE 配合使用

OpenCode 可以在任何 IDE 的终端中运行——包括 VS Code、Cursor、JetBrains 等。在 IDE 中按快捷键打开终端，输入 opencode 即可。

第七章：常见问题排查

7.1 安装类问题

问题	解决方案
`'opencode' 不是内部或外部命令`	① 重新安装：`npm install -g opencode-ai` ② 检查 PATH：`npm config get prefix`，确认该路径在系统 PATH 中 ③ Scoop 用户重新打开终端
npm 安装报权限错误	以管理员身份运行 CMD 重试
安装后版本过旧	`npm update -g opencode-ai` 更新到最新版

7.2 API 配置类问题

问题	解决方案
对话时提示认证失败	① 检查 `opencode.json` 中的 `apiKey` 是否完整 ② 确认中转平台 Key 状态为「启用」 ③ 检查余额
提示模型不存在	① 确认 `models` 中的模型 ID 与平台支持的一致 ② 检查 `baseURL` 末尾是否有 `/v1`
连接超时	① 检查 `baseURL` 拼写 ② 确认网络能访问中转平台 ③ `curl` 单独测试 API
JSON 配置语法错误	用 jsonlint.com 在线校验

7.3 curl 手动验证 API

如果对话始终失败，先排除 API 本身的问题：

curl -s https://hk.claudeapi.com/v1/messages \
  -H "Content-Type: application/json" \
  -H "x-api-key: sk-你的密钥" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "claude-haiku-4-5-20251001",
    "max_tokens": 100,
    "messages": [{"role": "user", "content": "说你好"}]
  }'

返回正常 JSON → API 没问题，检查 OpenCode 配置
返回错误 → 先修复 API Key 或 Base URL

第八章：OpenCode vs Claude Code 对比

既然都是终端 AI 编程工具，OpenCode 和 Claude Code 有什么区别？

对比项	OpenCode	Claude Code
开源	✅ 完全开源（MIT）	❌ Anthropic 官方闭源
模型支持	75+ 提供商（Claude/GPT/Gemini/DeepSeek…）	仅 Claude 系列
终端界面	TUI（精美的终端 UI）	纯命令行交互
双代理模式	✅ Build + Plan	❌ 单代理
多会话	✅	❌
LSP 集成	✅	❌
GitHub 集成	✅ 在 Issue/PR 中 @opencode	❌
桌面应用	✅ 提供 Desktop App	❌
安装方式	npm / scoop / choco / brew / 脚本	npm