🚀 Cline 接入 CodingPlanX 自定义模型
> 摘要：本文档将指导你如何在 VS Code 中通过 Cline 扩展，配置并使用 CodingPlanX.ai 提供的 API，以最高效、低成本的方式体验 Claude 系列模型。
Cline 是一款备受欢迎的 VS Code AI 编程扩展（拥有 500 万+ 安装量），它支持任意 AI 模型和自定义 API 端点。通过 Cline 配合 CodingPlanX.ai API，你可以在熟悉的 IDE 中无缝使用强大的 Claude 模型。
🌟 为什么选择 Cline？
- 💰 零加价：Cline 本身完全免费，不对模型费用加价，你只需支付 CodingPlanX.ai 的基础 API 费用。
- 🔄 多模型灵活切换：在同一个界面中，可随时无缝切换 Claude、GPT、Gemini 等不同模型。
- 🛠️ VS Code 深度集成：提供侧边栏面板，支持内联代码操作、终端命令执行以及文件编辑差异（Diff）预览。
- 📖 完全开源：代码透明安全，社区活跃，迭代更新快。
- ⚡ CLI 2.0 支持：支持终端模式和并行代理（Agent）能力。
⚙️ 安装与配置指南
步骤 1：安装 Cline 扩展
在 VS Code 中完成以下操作：
- 打开左侧的扩展面板（快捷键：
Ctrl+Shift+X/ macOS 为Cmd+Shift+X）。 - 在搜索框中输入
Cline。 - 找到官方插件（作者为 Cline Bot），点击 安装 (Install)。
(此处可添加一张 VS Code 扩展商店搜索 Cline 的截图)
步骤 2：配置 CodingPlanX.ai API
> ⚠️ 关键提示：虽然我们使用的是 Claude 模型，但由于 CodingPlanX.ai 提供了标准化的接口，请务必在供应商中选择 OpenAI Compatible。
- 安装完成后，点击 VS Code 左侧边栏新出现的 Cline 图标。
- 点击设置（齿轮图标），在 API Provider 下拉菜单中选择
OpenAI Compatible。 - 按照下表精准填入配置信息：
| 配置项 (Field) | 填写值 (Value) | 说明 |
|---|---|---|
| Base URL | https://api.codingplanx.ai/v1 | 默认使用亚太主节点 |
| API Key | cr_... | 填入你的 CodingPlanX.ai API 密钥（通常以 cr_ 开头） |
| Model ID | claude-sonnet-4-6 | 推荐使用，兼顾速度与智能。也可填入其他模型 ID |
(此处可添加一张 Cline 设置面板填好上述参数的截图)
步骤 3：验证连接
配置完成后，回到 Cline 的聊天界面，输入一条简单的消息（例如："Hello，请做个自我介绍"）。
如果能迅速收到 AI 的回复，恭喜你，配置已成功完成！🎉
💡 进阶使用技巧
1. 模型选择建议
CodingPlanX.ai 提供了多种 Claude 模型，建议根据当前任务的复杂度选择，以达到效能与成本的最优解：
| 任务场景 | 推荐 Model ID 填写值 | 特点说明 |
|---|---|---|
| 日常编码/代码补全 | claude-sonnet-4-6 | ⚡ 速度快、性价比极高（最推荐） |
| 复杂架构/疑难Bug排查 | claude-opus-4-6 | 🧠 最强推理能力，适合攻坚难题 |
| 轻量任务/文本处理 | claude-haiku-4-5-20251001 | 💸 费用最低，响应极速 |
2. 与 Claude Code CLI 的黄金搭档
Cline （图形界面）和 Claude Code CLI （命令行）各有千秋，强烈建议两者配合使用：
| 适用场景 | 推荐使用的工具 |
|---|---|
| VS Code 内沉浸式开发、单文件快速编辑 | 🎨 Cline |
| 跨文件重构、选中代码块解释 | 🎨 Cline |
| 深入的全局项目级分析 | 💻 Claude Code CLI |
| Git 批量操作、全局代码审查 (Code Review) | 💻 Claude Code CLI |
| CI/CD 自动化流水线集成 | 💻 Claude Code CLI (Headless 模式) |
❓ 常见问题 (FAQ)
Q：发送消息后提示连接失败或超时？
- 排查 1：请仔细检查 Base URL，确保末尾没有多余的斜杠
/。 - 排查 2：确认 API 密钥复制完整，没有多余的空格。
- 排查 3：尝试将 Base URL 替换为上文提供的【备用节点】IP 地址。
- 排查 4：检查你当前的网络环境是否拦截了对
CodingPlanX.ai域名的访问。
Q：配置好后，Model ID 下拉列表是空的？
- 解答：这是正常现象。由于使用的是兼容接口，Cline 无法自动拉取模型列表。你只需要将模型名称（如
claude-sonnet-4-6）手动复制并粘贴到 Model ID 的输入框中即可，不需要从下拉列表中选择。