8
12
OpenCode 保姆级教程来了：安装部署到实战使用全讲透
2026-05-07 17:24:59
0点赞
0收藏
0评论
随着 AI 编程工具的快速发展，越来越多开发者开始希望在本地终端中直接调用大模型，完成代码生成、代码解释、Bug 排查、代码审查等工作。相比传统网页端 AI 工具，运行在命令行环境中的 AI 编程助手更加贴近开发流程，也更适合日常写代码、调试项目和管理本地工程。
Opencode 就是一款面向开发者的终端 AI 编程助手。它支持接入多种主流大语言模型，开发者可以通过配置 API Key 和 Provider，在本地命令行中直接使用 AI 能力，无需频繁切换工具，大幅提升开发效率。
本文将围绕 Opencode 安装教程、Opencode 配置方法、Opencode API 接入、Provider 配置以及实际使用示例 展开，带你从零开始完成 Opencode 的安装、模型配置和命令行调用。如果你正在搜索 Opencode 怎么用、Opencode 如何配置 API、Opencode provider 配置教程，这篇文章可以作为一份完整的入门参考。
一、先安装 Opencode
在开始配置之前，需要先完成 Opencode 的安装。
你可以先确认本地已经安装 Node.js，然后通过命令行执行以下命令安装 Opencode：
npm install -g opencode-ai
安装完成后，就具备了继续配置的基础环境。
二、了解 Opencode 的 provider 配置位置
Opencode 的 provider 需要通过配置文件进行设置。通常需要配置两个位置：
provider 配置文件
认证密钥文件
这两个文件分别负责：
告诉 Opencode 请求应该发往哪个 API 地址
告诉 Opencode 使用哪个 API Key 进行鉴权
三、配置 Opencode provider：设置 API baseURL
先需要创建或编辑 Opencode 的配置文件。
常见配置路径如下：
~/.config/opencode/opencode.json
在 Windows 环境中，~ 一般代表当前用户目录，例如：
C:Users你的用户名
在该文件中加入如下配置：
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"anthropic": {
"options": {
"baseURL": "https://api.allmhub.com//v1"
}
}
}
}
配置说明
选定使用 anthropic 这一 provider 名称
通过 options.baseURL 将默认请求地址替换为目标 API 地址
让 Opencode 后续在调用模型时，走你设定的接口入口
如果你在配置 Opencode 接口时遇到无法连接、请求默认官网地址等情况，通常需要优先检查这里的 baseURL 是否填写正确。
四、配置 Opencode API Key：设置 auth.json 鉴权信息
完成 provider 配置后，还需要继续设置鉴权文件。
常见路径如下：
~/.local/share/opencode/auth.json
在该文件中写入认证信息，例如：
{
"google": {
"type": "api",
"key": "111111111111111111111"
},
"anthropic": {
"type": "api",
"key": "sk-xxxxxxxxxxxxxx"
}
}
配置说明
这里的重点在于 anthropic 这一部分：
type 使用 api
key 填入你实际可用的 API 密钥
如果你的使用目标是通过 anthropic 通道调用模型，那么这里必须确保 anthropic.key 填写正确，否则会在请求时出现认证失败、无权限访问或接口调用异常等问题。
五、启动 Opencode
完成上述两个配置文件后，就可以打开终端启动 Opencode。
在命令行中直接输入：
opencode
如果安装和配置都没有问题，Opencode 会成功进入交互界面。
核心检查点
本地命令可正常执行
配置文件可被程序识别
provider 和密钥加载成功
如果无法启动，可以优先排查以下几点：
npm install -g opencode-ai 是否安装成功
Node.js 是否已加入系统环境变量
配置文件路径是否正确
JSON 格式是否有语法错误
六、在 Opencode 中查看可用模型
进入 Opencode 后，可以通过命令查看模型列表：
/models
该命令会打开模型切换或模型选择界面，显示当前可用的 provider 以及模型列表。
核心意义
确认 provider 是否已成功连接
Opencode 是否已经识别到对应模型
当前账户是否具备模型调用权限
如果模型列表无法正常显示，通常需要重新检查：
baseURL 是否可访问
API Key 是否有效
provider 名称是否与配置一致
七、选择 anthropic 下的模型
在模型列表中，找到 Anthropic 分类，然后选择需要使用的模型。
例如可以在列表中看到类似模型：
根据自己的任务需求选择对应模型即可
模型选择建议
日常问答、轻量代码生成、快速响应 → 选择速度较快的轻量模型
复杂代码分析、长文本理解、高质量生成 → 选择能力更强的高阶模型
这一步完成后，Opencode 就会把后续请求发送到你当前选定的模型。
八、开始使用 Opencode
当模型选择完成后，就可以正式开始使用 Opencode 进行交互。
结语
以上就是一套完整的 Opencode 应用配置教程。从安装、配置 baseURL、填写 API Key，到选择模型并开始使用，整个流程并不复杂，关键在于两个配置文件的路径和内容必须正确。
如果你正在搜索：
Opencode 怎么配置
Opencode 如何接入 API
Opencode provider 配置方法
Opencode anthropic 模型使用教程
那么按照本文步骤逐项检查，通常就可以顺利完成接入和使用。
