OpenCode 接入 Claude API

使用 OpenCode 的自定义供应商功能连接 1折AI。先创建 API 密钥，并确认当前可用模型；下文模型 ID 是示例，请按你的密钥权限调整。

官方配置核对日期：2026-10-15。以下配置依据官方文档整理，本站端到端验证尚未完成；请先完成简短问答和工具调用验证，再用于长任务。OpenAI / GPT 模型已上线，模型列表与价格见模型说明。

OpenCode v1 配置

依据 官方 v1 Providers：运行 /connect，选择 Other，provider ID 输入 onezhe，填写本站 API Key。在项目 opencode.json 合并：

json

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "onezhe": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "1折AI",
      "options": { "baseURL": "https://1zheai.com/v1" },
      "models": {
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
      }
    }
  }
}

随后 /models 选择该 provider 的模型。/connect 只保存凭据，不代替 provider 配置。这里明确选择 Chat Completions 的 SDK；不能误换为用于 Responses 的 @ai-sdk/openai。官方也允许通过 options.apiKey: "{env:ONEZHE_API_KEY}" 引用环境变量。

OpenCode v2 配置

依据 官方 v2 Providers，使用原生 v2 字段，不能与上方 v1 混写。在项目 opencode.jsonc 合并：

json

{
  "$schema": "https://opencode.ai/config.json",
  "providers": {
    "onezhe": {
      "name": "1折AI",
      "env": ["ONEZHE_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible",
      "settings": { "baseURL": "https://1zheai.com/v1" },
      "models": {
        "claude-sonnet-4-6": { "name": "Claude Sonnet 4.6" }
      }
    }
  }
}

在启动 OpenCode 的进程环境提供 ONEZHE_API_KEY，然后 /models 选择 onezhe/claude-sonnet-4-6。v2 主要差异是 providers、package、settings，而非 v1 的 provider、npm、options。请先用 opencode --version 确认所用大版本。

若要使用原生 Anthropic，v1 官方允许覆盖 provider.anthropic.options.baseURL，示例包含 /v1；v2 列出 @opencode/ai/providers/anthropic-compatible。本教程走明确的 OpenAI 兼容配置，不能据模型名称自行更换协议或承诺缓存、工具调用都已验证。

验证接入与排错

1. 保存并重新加载配置，确认当前选中的是 onezhe 供应商或你添加的自定义模型。
2. 发送一句简短问题，确认能够返回；随后尝试一个可撤销的小任务，单独确认工具调用和多轮对话。
3. 打开调用日志，核对请求时间、模型、状态与用量。一次文本回复成功不代表所有 Agent 能力都已兼容。
4. 遇到 404，核对本文地址和协议是否配套；遇到 401，核对密钥来源和进程是否读取到环境变量；遇到 429，查看限流信息后再重试。更多情况见错误码与排错。

密钥只保存在本地环境或工具的凭据存储中，不要提交到代码仓库、截图或公开日志。后台服务可能不继承终端环境变量；辅助模型、搜索和其他工具也可能有独立的供应商设置，需要分别检查。

费用与其他接入方式

查看Claude API 实时价格和计费规则。需要其他客户端时返回工具接入目录；自己编写程序可用SDK 与开发指南。