配置检查清单

工具配置失败时，不要马上重装。先按这份清单检查，通常能快速定位问题。

一、配置前检查

基础环境

node -v
npm -v
git --version

检查结果：

• node -v 能显示版本号
• npm -v 能显示版本号
• git --version 能显示版本号

如果某个命令找不到，先看 使用前环境配置。

账号与密钥

确认：

• 已登录 coding-play.codes
• 账户有余额
• 已创建 API Key
• API Key 没有多复制空格
• 每个工具尽量使用单独的 API Key

接口与模型

确认：

• Base URL 来自后台或服务商说明
• 模型名称和后台完全一致
• 工具里选择的 Provider 是正确的
• 当前工具支持自定义接口

二、配置中检查

填写配置时重点看：

字段	检查点
API Key	是否完整复制
Base URL	是否包含正确协议和路径
Model	是否使用真实模型 ID
Provider	是否选择 OpenAI Compatible 或对应服务商
Permission	是否允许读取/修改文件

三、配置后检查

1. 命令能否运行

工具命令 --version

例如：

claude --version
openclaw --version
hermes --version

2. 能否回复测试问题

你好，请用一句话介绍你当前使用的模型。

3. 能否读取项目

请阅读当前项目，不要修改文件，告诉我项目技术栈和启动命令。

4. 项目是否能构建

npm run build

四、如果失败，怎么问 AI

我正在配置 AI 工具，配置后调用失败。请按检查清单帮我定位问题。

系统：
Windows / macOS / Linux

工具：
粘贴工具名称

配置项：
API Key 已填写
Base URL：粘贴但不要粘贴密钥
Model：粘贴模型名

报错：
粘贴完整报错

不要粘贴真实 API Key

让 AI 排查时，可以说“API Key 已填写”，不要把完整密钥发出来。