OpenCode 配置
OpenCode 是一个开源的 AI 编程 CLI 工具，支持 OpenAI 兼容接口。接入 521code 后可使用 OpenAI 兼容端点调用 GPT/Codex 系列模型。
工具简介
OpenCode CLI 主要功能：
- 轻量级 AI 编程工具，启动快速
- 支持 OpenAI 兼容接口
- 支持代码生成、解释和调试
- 跨平台支持（macOS、Linux、Windows）
安装指南
官方安装脚本（Linux/macOS/WSL）
curl -fsSL https://opencode.ai/install | bash
npm 安装
npm install -g opencode-ai
pnpm 安装
pnpm install -g opencode-ai
yarn 安装
yarn global add opencode-ai
bun 安装
bun install -g opencode-ai
Homebrew 安装（macOS/Linux）
brew install anomalyco/tap/opencode
Windows
使用 Chocolatey：
choco install opencode
或使用 Scoop：
scoop install opencode
验证安装
安装完成后，在终端中运行：
opencode --version
启动 OpenCode
opencode
521code 接入配置
OpenCode 可以通过 OpenAI 兼容 provider 接入 521code。配置文件通常位于 ~/.config/opencode/opencode.json，也可以使用 opencode.jsonc。如果文件不存在，需要手动创建。
提示：如果你同时使用 Codex，可以参考 CC Switch 一键配置 CCS。
配置文件路径
~/.config/opencode/opencode.json
opencode.json
把 sk-xxxx 替换成你在 521code 控制台创建的真实 API Key。模型和参数可按需调整。
{
"provider": {
"openai": {
"options": {
"baseURL": "https://us.efxhp.cn/v1",
"apiKey": "sk-xxxx"
},
"models": {
"gpt-5.3-codex": {
"name": "GPT-5.3 Codex",
"limit": {
"context": 400000,
"output": 128000
},
"options": {
"store": false
},
"variants": {
"low": {},
"medium": {},
"high": {},
"xhigh": {}
}
},
"gpt-5.4": {
"name": "GPT-5.4",
"limit": {
"context": 1050000,
"output": 128000
},
"options": {
"store": false
},
"variants": {
"low": {},
"medium": {},
"high": {},
"xhigh": {}
}
},
"gpt-5.4-mini": {
"name": "GPT-5.4 Mini",
"limit": {
"context": 400000,
"output": 128000
},
"options": {
"store": false
},
"variants": {
"low": {},
"medium": {},
"high": {},
"xhigh": {}
}
},
"gpt-5.5": {
"name": "GPT-5.5",
"limit": {
"context": 1050000,
"output": 128000
},
"options": {
"store": false
},
"variants": {
"low": {},
"medium": {},
"high": {},
"xhigh": {}
}
}
}
}
},
"agent": {
"build": {
"options": {
"store": false
}
},
"plan": {
"options": {
"store": false
}
}
},
"$schema": "https://opencode.ai/config.json"
}
推荐模型示例
gpt-5.4（默认推荐）
质量和速度比较均衡，适合大多数编程任务。
gpt-5.5
需要更强质量可以改成这个。
gpt-5.3-codex
偏编程任务可以优先使用这个。
gpt-5.4-mini
需要更省额度时可以改成这个。
验证方式
配置完成后，验证连通性：
opencode
# 在对话中输入：你好，请确认连接正常
如果 OpenCode 正常回复，说明 521code 接入成功。
常见问题
- 提示 API Key 无效：确认 Key 格式正确，为
sk-开头，且在 521code 控制台已创建。 - 提示模型不存在：确认模型名称属于 521code 当前可用模型列表。
- 连接超时：检查网络状况，确认
https://us.efxhp.cn/v1可访问。 - 配置文件位置：OpenCode 配置文件通常在
~/.config/opencode/目录。 - Base URL 注意：OpenAI 兼容接口使用
/v1路径，不要漏掉。