OpenCode API Key 配置

OpenCode API Key 配置：Base URL、Provider 与模型

OpenCode 用第三方 API 需要三样：一个 API Key、一个 base_url、一份 provider 配置。

按量付费接入 Claude、Kimi、GLM 等模型：拿到 API Key 后写入 opencode.json 的 base_url 与 provider，再用一条测试消息确认连接。

opencode.json 示例JSON

opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "model": "aicodewith-anthropic/claude-opus-5-5",
  "provider": {
    "aicodewith-anthropic": {
      "npm": "@ai-sdk/anthropic",
      "name": "AI Code With Anthropic",
      "options": {
        "baseURL": "https://api.aicodewith.ai",
        "apiKey": "{env:AICODEWITH_API_KEY}"
      },
      "models": {
        "claude-opus-5-5": {
          "name": "Claude Opus 5.5"
        }
      }
    }
  }
}

未安装 OpenCode？

本页配置的是 OpenCode 终端版（CLI）。如果终端运行 opencode --version 已经返回版本号，可以直接跳到快速配置。

打开 OpenCode 官方下载页我已安装，继续配置

基础安装命令

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

或用 npm 全局安装（搜索里常见的安装命令）

npm install -g opencode-ai@latest

运行 opencode --version 看到版本号即安装成功。

继续配置 AI Code With 查看官方安装文档

安全快速配置

选择模型、复制配置、保存文件并验证连接，3 分钟完成接入。

1. 选择模型

当前目录共 46 个模型。

2. 复制配置

Provider: aicodewith-anthropic
npm adapter: @ai-sdk/anthropic
Base URL: https://api.aicodewith.ai
Model ID: claude-opus-5-5

{
  "$schema": "https://opencode.ai/config.json",
  "model": "aicodewith-anthropic/claude-opus-5-5",
  "provider": {
    "aicodewith-anthropic": {
      "npm": "@ai-sdk/anthropic",
      "name": "AI Code With Anthropic",
      "options": {
        "baseURL": "https://api.aicodewith.ai",
        "apiKey": "{env:AICODEWITH_API_KEY}"
      },
      "models": {
        "claude-opus-5-5": {
          "name": "Claude Opus 5.5"
        }
      }
    }
  }
}

下一步：保存配置

3. 保存 opencode.json 并设置 API Key

备份已有 opencode.json，再合并生成内容中的 model 和 provider；不要覆盖其他 Provider。真实 Key 只保存在本机环境变量中。

打开 API Key 页面

保存配置文件

1. 打开系统终端
2. 运行下面的命令打开配置文件（不存在会自动创建）：
```
notepad "$env:USERPROFILE\.config\opencode\opencode.json"
```
3. 粘贴第 2 步复制的配置内容并保存
Windows/Linux 按 Ctrl+S，macOS 按 Cmd+S。

设置 API Key（替换 your-key 为你的真实 Key）

临时使用（仅当前终端会话有效）

$env:AICODEWITH_API_KEY = "your-key"

关闭终端后失效；适合快速测试。

长期保存（写入用户配置，新终端自动生效）

setx AICODEWITH_API_KEY "your-key"

保存后需要新开终端或重新加载 shell 配置才会生效，然后再重启 OpenCode。

4. 重启并验证

在系统终端运行opencode
进入 OpenCode 后输入/models 确认 Provider 和 Model ID 与页面选择一致
在对话框发送请只回复：连接成功
确认 OpenCode 显示回复，并按时间和模型核对 AI Code With 使用记录

使用记录能确认请求到达 AI Code With；是否成功还需要结合状态、响应内容和 OpenCode 实际回复判断。

配置没有生效，进入排错

OpenCode 如何接入第三方 API？

OpenCode 通过自定义 Provider 把请求发送到你指定的 API 服务：Provider 是命名空间，告诉 OpenCode 请求发给哪个服务；API Key 负责身份验证；Base URL 是第三方 API 的请求地址；Model ID 指定实际调用的模型。

保存配置后，请求将按照 OpenCode → Provider → Base URL → 模型 API 的链路发送。完成 /models 和短消息测试后，可根据时间和模型核对对应使用记录。

配置失败时先检查这 4 项

每项都链接到对应的排错文章，可展开查看详细步骤。

401 Unauthorized
查看详细排错 →
通常是 API Key 无效、填写错误或没有被正确读取。检查 AICODEWITH_API_KEY 是否设置、是否有多余空格，并确认 OpenCode 从同一个终端启动。
Model Not Found
查看详细排错 →
Model ID 与 Provider 配置不匹配，或当前渠道不支持该模型。逐字符核对生成配置中的 Model ID 与 Provider 组合。
Base URL / 404
查看详细排错 →
通常是 Base URL 填写错误。复制本页生成的地址，不要手动追加 /v1、/v1beta 或猜测接口路径。
配置未生效 / Provider 未出现
查看详细排错 →
检查配置文件路径是否正确、JSON 格式是否有效，以及 OpenCode 是否重新加载了配置。保存后重新打开 OpenCode，再运行 /models。

常见问题

Base URL 应该填什么？

直接复制本页快速配置生成的 Base URL，不要手动拼接 /v1 或 /v1beta。

OpenCode 配置文件在哪里？

本页生成的建议路径是 ~/.config/opencode/opencode.json。路径可能随安装方式和版本变化，保存前请对照当前 OpenCode 官方文档。

配置完成后怎么确认成功？

运行 /models 选择模型，发送一条短消息，再到 AI Code With 用量记录按时间和模型核对这次请求。

支持哪些模型？

支持 Claude、GPT、Gemini、DeepSeek、GLM、Kimi、Grok 等模型。点击「查看全部模型」可浏览完整目录。

需要完整安装或排错说明？

查看 OpenCode 接入文档，获取完整安装教程、全部配置参数、完整模型列表与故障排查。

查看 OpenCode 接入文档