来源说明

本文内容主要整理自一篇掘金社区教程（作者个人经验），并非官方文档。文中涉及的安装方式、默认路径、接口地址、配置键名、状态词含义等，均属于该社区教程的说法，未经官方文档核验。实际落地时请以 Anthropic 官方最新说明和所用模型平台官方文档为准。

一、安装方式：社区教程提到的三种路径

据该社区教程，Windows 下安装 Claude Code 有几种可选方式。以下命令与路径均来自该教程，建议执行前先核对官方安装页。

1. WinGet 方式

社区教程称 Windows 11 自带 WinGet，可尝试：

winget install Anthropic.ClaudeCode

该包名与可用性需以 WinGet 源和官方说明为准。

2. PowerShell 脚本方式

社区教程给出的脚本调用方式：

irm https://claude.ai/install.ps1 | iex

教程称默认安装路径为 C:\Users\用户名\.local\bin，安装后重启终端可调用 claude。该默认路径属于社区经验，官方是否如此需自行核验。

3. 指定版本

社区教程给出的固定版本写法：

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89
winget install Anthropic.ClaudeCode --version 2.1.89

版本号仅为示例，实际可用版本以官方发布为准。

4. 自定义安装目录（社区经验）

社区教程称脚本默认装到 C 盘用户目录，想迁到 D 盘可手动部署二进制：从 GitHub Releases 下载 claude-code-windows-x64.zip，解压到目标路径（如 D:\Tools\ClaudeCode），把该路径加入系统 Path，并新增环境变量 CLAUDE_CODE_INSTALL_DIR 指向安装路径。已装 C 盘想迁移，可剪切 .local\bin 到目标目录并更新 Path 与上述变量，同时建议关闭自动更新避免回迁。

注意：安装包名、环境变量名、默认路径均为社区教程说法，官方是否支持该变量需查官方文档确认。

二、核心配置：对接国内兼容接口的思路

社区教程称 Claude Code 默认对接官方 Claude 模型，国内环境可尝试通过兼容接口对接阿里云百炼等平台，并以 Qwen 系列模型为例。以下配置模板来自该教程，接口地址与模型名需以对应平台官方文档为准。

1. settings.json 模板（社区教程）

教程称持久化配置写在 C:\Users\用户名\.claude\settings.json，没有则新建：

{
  "language": "zh-CN",
  "autoCompact": false,
  "autoUpdate": false,
  "permissions": {
    "files": "allow",
    "commands": "allow"
  },
  "env": {
    "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-替换为你的平台密钥",
    "ANTHROPIC_MODEL": "qwen3.6-27b",
    "API_TIMEOUT_MS": "600000"
  }
}

2. 参数说明（社区经验，非官方确认）

  • ANTHROPIC_BASE_URL：教程称阿里云兼容接口为此地址，并称末尾不能加 /v1，否则可能 404。该地址与规则属于社区经验，请以阿里云百炼官方文档为准。
  • ANTHROPIC_AUTH_TOKEN：平台生成的 API 密钥。
  • ANTHROPIC_MODEL：教程示例为 qwen3.6-27b，实际模型名以平台文档为准。
  • API_TIMEOUT_MS：教程建议长文档处理设为 600000（10 分钟），减少超时停滞。

踩坑提醒（社区教程）：若报 Arrearage 400 错误，教程称可能是账户欠费或免费额度耗尽，充值后重启终端恢复。该错误码含义需以平台文档确认。

三、中文化：界面与输出

社区教程称刚装完可能是英文界面，AI 回复也可能默认英文，分两步设置。

1. 界面语言

教程称在 settings.json 根节点加 "language": "zh-CN"，重启终端后默认中文界面；会话内可执行 /language zh-CN 临时切换。

2. 强制 AI 输出中文

教程称界面中文不等于回复中文，可加全局系统提示词：

"systemPrompt": "你全程使用简体中文回复，所有代码注释、文档、清单、说明文字全部输出中文，禁止英文解释"

也可在会话内临时指定：之后所有回答、编写文档、写代码注释全部只用简体中文输出。

上述配置键名与命令均来自社区教程，是否被官方支持需自行核验。

四、权限优化：减少确认弹窗

社区教程称默认安全策略下，AI 执行命令、修改文件会弹确认框，频繁操作打断流程。以下为教程给出的放行方式。

1. 会话内临时放行

/permissions commands allow python
/permissions commands allow all
/permissions files allow all

2. 全局永久配置

教程称在 settings.json 的 permissions 节点设置 "files": "allow"、"commands": "allow"，重启后生效。

3. 精细白名单（社区经验）

不想全开风险，可只放行常用命令、拦截高危操作：

"permissions": {
  "files": "allow",
  "commands": {
    "allow": ["python*", "python3*"],
    "deny": ["rm*", "del*", "format*", "rd*"]
  }
}

教程称这样 Python 脚本自动执行无弹窗，删除、格式化等高风险操作仍保留二次确认。

权限配置键名与命令语法来自社区教程，官方是否支持该结构需查官方文档。

五、性能优化：卡顿与停滞排查

社区教程称长文档处理、大项目扫描时，常出现 Brewed、Stalled、Churned 等状态并长时间卡住。以下状态词含义为教程作者个人理解，非官方定义。

1. 状态词含义（社区解释）

  • Work：正常运算中。
  • Brewed：后台加载上下文、读取解析大量文件，高负载等待。
  • Churned：AI 反复迭代思考、校验逻辑，长任务正常现象。
  • Crunched：自动压缩超长对话上下文，节省 token。
  • Stalled：教程称真正的停滞卡死，通常是网络延迟、接口限流、请求超时导致。

2. 优化方案（社区经验）

  • 每完成一个大任务执行 /clear 清空冗余上下文。
  • 拆分大任务，不要一次性让 AI 读取十几个大文件并同时完成生成+校验+导出，拆成单步执行可降低加载压力。
  • 关闭自动压缩 "autoCompact": false，需要时手动执行 /compact。
  • 长文档处理容易超时触发 Stalled，把 API_TIMEOUT_MS 拉长到 600000。

状态词含义与优化手段均为社区经验，实际行为请以官方说明和自身压测为准。

六、配置技巧：JSON 注释与参数屏蔽

社区教程称标准 JSON 不支持注释，但 Claude Code 的配置解析器做了放宽，可直接用 // 写注释、屏蔽备用配置：

{
  "language": "zh-CN", // 界面简体中文
  "autoCompact": false, // 关闭自动上下文压缩
  // "ANTHROPIC_MODEL": "qwen3.6-plus", // 临时屏蔽，备用模型
  "ANTHROPIC_MODEL": "qwen3.6-27b"
}

教程称多套配置切换时，可把备用模型配置注释掉，需要时快速切换。注意 // 注释仅 Claude Code 自身识别，把配置复制到其他标准 JSON 工具时，需先删掉注释避免语法报错。

配置解析器是否放宽注释支持，属于社区教程说法，需以官方文档确认。

七、VSCode 插件配置（社区教程）

社区教程称日常写代码更推荐 VSCode 插件版，核心配置和 CLI 版通用，在 VSCode 的 settings.json 中添加：

"claudeCode.language": "zh-CN",
"claudeCode.autoApproveCommands": true,
"claudeCode.autoApproveFileEdits": true,
"claudeCode.defaultModel": "qwen3.6-27b",
"claudeCode.environmentVariables": [
  {"name":"ANTHROPIC_BASE_URL","value":"https://dashscope.aliyuncs.com/apps/anthropic"},
  {"name":"ANTHROPIC_AUTH_TOKEN","value":"sk-你的密钥"},
  {"name":"ANTHROPIC_MODEL","value":"qwen3.6-27b"}
]

教程称保存后重载 VSCode 窗口，可实现和 CLI 版一致的全中文、自动放行、国内模型调用体验。

上述 VSCode 配置键名来自社区教程，官方插件是否使用这些键名需查插件官方文档确认。

小结

本文整理自一篇掘金社区教程，覆盖 Windows 下 Claude Code 的安装、settings.json 配置、对接国内兼容接口、权限弹窗治理、长上下文卡顿排查与 VSCode 插件配置。所有涉及官方默认行为、固定接口地址、安装包名、环境变量名、VSCode 配置键的说法，均属于社区经验，未经官方文档核验。建议落地前先核对 Anthropic 官方文档与所用模型平台官方文档，并在测试环境验证后再用于生产。