来源说明本文内容主要整理自一篇掘金社区教程作者个人经验并非官方文档。文中涉及的安装方式、默认路径、接口地址、配置键名、状态词含义等均属于该社区教程的说法未经官方文档核验。实际落地时请以 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教程建议长文档处理设为 60000010 分钟减少超时停滞。踩坑提醒社区教程若报Arrearage400 错误教程称可能是账户欠费或免费额度耗尽充值后重启终端恢复。该错误码含义需以平台文档确认。三、中文化界面与输出社区教程称刚装完可能是英文界面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 all2. 全局永久配置教程称在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后台加载上下文、读取解析大量文件高负载等待。ChurnedAI 反复迭代思考、校验逻辑长任务正常现象。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 官方文档与所用模型平台官方文档并在测试环境验证后再用于生产。