3.7 Claude Code 常见问题与排查(FAQ)

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
喜欢就支持一下吧
点赞9 分享
评论 抢沙发
头像-大赛人网
欢迎您留下宝贵的见解!
提交
头像-大赛人网

昵称

取消
昵称

    请登录后查看评论内容