目录导航
目录导航
帮助中心
快速解决常见问题，让您的使用更加顺畅
🚨
常见错误解决方案
API Error (Request timed out.) / API Error (Connection error.)
请求超时和连接错误，通常是网络连接问题导致
✓
关掉科学上网工具，使用直连网络✓
更换科学上网节点，选择延迟较低的服务器✓
切换到手机热点网络试试✓
先在cmd/ubuntu/macos终端尝试；若终端可用但 VS Code/ Cursor 不可用，一般是 IDE 环境问题✓
等待几分钟后重新尝试🤖
模型使用说明
为什么记录里有 claude-3-5-haiku-20241022？
Claude Code 在总结上下文或请求标题时会自动调用此模型
能用 Opus 模型吗？
Opus 可用性取决于当前服务状态
⚠
高峰期或负载高时会关闭 Opus✓
其他时间一般可用ℹ
官方 Pro 账号没有 Opus 权限⚡
200 刀 Max 账号并发很低，难以同时处理 2 个请求❌
超过并发限制时官方会返回 invalid_modelname🔄
模型切换说明
如何切换模型？
在终端中使用斜杠命令快速切换 AI 模型
💻
在终端输入 /model 命令⚡
系统会展示可用模型列表🎯
选择合适的模型后即可开始对话🔍
API错误排查
403 Forbidden 错误
环境变量未配置或配置错误
ANTHROPIC_AUTH_TOKEN= 您的API Key
ANTHROPIC_BASE_URL= 您的API端点URL
401 Unauthorized 错误
IDE 或 MCP 修改了 settings.json 配置文件
解决方案：删除 ~/.claude/settings.json 文件
Windows: C:\Users\用户名\.claude\settings.json
macOS: ~/.claude/settings.json
请求超时 / 连接错误
网络连接问题或代理设置冲突
1
尝试关闭科学上网工具，使用直连2
更换代理节点，选择延迟较低的服务器3
切换到手机热点网络其他错误代码
400：tool_use 报错 → 重新请求，使用 ESC + continue
413：请求体过大 → 使用 /clear 清理上下文
429：请求过于频繁 → 等待几分钟后重试
500：服务端错误 → 检查 status.anthropic.com
⚙️
环境配置
Windows 配置
1. 打开环境变量设置： Win + R → sysdm.cpl → 高级 → 环境变量
2. 添加系统变量：
ANTHROPIC_AUTH_TOKEN = 您的API Key
ANTHROPIC_API_KEY = 您的API Key
ANTHROPIC_BASE_URL = 您的API端点URL
CLAUDE_CODE_MAX_OUTPUT_TOKENS = 32000
macOS / Linux 配置
添加到 ~/.zshrc 或 ~/.bashrc：
export ANTHROPIC_AUTH_TOKEN="您的API Key"
export ANTHROPIC_API_KEY="您的API Key"
export ANTHROPIC_BASE_URL="您的API端点URL"
export CLAUDE_CODE_MAX_OUTPUT_TOKENS="32000"
source ~/.zshrc
Linux 环境变量配置 (npm 路径问题)
如果 Claude Code 提示找不到 npm 命令，请按以下步骤配置：
1. 获取 npm 安装路径：
npm config get prefix
2. 将返回的路径添加到 PATH 环境变量：
例如，如果返回
/usr/local，则需要将 /usr/local/bin 添加到 PATH3. 编辑配置文件：
# 编辑配置文件
nano ~/.bashrc # 或 nano ~/.zshrc
# 添加以下内容
export PATH="/usr/local/bin:$PATH"
# 保存后重新加载
source ~/.bashrc # 或 source ~/.zshrc
4. 验证配置：
which npm
应该能正确显示 npm 的安装路径
🔄
版本更新
更新 Claude Code
Windows:
npm i -g @anthropic-ai/claude-code
claude -version
claude -version
macOS:
sudo npm i -g @anthropic-ai/claude-code
claude -version
claude -version
🚀
使用优化
提升效率的技巧
🎯
精确提问直接指定要修改的文件/函数/页面，避免全项目扫描
📝
任务分解将大需求分解为小步骤，逐步完成
🧹
上下文管理使用 /compact 命令减少上下文，提升响应速度
配额使用优化
消耗因素：
- 简单提问：3-8 个请求
- 复杂任务：请求数成倍增长
优化建议：
- 将大需求拆为小任务
- 逐步提问而非一次性大需求
自动执行模式
跳过权限检查，自动执行操作
claude --dangerously-skip-permissions
⚠️ 注意：此模式会自动执行所有操作，请谨慎使用
📚
相关资源
推荐项目
SubAgent 集合：
浏览器自动化：
快速索引
连接问题 → API错误排查
认证失败 → 环境配置
超时错误 → API错误排查
配额优化 → 使用优化