OpenCode - CPA - OneAPI

昨晚开始开始入手 OpenCode ，整理了一份从零开始的安装与配置笔记，分享给各位佬友。

第一阶段：基础安装与核心插件

1. 安装 OpenCode

推荐使用 brew 安装，稳定性更高：

• macOS/Linux: brew install anomalyco/tap/opencode
• Node 环境: npm i -g opencode-ai

2. 必装 “全家桶” 插件

安装完成后先输入 opencode 启动（能白嫖 GLM4.7），然后在会话中直接粘贴以下链接安装 oh-my-opencode：

Install and configure by following the instructions here https://raw.githubusercontent.com/code-yeongyu/oh-my-opencode/refs/heads/master/README.md

进阶推荐：

• opencode-dcp: 自动清理对话历史中过时的工具输出，显著减少 Token 消耗。

第二阶段：进阶配置（接入 OneAPI / 中转站）

由于 OpenCode CLI 执行任务时会有大量 Tool Use 调用，普通 URL 转发容易协议报错。这里推荐使用 CLIProxyAPI (CPA) 进行协议转换。

1. 部署 CPA 环境

建议直接走 Source Build，日志更透明：

git clone https://github.com/router-for-me/CLIProxyAPI.git
cd CLIProxyAPI
go mod download
go run main.go # 启动 

2. CPA 核心配置 (config.yaml)

坑点： 字段名必须准确，否则会静默失败。

• 确保使用 auth-dir 而不是旧版的 credentials-directory。
• 供应商字段是 openai-api-keys（复数，带 s）。

port: 8317 auth-dir: "/绝对路径/auth" allow-unauthenticated: true # 本地调试建议开启 openai-api-keys: - api-key: "sk-OneAPI令牌" base-url: "https://OneAPI地址/v1" models: - id: "claude-opus-4-5" # OpenCode 中显示的名称 map-to: "claude-opus-4-5-20251101" # OneAPI 后台真实 ID 

第三阶段：OpenCode 配置文件打通

修改 ~/.config/opencode/opencode.json。因为 CPA 侧开了免密，这里直接配置 Provider 即可：

{
  "$schema": "https://opencode.ai/config.json",
  "plugin": [
    "oh-my-opencode",
    "@tarquinen/opencode-dcp@latest"
  ],
  "provider": {
    "anthropic": {
      "options": {
        "baseURL": "http://127.0.0.1:8317/v1"
      }
    }
  }
}

踩坑

1. 代理污染（502 报错）：如果终端开了 http_proxy，请求 localhost 可能会被劫持导致失败。执行前记得：unset http_proxy https_proxy all_proxy 或者使用 curl -v --noproxy “*” http://127.0.0.1:8317/v1/models 测试连通性。
2. Thinking 模式没显示？：按 Ctrl + P，搜索 think 即可手动开启或关闭思维链显示。
3. YAML 解析失败：Go 解析路径时对～/ 支持不佳，建议在 config.yaml 中全部使用绝对路径。

管理端 UI