配置 Claude Code
Kitcoding 支持在 Claude Code 中使用。
前置条件
已 创建 API 令牌，推荐分组：ClaudeCode特价 或 vip。分组差异见 模型分组介绍。
一、安装
推荐用原生安装
Anthropic 官方现已首推原生安装脚本，npm 已降级为备选方式。原生安装自带后台自动更新。
curl -fsSL https://claude.ai/install.sh | bashirm https://claude.ai/install.ps1 | iexbrew install --cask claude-codewinget install Anthropic.ClaudeCode# 需要 Node.js 22+；官方已不再首推，自动更新需手动
npm install -g @anthropic-ai/claude-code验证安装
claude --version 或 claude doctor 可检查安装状态。
二、生成配置目录
安装后先运行一次 claude，让用户目录下生成 .claude 配置目录（后续才好写配置）。
三、配置 settings.json
打开 Claude Code 配置目录：
- Windows：
Win + R输入%userprofile%\.claude - macOS：访达
Command + Shift + G输入~/.claude
如果目录里没有 settings.json，手动创建，写入：
{
"env": {
"ANTHROPIC_BASE_URL": "https://kitcoding.com",
"ANTHROPIC_AUTH_TOKEN": "你的-kitcoding-令牌",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
}
}把 ANTHROPIC_AUTH_TOKEN 替换为已创建的令牌（见 创建 API 令牌）。
AUTH_TOKEN 与 API_KEY 不可共存
Claude Code 有两个鉴权变量，二选一，不能共存：
ANTHROPIC_AUTH_TOKEN—— 接 Kitcoding 等中转站时使用此项。ANTHROPIC_API_KEY—— 仅标准 Anthropic 官方接口用。
⚠️ ANTHROPIC_API_KEY 的优先级高于 Anthropic 官网登录态——只要此变量存在，Claude Code 即不再使用官网登录账号。接中转站时若误填了 API_KEY，可能出现鉴权混乱，请确认使用的是 AUTH_TOKEN。
四、选择模型（可选）
Claude Code 默认会自己挑模型。想固定用某个模型，在同一个 settings.json 里加 model 字段（与 env 平级）：
{
"model": "claude-opus-4-8",
"env": {
"ANTHROPIC_BASE_URL": "https://kitcoding.com",
"ANTHROPIC_AUTH_TOKEN": "你的-kitcoding-令牌",
"CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
}
}当前 Claude 各分组可用模型（照抄 模型广场 的 ID）：
| 模型 ID | 定位 |
|---|---|
claude-opus-5 / claude-opus-4-8 | 顶配，难题收尾 |
claude-opus-4-7 / claude-opus-4-6 | 上一代 Opus |
claude-sonnet-5 / claude-sonnet-4-6 | 日常主力，性价比 |
claude-haiku-4-5-20251001 | 轻量快速任务 |
claude-fable-5 / claude-fable-5-1 | 仅 vip / svip 分组提供 |
也可以不改文件：claude --model claude-sonnet-5 单次指定，或会话内用 /model 切换（/model 会把选择存为默认）。
用 cc-switch 配置（可选捷径）
如果不希望手动编辑命令和配置文件，cc-switch 可在图形界面中一键安装 CLI 并完成配置，自动写入上述 settings.json，因此选择此路径则无需手动执行第一至三步。详见 cc-switch 文档。
疑难解答
收录 Claude Code 使用中的高频报错与按键/功能问题。
版本基准
本页以 Claude Code 2.1.x 为准。遇到下面描述不符的行为，先 claude --version 确认版本，多数「老问题」升级后即消失。
接入方式速查：官网 / 中转站 / 自定义
| 接入方式 | 配置要点 |
|---|---|
| Anthropic 官网 | 设 HTTP_PROXY / HTTPS_PROXY 环境变量后正常登录即可 |
| Kitcoding | 设 ANTHROPIC_BASE_URL（须为 Anthropic 格式接口）+ ANTHROPIC_AUTH_TOKEN（极大概率是这项，与 API_KEY 二选一） |
Windows：MCP Server (Stdio) 全部无法使用
症状：Windows 下所有 stdio 类型的 MCP Server 都启动不了。
解决：把启动命令包一层 cmd：
{
"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 功能。
- 新版已修正 IDE 链接稳定性。建议在 PowerShell 下运行 Claude Code。
Plan Mode 切换（Shift+Tab 不工作）
当前版本全平台统一用 Shift + Tab 切换 Plan Mode，不受 Node 版本影响。
如果你的 Shift + Tab 没反应、而 Alt + M 却能用，说明你还在跑很老的版本（2.0.31 之前的非 bun 构建）——直接升级即可：
claude update图片粘贴
- macOS：
⌘ + V粘贴图片 - Windows：
Alt + V粘贴剪贴板图片
两者在当前版本均已支持。若不生效，先 claude --version 看看是不是版本太老。
macOS：VSCode 内嵌终端换行多出一个 \
症状：iTerm2 下换行正常，但 VSCode 类内嵌终端按换行键会多输出一个 \。
原因：历史兼容性问题，默认 keybindings.json 绑定为 "\r\n"。
解决：改为 "\u001B\u000A"，即可与 ⌥Option + Enter 行为一致。绑定文件位置可通过 /terminal-setup 命令查看（在 VSCode/Cursor 等的数据目录下）。
红色 Offline 字样是什么？会用于检测封号吗？
Offline只是真实连接状态检测，不是异常。- 遥测信息仅为元数据，与封号无关，不必担心。