主题
Cline 配置教程
本页以 Cline 的 VS Code 扩展版为主。不同版本的菜单名称可能略有不同，请以当前客户端界面为准。
1. 这是什么工具
Cline 是一个能在代码编辑器中阅读文件、解释代码、提出修改并运行命令的 AI 编程助手。它会在 VS Code 侧边栏显示聊天和操作记录。
Cline 当前也提供 JetBrains、CLI 等其他形态，但本教程只讲最适合小白跟随的 VS Code 扩展版。
2. 适合什么用户
适合希望在 VS Code 中让 AI 帮助理解、创建或修改项目文件的用户。第一次使用时建议只打开一个测试文件夹，并保持“每次操作询问确认”，不要直接开启全部自动批准。
3. 开始前准备
准备以下内容：
| 配置项 | 应填写的内容 |
|---|---|
| Base URL | https://api.aruhub.com/v1 |
| API Key | 登录 AruHub 后，在“我的密钥”页面创建；示例只使用 sk-xxxxxxxx |
| Model ID | 从 AruHub 模型价格页、Cline 实际加载出的模型列表或 AruHub /v1/models 返回结果确认 |
API Key 相当于账户密码，不要发给其他人，不要上传到 GitHub、网盘、截图或公开聊天。
Base URL 通常填写到 /v1 为止。不要填写 https://api.aruhub.com/v1/v1，也不要把 https://api.aruhub.com/v1/chat/completions 当成 Base URL。
4. 安装或打开工具
安装 VS Code
- 打开 VS Code 官方网站，下载与你的 Windows、macOS 或 Linux 对应的安装包。
- 按安装向导完成安装。
- 打开 VS Code，看到欢迎页即可。
安装 Cline 扩展
- 点击 VS Code 左侧活动栏中的 Extensions（扩展） 图标，或按
Ctrl+Shift+X；macOS 可按Cmd+Shift+X。 - 在搜索框输入
Cline。 - 选择发布者为 Cline/官方条目的 Cline 扩展，点击 Install（安装）。
- 安装结束后点击左侧活动栏的 Cline 图标。
- 如果图标没有出现，重启 VS Code；也可打开命令面板，输入
Cline: Open In New Tab。
5. 创建 AruHub API Key
- 在浏览器登录 AruHub。
- 打开“我的密钥”。
- 点击创建密钥并填写便于识别的名称。
- 复制 Key，保存到自己的密码管理器。
- 本页只用
sk-xxxxxxxx表示 Key；实际粘贴时替换，不要公开完整值。
Cline 登录、ChatGPT 登录和 AruHub API Key 是不同的凭证。
6. 配置 Base URL
- 打开 Cline 面板。
- 点击 Cline 面板中的齿轮图标，进入 Cline Settings。
- 找到 API Provider 下拉菜单。
- 选择 OpenAI Compatible。
- 在 Base URL 输入：
text
https://api.aruhub.com/v1这里的 Base URL 是接口根地址。不要多写 /v1，不要少写 /v1，也不要填完整的 /chat/completions 请求地址。
7. 填写 API Key
在同一设置页的 API Key 输入框中粘贴你的真实 AruHub Key：
text
sk-xxxxxxxxsk-xxxxxxxx 只是占位示例。粘贴真实 Key 后检查前后没有空格。不要勾选 Azure 身份验证，因为本教程使用 AruHub API Key。
8. 填写或选择模型
- 从 AruHub 模型价格页、Cline 实际模型列表或
/v1/models返回结果复制准确 Model ID。 - 在 Model 或 Model ID 输入框粘贴该 ID。
- 不要使用页面展示名称猜测 ID。
- 首次测试先保持高级 Model Configuration 为默认值，除非准确知道上下文、输出长度和工具能力。
- 若模型不支持 Cline 所需的工具调用或所用接口类型，即使 ID 存在也可能无法执行任务。
示意占位值：
text
replace-with-model-id实际配置必须替换，不能直接保存占位符。
9. 保存配置
- 再次检查 API Provider 是 OpenAI Compatible。
- 检查 Base URL、API Key、Model ID。
- 点击 Verify 验证连接。
- 验证通过后，按当前界面的 Done、Save 或返回按钮保存。
- 回到 Cline 聊天面板，顶部应显示刚选择的 Provider 或模型。
若 Verify 失败，先阅读错误正文，不要连续点击。
10. 发起第一次测试
先创建测试文件夹：
- 在电脑上新建一个空文件夹，例如
cline-test。 - VS Code 点击 File → Open Folder，选择该文件夹。
- 若 VS Code 询问信任此文件夹，只在这是你自己创建的空文件夹时选择信任。
- 打开 Cline 面板，输入低风险任务：
text
请查看当前空文件夹，只告诉我里面有多少个文件。不要创建、修改、删除文件，也不要运行终端命令。如果 Cline 提出读取文件，确认范围是测试文件夹后再批准。第一次测试不要要求安装依赖、部署或连接数据库。
11. 如何确认配置成功
满足以下现象说明基本连接成功：
- Verify 通过，或测试消息收到模型回复。
- Cline 顶部显示的是 OpenAI Compatible 和你填写的模型。
- AruHub 用量记录出现相近时间、相同模型的请求。
- 没有 401、404、429 或连接错误。
查看请求错误时，展开 Cline 聊天中的失败卡片或错误详情，记录状态码、时间、模型 ID 和已遮盖的错误正文。不要复制完整 API Key。
12. 常见问题
找不到 OpenAI Compatible
先确认安装的是当前官方 Cline 扩展。点击齿轮进入 API Provider，而不是只看登录页。更新或重启扩展后再找；不同版本入口位置可能略有不同。
Base URL 填成完整接口地址
Cline 的 Base URL 应为 https://api.aruhub.com/v1，不要填 /chat/completions。完整接口地址由客户端自动拼接。
Base URL 重复 /v1
看到 https://api.aruhub.com/v1/v1 时删除一段 /v1，保存后重新 Verify。
API Key 无效或出现 401
重新从“我的密钥”复制，检查前后空格、是否过期或禁用。不要把 Key 发给客服；只提供遮盖后的末几位。
Model ID 填错或出现 404
不要用展示名称。重新从价格页、客户端实际列表或 /v1/models 复制准确 ID，并确认模型支持 Cline 使用的接口类型。
出现 429
降低请求频率，检查余额和用量记录，等待后再试。不要无间隔循环重试。
请求一直等待
先停止当前任务，检查网络、客户端超时、模型响应时间和 AruHub 用量记录。已经产生输出或记录时，不要立即重复提交相同任务。
Cline 能打开但无法执行任务
扩展能打开只说明界面正常。继续检查 Provider、Base URL、Key、Model ID、工作区信任状态，以及模型是否支持工具调用。
自动批准权限的安全风险
Cline 的 Auto Approve 可分别允许读取、编辑和运行命令；YOLO Mode 会自动批准所有操作。小白首次使用不要直接开启全部自动批准或 YOLO Mode。建议只允许读取项目文件，编辑、终端命令、浏览器和 MCP 保持询问确认。
执行删除文件、部署、数据库操作前必须人工确认。即使 Cline 将某条命令标记为安全，也要阅读完整命令和目标路径。
13. 如何重置或修改配置
- 切换模型：打开 Cline Settings，在 Model/Model ID 中更换，点击 Verify 后保存。
- 修改 Provider：在 API Provider 中重新选择 OpenAI Compatible，再核对三项基础值。
- 修改 Key：替换 API Key，确认没有空格，重新 Verify。
- 重置错误地址：把 Base URL 恢复为
https://api.aruhub.com/v1。 - 设置仍不生效时：关闭并重新打开 Cline 面板，必要时执行 VS Code 的 Reload Window，然后再次检查。
14. 安全注意事项
- API Key 相当于账户密码，不要发给其他人。
- 不要把 Key 上传到 GitHub、网盘、截图或公开聊天。
- 新手不要开启全部 Auto Approve 或 YOLO Mode。
- 删除文件、部署、数据库和系统设置操作必须人工确认。
- 首次测试使用空文件夹和只读任务；确认配置后再逐步增加权限。