配合 Cline / Roo Code 使用

两者都是 VS Code 里的编码代理，配置方式基本一致：选 OpenAI Compatible，填 Base URL 与 Key。关键在于选对支持工具调用的模型。

编码代理高度依赖 工具调用。选模型时先在模型目录确认它标注了 Tools 能力，否则代理会一直卡在「无法编辑文件」。

前置条件

已在控制台创建 API Key，账户余额充足。
VS Code 已安装 Cline 或 Roo Code 扩展。

配置步骤

打开扩展面板右上角的设置。
API Provider 选择 OpenAI Compatible。不要选 Anthropic 或 OpenAI 官方选项，那两个会走各自的固定域名。
Base URL 填 https://chuanapi.com/v1。
API Key 填万川 Key。
Model ID 手动填入目录中的真实 id。这两个扩展通常不会自动拉取列表。
如果设置里有 Function Calling 或 Tool Use 开关，保持开启。

验证工具调用

光验证「能对话」不够，编码代理真正依赖的是工具调用。下面这条请求带了一个空工具，能确认该模型在万川这边确实接受 tools 参数：

curl https://chuanapi.com/v1/chat/completions \
  -H "Authorization: Bearer $WANCHUAN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "MODEL_ID",
    "messages": [{"role": "user", "content": "你好"}],
    "tools": [{
      "type": "function",
      "function": {
        "name": "ping",
        "description": "connectivity probe",
        "parameters": {"type": "object", "properties": {}}
      }
    }]
  }'

返回 200 说明链路通。若返回 400 且提示不支持 tools，就换一个在目录中标注了 Tools 的模型。

常见问题

代理不会改文件，只会聊天：模型不支持工具调用，或扩展里的工具开关被关掉了。先按上面的 curl 验证。
404：Base URL 漏了 /v1，或 model id 拼错。
429 频繁出现：编码代理会在一次任务里连续发很多请求，容易撞限流。降低并发或换用限额更宽的分组。
费用比预期高：这类代理每一步都会把完整上下文重发一遍。开启缓存能显著降本，计费口径见计费说明。

前置条件

配置步骤

验证工具调用

常见问题

相关文档