Appearance
Claude Code 常见问题
本页面解答使用 Claude Code CLI 时的常见问题。
安装问题
Q: 提示 Node.js 版本过低怎么办?
A: Claude Code 需要 Node.js 18 或更高版本。
解决方案:
- 访问 nodejs.org 下载最新 LTS 版本
- 安装后验证:
node --version - 重新安装 Claude Code
Q: npm install 提示权限错误?
A: 使用 sudo(不推荐)或配置 npm 用户目录:
bash
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc配置问题
Q: 环境变量配置后不生效?
A:
- 确认修改了正确的配置文件(
~/.bashrc或~/.zshrc) - 重新加载配置:
source ~/.bashrc - 或关闭终端重新打开
Q: Windows 如何设置环境变量?
A:
临时设置(PowerShell):
powershell
$env:ANTHROPIC_API_KEY = "sk-xxx"
$env:ANTHROPIC_BASE_URL = "https://us.myy9.com/"永久设置:
- 右键"此电脑" → 属性
- 高级系统设置 → 环境变量
- 在用户变量中新建两个变量
使用问题
Q: 提示 API Key 无效?
A: 检查:
- API Key 是否完整复制(包括
sk-前缀) - 在 MYY 中转站控制台确认令牌状态为"启用"
- Base URL 是否正确(末尾要有
/v1)
Q: 响应很慢或超时?
A:
- 检查网络连接
- 尝试切换到更快的模型(如
claude-3-haiku) - 检查 MYY 中转站是否正常
- 查看日志确认请求是否到达服务器
Q: 如何指定使用的模型?
A:
方式 1:命令行参数
bash
claude --model gpt-4 "你的问题"方式 2:环境变量
bash
export ANTHROPIC_MODEL="claude-3-5-sonnet-20241022"方式 3:配置文件 在 ~/.config/claude/config.json 中:
json
{
"model": "claude-3-5-sonnet-20241022"
}Q: 如何查看 Claude Code 的日志?
A:
bash
claude --debug "你的问题"或查看配置:
bash
claude --configQ: 交互模式如何退出?
A:
- 输入
exit或quit - 按
Ctrl + D - 按
Ctrl + C
功能问题
Q: 如何让 Claude 读取文件?
A: 直接在提问中提到文件路径:
bash
claude "审查 src/main.py 的代码质量"Claude 会自动读取文件内容。
Q: 可以让 Claude 写入文件吗?
A: 可以,在提问中明确指定:
bash
claude "将优化后的代码写入 src/main_new.py"Q: 如何保持对话上下文?
A: 使用交互模式:
bash
claude在交互模式中,对话会保持上下文,直到退出。
费用问题
Q: Claude Code 会很贵吗?
A: 费用取决于:
- 使用频率
- 选择的模型
- 输入输出的长度
节省费用的建议:
- 简单问题用便宜的模型(如
gpt-3.5-turbo) - 提供清晰的问题,减少来回对话
- 避免让 AI 生成过长的输出
Q: 如何查看使用量?
A:
- 登录 MYY 中转站控制台
- 进入"日志管理"
- 筛选 Claude Code 对应的令牌
- 查看详细统计