通过 OpenCode 安装配置教程

一、方案简介

OpenCode 是一款极具特色的 AI 编程助手客户端。它内置了免费的国产模型额度，最大的亮点是：你可以直接和 AI 对话，让它帮你检查环境、安装软件、配置 API 等。

对于没有命令行经验的用户，这是最省心的配置方式。你可以通过 OpenCode 自动配置接入 APIBox，无缝直连 Claude、GPT-5 和各大模型。

二、安装步骤

1. 下载并安装 OpenCode

访问 OpenCode 官网下载页，选择对应系统的客户端进行安装。

安装过程和普通软件一样，下载后运行安装程序，一路下一步即可。

2. 注册并登录

安装完成后打开 OpenCode，使用手机号或邮箱注册账号并登录。新用户有免费的国产模型额度，足够完成配置使用。

3. 获取 API 密钥

前往 APIBox 控制台 获取你的 API Key。

提示：APIBox 价格约为官方 1/7，支持所有主流模型，人民币充值。

4. 关键步骤：利用 AI 自动配置 APIBox

在 OpenCode 中，打开侧边栏的对话窗口。

直接输入以下要求：

“请帮我配置环境变量，将 ANTHROPIC_BASE_URL 设置为 https://api.apibox.cc/v1，并将 ANTHROPIC_AUTH_TOKEN 设置为我的密钥 你的_APIBox_Key。我是 macOS（或 Windows）用户。”

AI 会自动生成对应的终端命令，并提供一个 “运行” 按钮。点击运行即可完成环境变量配置。

三、常见问题排查

❌ 配置后仍然调用失败

原因： Base URL 缺少 /v1 尾缀。 解决： 确保 Base URL 填写完整：https://api.apibox.cc/v1。让 AI 重新为你写入环境变量。

❌ 报错：“Invalid API Key”

原因： 密钥字符串带有空格或换行。 解决： 请勿复制错误，重新在控制台复制 APIBox 的 Key 粘贴给 AI。

❌ 模型名不存在

原因： OpenCode 或者配置工具使用了不支持的模型名。 解决： 请参阅 APIBox 官方文档或控制台确认模型名称。例如不能填 claude-3-5-sonnet，要填 claude-sonnet-4-6。