---
title: "如何在 OpenCode 中使用 Claude"
description: "OpenCode 2 是什么、怎么用一份 opencode.jsonc 接上 CodingPass 的 Claude、GPT 和开源模型。"
url: https://codingpass.ai/zh/blog/how-to-use-claude-in-opencode
language: zh-CN
updated: 2026-11-19
---
# 如何在 OpenCode 中使用 Claude

OpenCode 2 改了自定义 provider 的写法，桌面端设置里的自定义表单也存不进去。本文用一份 opencode.jsonc 接上 CodingPass。

[CodingPass 团队](https://codingpass.ai/zh/about) 发布于 2026年11月19日 更新于 2026年11月19日 阅读约 8 分钟

本文把 CodingPass 接进 OpenCode 2：一个 Key 用 Claude、GPT 和 DeepSeek、Kimi 等开源模型，终端和桌面端共用一份配置。只想照着步骤配的，看 [OpenCode 接入指南](https://codingpass.ai/zh/tools/opencode) 就够了；这里多了客户端介绍。

## OpenCode 是什么

OpenCode 是一个开源的编程 Agent，代码在 GitHub 的 anomalyco/opencode 仓库，MIT 协议。它不绑定模型厂商：自带一批免费模型，不注册也能用；也能接 OpenAI、Anthropic、xAI 等厂商的 API，或者直接用 ChatGPT Plus / Pro、GitHub Copilot 订阅。OpenCode 本身免费，接别家 provider 的费用由那一家收。

入口有好几个：

- **终端界面**：能开在任意 shell、编辑器的内置终端或远程服务器上
- **桌面端**：支持 macOS、Windows 和 Linux，每个会话一个标签页，改动按 diff 审，自带浏览器预览
- **其他**：网页版（`opencode pair`）、手机 App 和 SDK

OpenCode 2 起默认跑一个共享的后台服务，这些入口都是连到它上面的客户端，所以终端里开的会话，桌面端也能接着看。截至 11 月 18 日，最新版是 v2.3.2。

接上 CodingPass 以后，模型列表里多出一组 CodingPass 的模型。11 月 18 日 `GET https://codingpass.ai/v1/models` 返回 26 个，覆盖 Claude（Sonnet 5.5、Opus 5.5、Fable 5.2 等）、GPT（GPT-6.2 Sol、GPT-6.1 Terra 等）、Gemini、Grok，以及 DeepSeek、Kimi、GLM、Qwen、MiniMax、MiMo、Hy4 等开源模型。你的档位能用哪些，以 [模型页](https://codingpass.ai/zh/models) 为准。

## 接入实操

### 准备

- 装好 OpenCode 2，`opencode --version` 输出 `v2.x`。
- 在 CodingPass 控制台的 Key 页创建一个 Key，工具选 OpenCode。

### 1. 写配置文件

把下面这份存成 `~/.config/opencode/opencode.jsonc`。Claude 和开源模型走 Anthropic 包，GPT 走 Responses 包：

~/.config/opencode/opencode.jsonc

```
{
  "$schema": "https://opencode.ai/config.json",
  "model": "codingpass/claude-sonnet-5-5",
  "providers": {
    "codingpass": {
      "name": "CodingPass",
      "env": ["CODINGPASS_API_KEY"],
      "package": "@opencode/ai/providers/anthropic",
      "settings": { "baseURL": "https://codingpass.ai/v1" },
      "models": {
        "claude-sonnet-5-5": { "name": "Claude Sonnet 5.5" },
        "claude-opus-5-5": { "name": "Claude Opus 5.5" },
        "deepseek-v4.1-flash": { "name": "DeepSeek V4.1 Flash" },
        "kimi-k2.7-code": { "name": "Kimi K2.7 Code" }
      }
    },
    "codingpass-openai": {
      "name": "CodingPass (OpenAI)",
      "env": ["CODINGPASS_API_KEY"],
      "package": "@opencode/ai/providers/openai-compatible/responses",
      "settings": { "baseURL": "https://codingpass.ai/v1" },
      "models": {
        "gpt-6.2-sol": { "name": "GPT-6.2 Sol" },
        "gpt-6.1-terra": { "name": "GPT-6.1 Terra" }
      }
    }
  }
}
```

`baseURL` 要带 `/v1`，不带会报 404。`models` 按你的档位增删，模型 ID 在 [模型页](https://codingpass.ai/zh/models) 查。

### 2. 设置 Key

Terminal

```
opencode service set env CODINGPASS_API_KEY cp-live-…
```

Key 存在 OpenCode 后台服务的环境里，终端和桌面端都读得到。

### 3. 选模型，发一条消息

重开 OpenCode，输入 `/models`，选 CodingPass 下的 Claude Sonnet 5.5，随便发一条消息，有回复就接好了。

Terminal

```
opencode
/models
```

![OpenCode 终端界面：发送 Say hi in five words，回复 Hello there, nice to meet you!，下方显示 Build · Claude Sonnet 5.5 CodingPass](https://codingpass.ai/assets/img/tools/opencode/tui-models.webp)

*OpenCode 2.3.2 终端界面，模型是 CodingPass 下的 Claude Sonnet 5.5。*

### 桌面端

从 [opencode.ai/desktop](https://opencode.ai/desktop) 下载。桌面端读同一份配置和 Key，不用再配，在输入框旁的模型选择器里选 CodingPass 的模型就行。

![OpenCode 桌面端会话：发送 Say hi in five words，回复 Hello there, nice to meet you!，输入框下方的模型选择器显示 CodingPass / Claude Sonnet 5.5](https://codingpass.ai/assets/img/tools/opencode/desktop-model-picker.webp)

*桌面端不用另配，模型选择器里直接有 CodingPass。*

作者 CodingPass 团队

CodingPass 由我们运营。每篇指南发布前，都会在对应工具的最新稳定版上实测一遍。发现内容过时了？写信到 [support@codingpass.ai](mailto:support@codingpass.ai)。

## 相关阅读。

指南

### [OpenCode 接入指南](https://codingpass.ai/zh/tools/opencode)

三步接入、各档位的默认模型，以及开源模型的额度。

指南

### [OpenCode 2 很好，但用不了 Claude？](https://codingpass.ai/zh/blog/opencode-claude-third-party-400)

OpenCode 2 变了什么，以及接 Claude 订阅时那条 400 是怎么来的。

模型

### [全部模型](https://codingpass.ai/zh/models)

每个模型的 ID、所需档位和月度额度。
