跳至主要內容

Claude Code 常见问题

HuiLiu Team大约 2 分钟常见问题

Claude Code 常见问题

安装相关

Q: npm install -g @anthropic-ai/claude-code 失败

可能原因：

  1. Node.js 版本过低（需要 >= v18）
  2. 网络问题，npm 源不通
  3. 权限问题

解决：

# 1. 检查版本
node -v

# 2. 切换国内镜像
npm config set registry https://registry.npmmirror.com

# 3. macOS / Linux 加 sudo
sudo npm install -g @anthropic-ai/claude-code

# 4. Windows 使用管理员权限的 PowerShell

Q: Windows PowerShell 提示"无法加载文件，因为在此系统上禁止运行脚本"

解决：以管理员身份运行 PowerShell：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

输入 Y 确认。

启动相关

Q: 启动报 ANTHROPIC_AUTH_TOKEN is not set

环境变量未生效。

解决：

  1. 确认环境变量已设置（echo $ANTHROPIC_AUTH_TOKEN）
  2. 重启终端（环境变量需要新窗口才生效）
  3. Windows 用户使用 setx 而非 set

Q: 启动报 Connection refused / ECONNREFUSED

检查 ANTHROPIC_BASE_URL 是否正确：

  • ✅ https://www.huiliuapi.com（没有 /v1 后缀）
  • ❌ https://www.huiliuapi.com/v1

Claude Code 走 Anthropic 原生接口，不需要 /v1。

调用相关

Q: 报 401 Unauthorized

  • 令牌错误：重新复制 sk- 开头的完整令牌
  • 分组错误：令牌必须选 Claude Code 分组
  • 令牌过期 / 被禁：到控制台检查状态

Q: 报 404 Not Found

base_url 配错。Claude Code 使用 Anthropic 原生接口，必须是：

ANTHROPIC_BASE_URL=https://www.huiliuapi.com

Q: 报 model_not_found: claude-xxx

当前分组没有这个模型。

解决：

  1. 输入 /model，从下拉列表选择可用模型
  2. 推荐 claude-sonnet-4-20250514

Q: 工具调用一直失败 / Read 文件失败

通常是网络抖动或缓存问题。

解决：

/clear

清空上下文后重试。

Q: 消费比预期高

  • Claude Code 会自动开启 prompt 缓存，长上下文反复对话会产生缓存读取费用
  • 使用 /cost 查看本次会话明细
  • 控制台"日志查询"查看每次调用的具体扣费

高级用法

Q: 如何在多个项目用不同账号？

在每个项目根目录创建 .claude/settings.json，会覆盖全局环境变量。

Q: 能在 VSCode 里用吗？

可以。Claude Code 提供 VSCode 扩展，配置与命令行版本共享。

Q: 支持 Plan Mode 吗？

支持。Shift + Tab 切换到 Plan Mode，会先生成计划再执行。

参考资料