Claude Code 学习站
v2.1.148

FAQ / 问题排查

按主题分组的常见问题速查。如果你的问题没在这里,欢迎提 issue。

安装问题

npm install -g 报 EACCES 权限错误?

不要 sudo。改 npm 全局目录到家目录:

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.zshrc
source ~/.zshrc
npm install -g @anthropic-ai/claude-code

claude: command not found(装完之后)

PATH 没生效。检查:

npm config get prefix
# 比如输出 /home/you/.npm-global
ls /home/you/.npm-global/bin/claude

把那个 bin 加到 PATH,重启终端。

Node 版本太低

node --version
# 低于 v18 就升级

推荐用 nvm 或 fnm 装 Node 20+ LTS。

登录与鉴权

OAuth 在服务器(没有浏览器)上跑不通

切到 API Key 模式:

export ANTHROPIC_API_KEY=sk-ant-xxx
claude

也可以写进 ~/.zshrc 或者用 .env 工具加载。

用了订阅但还是计费?

检查当前账号:

> /login

会显示当前登录身份。如果有 ANTHROPIC_API_KEY 环境变量,Claude 会优先用 API Key —— 临时 unset ANTHROPIC_API_KEY 再启动。

怎么切换账号?

> /logout

之后重新 claude 会重新走登录流程。

权限与工具

每次工具调用都问我,太烦

在 ~/.claude/settings.json 或项目 .claude/settings.json 里 allow 常用工具:

{
  "permissions": {
    "allow": [
      "Read(**)",
      "Grep(**)",
      "Glob(**)",
      "Bash(npm test:*)",
      "Bash(git status:*)"
    ]
  }
}

模式参考 docs.claude.com。

怎么知道 Claude 用了哪些工具?

启动加 --verbose,或者会话中说 /transcript 查看完整日志。

怎么阻止 Claude 跑某些命令?

用 PreToolUse hook(详见 Hooks),命令匹配后退出码 2 即可阻止。

网络与代理

中国大陆访问慢 / 失败

为 Node 设置代理:

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890
claude

把它写进 ~/.zshrc 一劳永逸。

用第三方网关(中转)

把 base URL 改到中转:

export ANTHROPIC_BASE_URL=https://your-gateway.example.com
export ANTHROPIC_API_KEY=sk-your-relay-key

注意要确认中转方支持 Claude Code 的完整 API(messages、streaming、tools、cache_control)。

性能 / 上下文

上下文用得很快怎么办?

  • 用 agent 做长任务,主上下文只拿结论(参考 子代理)
  • 大文件用 Read offset/limit 分段读,不要一次性塞
  • 定期 /clear 清掉无关的早期消息
  • 在 CLAUDE.md 写清楚项目结构,减少 Claude 探索成本

响应慢

检查:

  1. 网络延迟(curl -w '%{time_total}\n' https://api.anthropic.com 看 RTT)
  2. 上下文长度 —— 越长越慢,考虑 /clear 或开新会话
  3. Bash 命令本身慢(测试、build),用 run_in_background 异步跑

Token 用量怎么看?

> /usage

显示当前会话和今日累计的 token 用量。

回到 首页 →