3.7.1 安装类问题
Q1:安装时报 ENOENT: no such file or directory
- 原因:npm 缓存损坏
- 解决:运行
npm cache clean --force,然后重新安装
Q2:安装成功但 claude 命令找不到
- 原因:npm 全局安装路径未加入系统 PATH
- 解决:运行
npm config get prefix,将输出的路径加入系统 PATH 环境变量
Q3:Windows 上报”无法加载文件,因为在此系统上禁止运行脚本”
- 原因:PowerShell 执行策略限制
- 解决:以管理员身份打开 PowerShell,运行
Set-ExecutionPolicy RemoteSigned
3.7.2 连接/API 类问题
Q4:启动后提示 Invalid API Key
- 原因:API Key 配置错误或过期
- 解决:检查环境变量
ANTHROPIC_API_KEY是否正确设置。用echo $ANTHROPIC_API_KEY(macOS)或echo $env:ANTHROPIC_API_KEY(PowerShell)验证
Q5:中转服务配置后连接超时
- 原因:中转服务地址错误或服务不可用
- 解决:1. 检查
ANTHROPIC_BASE_URL是否正确 2. 用浏览器访问中转服务网站确认其正常运行 3. 尝试用 curl 直接测试API连通性
Q6:提示 Rate limit exceeded
- 原因:短时间内发送了太多请求
- 解决:等待 1 分钟后重试。如果频繁出现,考虑升级 API 套餐
3.7.3 使用类问题
Q7:AI 修改了不该改的文件
- 原因:需求描述不够明确,AI自行判断需要修改
- 解决:1. 用
git checkout .撤销修改 2. 重新描述需求,明确指定”只修改 xxx 文件” 3. 在 CLAUDE.md 中注明”不要修改的文件”
Q8:AI 陷入”改A坏B、改B坏A”的循环
- 原因:AI缺乏全局视角,修复一个问题引入新问题
- 解决:1. 用
git checkout .回退到稳定版本 2. 用/clear清空对话 3. 重新描述完整的需求,让 AI 一次性考虑所有约束
Q9:对话太长后 AI 开始”遗忘”早期内容
- 原因:上下文窗口接近满载
- 解决:使用
/compact压缩上下文,或开新会话
Q10:AI 生成了一个不存在的npm包或API
- 原因:AI “幻觉”(编造不存在的东西)
- 解决:在使用 AI 推荐的包之前,先到 npmjs.com 搜索确认它是否存在
3.7.4 费用类问题
Q11:感觉费用消耗太快
- 原因:可能在使用 Opus 模型或对话过长
- 解决:1. 用
/cost查看当前费用 2. 切换到更便宜的模型 3. 减少不必要的对话轮次 4. 在 Anthropic Console 设置月度预算限额
Q12:中转服务的费用如何计算
- 说明:中转服务通常按 Token 数量计费,价格 = 官方价格 × 倍率。不同中转服务倍率不同(1.0x-1.5x),请查看你使用的中转服务的价格页面
3.8 自定义斜杠命令(Custom Slash Commands)
你可以创建自己的斜杠命令,将常用操作封装成快捷方式。
在项目根目录创建 .claude/commands/ 目录,然后添加 Markdown 文件:
<!-- .claude/commands/deploy.md -->
# 部署检查清单
请执行以下部署前检查:
1. 运行所有测试:npm test
2. 检查是否有 lint 错误:npm run lint
3. 确认 .env.example 已更新(如果添加了新的环境变量)
4. 构建项目:npm run build
5. 报告所有检查结果
使用方式:
> /deploy
Claude Code 就会按照你定义的步骤执行部署检查。
© 版权声明
文章版权归作者所有,未经允许请勿转载。
THE END














请登录后查看评论内容