故障排查
适用对象：通用 ｜ 状态：✅ 已完成 ｜ 更新于：2026-06-01
工具用不起来时，按下面的”现象 → 原因 → 解决”对号入座。八成的问题，答案是：重开终端，再确认 Key。
| 现象 | 最可能的原因 | 怎么解决 |
|---|---|---|
输入 claude / codex 提示”command not found / 找不到命令” | 安装改的配置还没在当前窗口生效 | 关掉终端，重新开一个新窗口 |
| 能进去，但一对话就鉴权失败 / 401 / Unauthorized | Key 填错了，或余额不足 | 确认 Key 是真实的、没多空格；登录 DeepSeek 看余额 |
| Codex 报错连不上 / Base URL 不对 | Base URL 末尾多加了 /v1 | Base URL 用 https://api.deepseek.com，末尾不要加 /v1 |
| Windows 提示”在此系统上禁止运行脚本” | PowerShell 默认禁止脚本 | 先运行解锁命令（见下），再重跑安装 |
| 装到一半断了 / 报错了 | 网络波动等 | 重跑同一条安装命令即可（幂等，已装的会跳过） |
| AI 画的图中文显示成方块 / 乱码 | 缺中文字体配置 | 让它用配好中文字体的可视化技能（见下） |
1. 找不到命令（command not found）
Section titled “1. 找不到命令（command not found）”安装会修改一些配置，这些配置只对新开的终端窗口生效。
解决：关掉刚才那个终端 / PowerShell 窗口，重新打开一个新的，再输入 claude。这一步几乎能解决所有”明明装了却说找不到命令”的问题。
2. 鉴权失败 / 401 / Unauthorized
Section titled “2. 鉴权失败 / 401 / Unauthorized”进得去，但一对话就报权限错，两个原因最常见：
- Key 填错了——确认你的 Key 是从 DeepSeek 复制的真实 Key，不是占位符、前后没多空格。配置位置见工具板块。
- 余额不足——登录 DeepSeek 平台看看是不是没钱了，充一点即可。
3. Codex 连不上 / Base URL 不对
Section titled “3. Codex 连不上 / Base URL 不对”Codex 的端点必须是 https://api.deepseek.com。
4. Windows 脚本被禁止运行
Section titled “4. Windows 脚本被禁止运行”Windows 提示”无法加载脚本，因为在此系统上禁止运行脚本”时，先在 PowerShell 里运行这条解锁命令（只对当前这个窗口有效，安全）：
Set-ExecutionPolicy -Scope Process Bypass然后再重新跑安装命令。
5. 安装中断 / 报错了
Section titled “5. 安装中断 / 报错了”不用重头来。直接重新运行同一条安装命令即可。脚本是”幂等”的——已经装好的自动跳过，只补没装上的部分。
6. 中文图表乱码 / 负号变方块
Section titled “6. 中文图表乱码 / 负号变方块”让 AI 画图时，中文标题、坐标轴显示成方块，是因为默认没配中文字体。
解决：让它用本站工具包里配好中文字体的可视化技能（data-viz-econ）来出图，它已经处理好了中文乱码、负号方块、字号、灰度打印、PDF/300dpi 导出等问题。用中文说”用 data-viz-econ 帮我画……”即可。