常见问题
使用过程中的常见问题及解决方案
无法连接到服务
如果出现连接错误,请尝试以下解决方案:
解决方案(Windows):
- 打开命令提示符:按 Win + R,输入 cmd 回车
- 运行修复命令:
powershell -Command "$f='%USERPROFILE%\.claude.json';$j=Get-Content $f|ConvertFrom-Json;$j|Add-Member -NotePropertyName 'hasCompletedOnboarding' -NotePropertyValue $true -Force;$j|ConvertTo-Json|Set-Content $f"
- 重启 Claude CLI:关闭并重新打开终端,再次运行
claude
令牌无效或余额不足
- 检查令牌是否正确复制(包含 sk- 前缀)
- 登录平台检查账户余额
- 确认令牌分组是否支持你使用的模型
响应速度慢
- 检查网络连接是否稳定
- 尝试切换到速度更快的模型(如 Gemini Flash)
- 减少单次请求的上下文长度
推荐配置
建议在 Claude Code 的配置文件 settings.json(位于 ~/.claude/settings.json,Windows 路径为 %userprofile%\.claude\settings.json)的 env 中添加:
{
"env": {
"ANTHROPIC_BASE_URL": "https://api-a-i.xyz",
"ANTHROPIC_AUTH_TOKEN": "sk-你的令牌",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}
| 变量 | 值 | 说明 |
|---|---|---|
| CLAUDE_CODE_ATTRIBUTION_HEADER | 0 | 关闭请求归属头,避免中转时产生额外问题 |
| CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC | 1 | 禁用非必要的网络请求(遥测等),减少不必要的流量消耗 |
使用 CC-Switch 的用户无需手动编辑文件,可直接在图形界面中管理环境变量。