Claude Code 中转介绍
OpenCode 配置
在 OpenCode 中接入 Nexoraivision Claude(anthropic provider)的完整配置。
OpenCode 是开源 CLI 与 IDE 集成的 AI Agent,原生支持任意 Anthropic / OpenAI 兼容后端。
配置文件位置
| 平台 | 路径 |
|---|---|
| macOS / Linux | ~/.config/opencode/opencode.json 或 opencode.jsonc |
| Windows | %APPDATA%\opencode\opencode.json |
目录或文件不存在需手动创建。也可用 OpenCode 客户端的
/connect 命令交互式配置。最小配置
把下面内容写入 opencode.json,把 apiKey 替换为你 控制台 生成的 Key:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"anthropic": {
"options": {
"baseURL": "https://nexor.nexoraivision.com/v1",
"apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
},
"npm": "@ai-sdk/anthropic"
}
}
}
字段说明:
| 字段 | 必填 | 说明 |
|---|---|---|
provider.anthropic.options.baseURL | ✅ | 必须带 /v1 |
provider.anthropic.options.apiKey | ✅ | 你的 Nexoraivision Key |
provider.anthropic.npm | ✅ | 固定填 @ai-sdk/anthropic,OpenCode 会自动安装该 SDK |
完整配置(含模型清单与变体)
如果你想在 OpenCode 里看到具体模型选项与上下文限制:
{
"$schema": "https://opencode.ai/config.json",
"provider": {
"anthropic": {
"options": {
"baseURL": "https://nexor.nexoraivision.com/v1",
"apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
},
"npm": "@ai-sdk/anthropic",
"models": {
"claude-opus-4-7": {
"name": "Claude Opus 4.7",
"limit": { "context": 200000, "output": 32000 }
},
"claude-opus-4-6": {
"name": "Claude Opus 4.6",
"limit": { "context": 200000, "output": 32000 }
},
"claude-opus-4-5-20251101": {
"name": "Claude Opus 4.5 (11/01)",
"limit": { "context": 200000, "output": 32000 }
},
"claude-sonnet-4-6": {
"name": "Claude Sonnet 4.6",
"limit": { "context": 200000, "output": 64000 }
},
"claude-sonnet-4-5-20250929": {
"name": "Claude Sonnet 4.5 (09/29)",
"limit": { "context": 200000, "output": 64000 }
},
"claude-haiku-4-5-20251001": {
"name": "Claude Haiku 4.5 (10/01)",
"limit": { "context": 200000, "output": 16000 }
}
}
}
},
"agent": {
"build": { "options": { "store": false } },
"plan": { "options": { "store": false } }
}
}
字段详解
| 字段 | 说明 |
|---|---|
models.<id>.name | 客户端展示名 |
models.<id>.limit.context | 上下文最大 Token |
models.<id>.limit.output | 单次最大输出 Token |
agent.build.options.store | false 不持久化构建任务响应 |
agent.plan.options.store | false 不持久化规划任务响应 |
模型清单
| 模型 ID | 上下文 | 输出 | 适合 |
|---|---|---|---|
claude-opus-4-7 | 200K | 32K | 最强,难题、架构 |
claude-opus-4-6 | 200K | 32K | 上一代 Opus |
claude-opus-4-5-20251101 | 200K | 32K | Opus 4.5 快照(锁版本用) |
claude-sonnet-4-6 | 200K | 64K | 日常默认,性能与成本平衡 |
claude-sonnet-4-5-20250929 | 200K | 64K | Sonnet 4.5 快照(锁版本用) |
claude-haiku-4-5-20251001 | 200K | 16K | Tab 补全、轻量任务、低成本 |
带日期后缀的是快照版本,行为永久锁定。Haiku 4.5 只有快照版本,没有不带日期的别名。
完整说明见 模型与渠道选择。
使用示例
启动 OpenCode 进入交互模式:
opencode
切换模型:
/model claude-sonnet-4-6 # 默认
/model claude-opus-4-7 # 难题升级
/model claude-haiku-4-5-20251001 # 轻量任务(Haiku 仅快照版)
用 /connect 交互配置
不想手编 JSON:
opencode
> /connect
按提示选 Anthropic provider → 输入 baseURL 和 apiKey,OpenCode 自动写入 opencode.json。
多 Provider 共存
如果你同时用官方 Anthropic + Nexoraivision,把它们并列在 provider:
{
"provider": {
"anthropic-official": {
"options": {
"baseURL": "https://api.anthropic.com/v1",
"apiKey": "sk-ant-xxx"
},
"npm": "@ai-sdk/anthropic"
},
"anthropic": {
"options": {
"baseURL": "https://nexor.nexoraivision.com/v1",
"apiKey": "sk-xxx"
},
"npm": "@ai-sdk/anthropic"
}
}
}
OpenCode 模型选择器里会显示 anthropic/claude-opus-4-7 与 anthropic-official/claude-opus-4-7,互不冲突。
同时配 OpenAI 和 Anthropic
如果你想在一个 OpenCode 里同时用 GPT-5 和 Claude:
{
"provider": {
"openai": {
"options": {
"baseURL": "https://nexor.nexoraivision.com/v1",
"apiKey": "sk-xxx"
}
},
"anthropic": {
"options": {
"baseURL": "https://nexor.nexoraivision.com/v1",
"apiKey": "sk-xxx"
},
"npm": "@ai-sdk/anthropic"
}
}
}
注意 OpenAI provider 不需要 npm 字段(OpenCode 内置),Anthropic 需要。
故障排查
- 确认
opencode.json在正确路径(不是项目目录里) - JSON 语法错误:用 jsonlint.com 校验
- 缺
"npm": "@ai-sdk/anthropic"字段,OpenCode 不会加载该 SDK - 跑
opencode --debug看启动日志
- Key 复制不完整(首尾空格、被截断)
- 控制台确认 Key 启用状态
- 直接 curl 验证 Key:
curl https://nexor.nexoraivision.com/v1/messages \
-H "x-api-key: YOUR_API_KEY" \
-H "anthropic-version: 2023-06-01" \
-H "Content-Type: application/json" \
-d '{"model":"claude-haiku-4-5","max_tokens":16,"messages":[{"role":"user","content":"hi"}]}'
OpenCode 必须带 /v1。Claude Code CLI 的 ANTHROPIC_BASE_URL 不带 /v1(CLI 自己拼)。两个不一样,别搞混。
不是必须,但强烈建议保留。让 OpenCode 不在中转端落盘任何对话内容,隐私最佳实践。
其他编辑器接入见 VSCode 插件。
