客户端接入 · Cline

Cline 接入 HardysAPI:OpenAI Compatible 三件套

Cline 是 VS Code 里的自主编码代理,配置项只有 Base URL、API Key、Model ID 三个。这类代理单次任务消耗 token 较多,选型上要优先看单价而不是最强模型。

先准备两样东西:在 控制台 创建 API 密钥(复制 sk- 开头的完整字符串), 以及要用的模型名(从 模型价格 里挑,名字要一字不差)。

配置步骤

  1. 在 VS Code 侧边栏打开 Cline,点齿轮进入 Settings;
  2. API Provider 选 OpenAI Compatible;
  3. Base URL 填 https://hardysapi.com/v1;
  4. API Key 粘贴 sk-...;
  5. Model ID 填模型名,例如 claude-sonnet-4-5;
  6. 点 Done 保存,发一句「列出当前目录结构」验证。

模型怎么选

Cline 的工作模式是「读文件 → 改文件 → 跑命令」多轮循环,一次任务轻松跑到几十万 token。 按经验:

  • 日常改代码:中型模型(如 claude-sonnet-4-5、gpt-5.5)性价比最好;
  • 复杂重构:换顶配模型(claude-opus-4-5)但把任务拆小;
  • 批量小改动:用低价分组里的 deepseek-v4-pro、qwen-max 之类的模型,价格能差一个数量级。

同一个模型在不同分组单价不同,具体差价看 模型页 的分组价格表。

常见坑

  • Base URL 结尾带不带 /v1:Cline 的 OpenAI Compatible 有单独的「Base URL」字段,填 https://hardysapi.com/v1;如果它提示 /v1/v1,说明该版本会自动补,去掉结尾即可。
  • 400 参数错误:Cline 会发送工具调用(tool_calls)参数,部分低价模型的兼容层不支持,换一个模型验证。
  • 任务中断后余额骤降:代理会把长文件反复塞进上下文,注意在设置里限制「最大请求数」。

验证

带工具调用的最小请求bash
curl https://hardysapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-你的密钥" \
  -H "Content-Type: application/json" \
  -d '{"model":"claude-sonnet-4-5","messages":[{"role":"user","content":"hi"}],"max_tokens":64}'

能返回就说明链路通;仍然失败时看 报错排查。

常见问题

Cline 用的 Base URL 要写成什么?

https://hardysapi.com/v1,Model ID 填完整模型名。若出现 /v1/v1 报错,去掉结尾的 /v1。

Cline 支持 Claude 吗?需要配 Anthropic 格式吗?

支持,且不需要。Cline 走 OpenAI Compatible 就能调用 Claude 系列模型,模型名填 claude-sonnet-4-5 即可。

Cline 一次任务大概花多少钱?

取决于模型与文件规模。低价分组里跑一次日常任务是几分钱量级,顶配模型跑大型重构可能到几元,具体以控制台的用量记录为准。