一、写在最前的Tip
1.保险起见，使用 Claude Code前记得先做好代码备份或者版本控制！！！
2.报错长度不够的，统一添加环境变量：
变量名：CLAUDE_CODE_MAX_OUTPUT_TOKENS，变量值：32000
3.大token请求，怎么清理缓存
对话框输入：“帮我把当前重点更新到claude.md”
cc更新完之后，执行/clear重新开始提需求。提示词的需求写的越清楚，cc的执行力越强。
4.Claude Code 现已支持版本升级
更新命令：
macOS/Linux:
sudo npm install -g @anthropic-ai/claude-code
Windows:
npm install -g @anthropic-ai/claude-code
二、400报错的处理方式
添加环境变量即可解决：
添加CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1的系统环境变量
注意设置好后需要把所有终端都关闭才能生效！
三、401 ['sk]无效的令牌报错的处理方式
1.原因是ide或者mcp修改了settings.json配置文件，需要设置一下环境变量
1.1windows配置：
1.打开环境变量设置
按 Win + R，输入 sysdm.cpl，按回车，点击"高级"选项卡，然后点击"环境变量"
2.添加系统变量 ：
在"系统变量"区域点击"新建"，添加第一个变量
变量名：ANTHROPIC_AUTH_TOKEN，变量值：sk-(你的key)，点击"确定"
添加第二个变量 ：
再次点击"新建"，变量名：ANTHROPIC_API_KEY，变量值：sk-(你的key)，点击"确定"
添加第三个变量 ：
再次点击"新建"，变量名：ANTHROPIC_BASE_URL，变量值：https://moacode.com
点击"确定"
再次点击"新建"，变量名：CLAUDE_CODE_MAX_OUTPUT_TOKENS，变量值：32000
点击"确定"
3.删除C:\User\用户.claude 目录下的settings.json，重新打开cmd 运行claude code
1.2mac配置：
Mac:
echo 'export ANTHROPIC_AUTH_TOKEN="sk-(改成你的sk)"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-(改成你的sk)"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://moacode.com"' >> ~/.zshrc
source ~/.zshrc
四、Missing API Key/403报错的处理方式
常见显示为
API Error: 403 {"error":{"type":"forbidden","message":"Request not allowed"}}
或者如下图所示：
说明环境变量没配置好，设置一下就行。
1.window配置：
1.打开环境变量设置
按 Win + R，输入 sysdm.cpl，按回车，点击"高级"选项卡，然后点击"环境变量"
2.添加系统变量 ：
在"系统变量"区域点击"新建"，添加第一个变量
变量名：ANTHROPIC_AUTH_TOKEN，变量值：sk-(你的key)，点击"确定"
添加第二个变量 ：
再次点击"新建"，变量名：ANTHROPIC_API_KEY，变量值：sk-(你的key)，点击"确定"
添加第三个变量 ：
再次点击"新建"，变量名：ANTHROPIC_BASE_URL，变量值：https://moacode.com
点击"确定"
重新打开cmd 运行claude code
2.mac配置：
echo 'export ANTHROPIC_AUTH_TOKEN="sk-(改成你的sk)"' >> ~/.zshrc
echo 'export ANTHROPIC_API_KEY="sk-(改成你的sk)"' >> ~/.zshrc
echo 'export ANTHROPIC_BASE_URL="https://moacode.com"' >> ~/.zshrc
source ~/.zshrc
五、API Error (Connection error.)报错的处理方式
一般是网络问题，可以执行下面代码查看网络到服务器的健康情况：
ping https://moacode.com
如果连接超时，说明网络跟服务器不太通，建议换个Wi-Fi，或者关掉🪜/切换节点，或者连手机热点试试。
如果ping 域名正常，但是cc还是连接不上
1.Windows用户可以在cmd执行：
set HTTP_PROXY=
set HTTPS_PROXY=
set http_proxy=
set https_proxy=
2.macOS用户/Ubuntu用户可以在在终端执行:
unset http_proxy
unset https_proxy
unset all_proxy
unset HTTP_PROXY
unset HTTPS_PROXY
unset ALL_PROXY
然后再启动claude code
六、API Error(Request timed out)报错的处理方式
分两种情况：
1. (Request timed out.) 可能是网络问题，跟上面API Error (Connection error.)一样操作。
2. (Request timed out.) 也可能是上下文过长，清理上下文（/clear或者关闭cc重新打开）再提问。如果是在ide里面用，注意看看ide插件是不是本身带了很多内置的prompt，加上cc本身自带的prompt，可以用的连续对话次数就很少了，正常情况下出现这种问题的概率很低。
七、API Error 400报错的处理方式
这个是cc本身请求体有问题，差不多算是bug，可以重新请求几次试试，esc再发送continue。或者改改对话内容,让cc不带这种异常参数请求。也可以/compact一下试试，实在不行就重开对话解决～
八、Overloaded/500报错的处理方式
500报错是官方问题，overloaded的话可以访问status.anthropic.com 查看Claude官方服务状态
九、Command timed out after 2m 0.0s报错的处理方式
这是cc本身和系统交互的问题，没拿到命令的结果，跟接口请求没关系，这种命令能执行的话可以手动执行速度可能更快。
十、API Error 413/400 Invalid model name报错的处理方式
1.报错API Error 413，说明请求体太大，需要清理上下文（/clear或者关闭cc重新打开）再提问。
2.报错400 Invalid model name，官方报错，opus并发不够
十一、API Error：response exceeded the 32000报错的处理方式
设置一下环境变量CLAUDE_CODE_MAX_OUTPUT_TOKENS，值写32000
十二、之前买过同行的，然后使用cc报错无效令牌的处理方式
把之前设置的环境变量删一下。
1.Windows用户：
1.按 Win + R，输入 sysdm.cpl，按回车。或者任务栏里搜索环境变量，然后打开环境变量编辑
2.点击"高级"选项卡，然后点击"环境变量"
3.然后删除用户变量和系统变量下的
ANTHROPIC_BASE_URL
ANTHROPIC_API_KEY
ANTHROPIC_API_TOKEN
然后保存退出，重新打开cmd运行claude code。
如果还不行，删除C:\Users\用户名.claude下的claude.json和claude.json.backup。
2.MacOs用户：
- 打开终端，编辑环境变量配置文件：
- vi ~/.zshrc或者vi ~/.bashrc（根据自己的环境来，也可以两个都看看） 删除里面的 ANTHROPIC_BASE_URLANTHROPIC_API_KEYANTHROPIC_API_TOKEN
- 重新打开终端使用claude code
