OpenCode 代码助手

Claude Code 太重？OpenCode 是个开源的、更轻量的代码助手 CLI——同样在终端里跑、同样能改代码、同样支持多模型，但安装包更小、依赖更少、社区驱动。

接入平台填写口径

• Base URL：https://www.yuzhixiaolongxia.com/v1（OpenAI 兼容协议，带 /v1）
• API Key：你的平台令牌（按要调用的模型选对应分组）
• Model：例如 gpt-5.5、claude-opus-4-7，去 模型广场 复制

OpenCode 是什么

对比维度	OpenCode	Claude Code
出品方	开源社区	Anthropic 官方
模型范围	OpenAI 兼容协议 = 几乎所有平台	主打 Claude
安装包大小	小	中等
可定制度	高（开源）	中（官方功能）
适合场景	多模型自由切换、轻量级用	Claude 用户的全功能首选

一句话：OpenCode 是 Claude Code 的开源平替，重点是"灵活、轻量、不锁死任何一个模型厂商"。

安装

npm install -g opencode-ai

先装 Node.js

如果系统提示 npm: command not found，先去 https://nodejs.org 装 Node.js（建议 LTS 版本），装完重开终端再跑上面这条。

验证安装：

opencode --version

输出版本号就装好了。

配置平台接入

OpenCode 走 OpenAI 兼容协议，配置方式跟其他 OpenAI 兼容工具一致。

方式一：环境变量（推荐）

在 ~/.bashrc / ~/.zshrc 末尾追加：

export OPENAI_BASE_URL="https://www.yuzhixiaolongxia.com/v1"
export OPENAI_API_KEY="你的平台令牌"

重载配置：

source ~/.zshrc   # 或 ~/.bashrc

方式二：交互式配置

直接跑：

opencode

第一次启动会提示填 Base URL、API Key、默认模型。按平台口径填：

字段	填什么
Base URL	https://www.yuzhixiaolongxia.com/v1
API Key	你的平台令牌
Model	例如 gpt-5.5

模型 ID 选择

按要调用的模型选对应的令牌分组：

要调用的模型	令牌选哪个分组	示例 Model ID
GPT / Codex 系列	Codex 家族	gpt-5.5、gpt-5.4、gpt-5.3-codex
Claude 系列	Claude 家族	claude-opus-4-7、claude-sonnet-4-6
Gemini 系列	Gemini 家族	gemini-3.1-pro-preview

一个 Base URL，多种模型

OpenAI 兼容协议下，平台的 /v1 端点可以同时转发 Claude / GPT / Gemini——只要令牌分组对，模型 ID 写对就行。
比如用 Claude 家族令牌 + claude-opus-4-7 这个组合，OpenCode 也能正常调到 Claude 模型。

验证

进入交互界面：

opencode

输入 /models 看模型列表是否能拉取，然后让它写段代码（"帮我用 Python 写一个 Hello World"），AI 正常返回代码即配置成功。

适合的场景

场景	怎么用 OpenCode
给一个项目快速跑 AI 助手	cd <项目目录> 后跑 opencode，AI 自动读你的项目结构
多模型 A/B 测试	跑同一条提示，切换 Model 看哪个模型效果好
服务器无 GUI 环境	纯 CLI，SSH 进去就能用
嵌入到自己的工具链	开源代码可以直接二次封装

常见问题

model not found

1. 令牌分组对不对？（用 Claude 家族令牌却写 gpt-5.5 肯定不行）
2. 模型 ID 对不对？（去 模型广场 复制）

401 Unauthorized

1. 令牌过期 / 删除了？回 /console/token 检查
2. 环境变量复制时多了空格？echo $OPENAI_API_KEY 看看末尾对不对

opencode: command not found

npm install -g 装的全局命令，新开终端才生效。或者执行 source ~/.zshrc。

想换默认模型

修改环境变量 OPENAI_MODEL，或者在交互界面里输入 /model <新模型 ID>。

上一步：AionUI 图形工作台 | 下一步：OpenClaw 浏览器代理