Claude Code 疑难解答
收录 Claude Code 使用中的高频报错与按键/功能问题。多数为客户端通用问题（不限于 Kitcoding），放在这里方便排障。
接入相关问题在别处
如果是「接 Kitcoding 该填 AUTH_TOKEN 还是 API_KEY」「base_url 怎么写」这类接入配置问题，请看 配置 Claude Code。本页主要讲客户端本身的坑。
接入方式速查：官网 / 中转站 / 自定义
| 接入方式 | 配置要点 |
|---|---|
| Anthropic 官网 | 设 HTTP_PROXY / HTTPS_PROXY 环境变量后正常登录即可 |
| 中转站（如 Kitcoding） | 设 ANTHROPIC_BASE_URL（须为 Anthropic 格式接口）+ ANTHROPIC_AUTH_TOKEN（极大概率是这项，与 API_KEY 二选一） |
| 自定义 Anthropic 兼容接口 | 同中转站，Key 按提供方要求填，可能可置空 |
关键认知
- 直连
ANTHROPIC_BASE_URL的服务必须是 Anthropic 格式接口。若中转站只给 OpenAI 格式，需用 CCR（claude-code-router）之类工具转换。 - 以上全部只需在
~/.claude/settings.json的env节点编辑，无需改系统环境变量或折腾 TUN 系统代理。
Windows：MCP Server (Stdio) 全部无法使用
症状：Windows 下所有 stdio 类型的 MCP Server 都启动不了。
解决：把启动命令包一层 cmd：
json
{
"command": "cmd",
"args": ["/c", "npx", "..."]
}原本直接写 npx 的，改成 command: "cmd" + args: ["/c", "npx", ...] 即可。
Windows：Error: cannot open _claude_fs_right:
症状：Windows 下触发该错误，常见于 VSCode 环境。
解决：
- 暂时卸载 VSCode 的 VSIX 扩展（它在编辑时把文件路径传给 VSCode 协同，路径转换有问题），并关闭 IDE Auto Connect 功能。
- 此问题在较新版本（1.0.65+）已修正 IDE 链接稳定性。建议在 PowerShell 下运行 Claude Code。
Plan Mode 切换（Shift+Tab 不工作）
Shift + Tab切换 Plan Mode 仅在 Node v24.2.0 / v22.17.0 以上正确工作。- 不支持的 Node 版本上会自动回退绑定到
Alt + M。 - 用 bun 构建的 Claude Code（2.0.31+）全平台统一为
Shift + Tab，不受 Node 版本影响。
图片粘贴
- macOS（1.0.61+）：支持
⌘ + V粘贴图片（此前强制Ctrl + V）。 - Windows（1.0.93+）：支持
Alt + V粘贴剪贴板图片（此前只能接收图片文件）。
macOS：VSCode 内嵌终端换行多出一个 \
症状：iTerm2 下换行正常，但 VSCode 类内嵌终端按换行键会多输出一个 \。
原因：历史兼容性问题，默认 keybindings.json 绑定为 "\r\n"。
解决：改为 "\u001B\u000A"，即可与 ⌥Option + Enter 行为一致。绑定文件位置可通过 /terminal-setup 命令查看（在 VSCode/Cursor 等的数据目录下）。
红色 Offline 字样是什么？会用于检测封号吗？
Offline只是真实连接状态检测，不是异常。- 遥测信息仅为元数据，与封号无关，不必担心。