文章目录
-
- 前言
- 一、安装：三种姿势，总有一款适合你
-
- [1. 一键安装，讲究的就是省事](#1. 一键安装，讲究的就是省事)
-
- [WinGet 安装（对国内网络极其友好）](#WinGet 安装（对国内网络极其友好）)
- [官方 PowerShell 脚本](#官方 PowerShell 脚本)
- [2. 指定版本安装，拒绝被最新版背刺](#2. 指定版本安装，拒绝被最新版背刺)
- [3. 自定义安装目录，让 C 盘喘口气](#3. 自定义安装目录，让 C 盘喘口气)
- [二、核心配置：给 Claude Code 接上国内的云](#二、核心配置：给 Claude Code 接上国内的云)
-
- [1. 全局配置文件](#1. 全局配置文件)
- [2. 关键参数，一个一个说清楚](#2. 关键参数，一个一个说清楚)
- 三、中文化：把界面和输出都掰回中文
- 四、权限优化：和确认弹窗说拜拜
-
- [1. 会话内临时放行](#1. 会话内临时放行)
- [2. 全局永久配置](#2. 全局永久配置)
- [3. 安全折中：精细白名单](#3. 安全折中：精细白名单)
- 五、性能优化：治治卡顿这个老毛病
-
- [1. 状态词到底啥意思](#1. 状态词到底啥意思)
- [2. 针对性优化方案](#2. 针对性优化方案)
-
- [① 及时清空冗余上下文](#① 及时清空冗余上下文)
- [② 拆分大任务，控制上下文大小](#② 拆分大任务，控制上下文大小)
- [③ 关闭自动压缩，手动管控](#③ 关闭自动压缩，手动管控)
- [④ 拉长超时阈值](#④ 拉长超时阈值)
- [六、配置技巧：JSON 也能写注释？](#六、配置技巧：JSON 也能写注释？)
-
- [1. 单行注释与参数屏蔽](#1. 单行注释与参数屏蔽)
- [2. 多套配置切换模板](#2. 多套配置切换模板)
- [七、VSCode 插件配套配置](#七、VSCode 插件配套配置)
- 写在最后
P.S. 无意间发现了一个巨牛的人工智能教程，非常通俗易懂，对AI感兴趣的朋友强烈推荐去看看， 传送门https://blog.csdn.net/qq_34419312
前言
最近把 Claude Code 从安装到跑通折腾了个遍，别问，问就是血泪。装它之前我以为自己在装一个工具，装完发现是在练心态：网络连不上、弹窗点不完、长文档卡成幻灯片，一套组合拳下来，我甚至怀疑自己是不是在用 2008 年的电脑。
这篇就按我自己踩坑的顺序来，从安装、配置、中文化、权限到性能优化，一条龙捋清楚，代码全部能直接抄。
一、安装：三种姿势，总有一款适合你
Claude Code 官方给的路子不少，但每个坑的深浅不一样。我建议 Windows 用户优先走 WinGet，其次是官方 PowerShell 脚本；想逃离 C 盘的，可以手动部署。
1. 一键安装，讲究的就是省事
WinGet 安装（对国内网络极其友好）
Windows 11 自带的包管理器，不用翻墙，一行命令，有手就行：
winget install Anthropic.ClaudeCode这条命令的执行速度，取决于你网速的良心程度。
官方 PowerShell 脚本
想紧跟官方版本的就用这个，管理员身份打开 PowerShell，然后：
irm https://claude.ai/install.ps1 | iex默认装到 C:\Users\用户名\.local\bin，装完重启终端就能喊 claude。喊不出来也别慌，多半是环境变量还没反应过来，跟人一样，重启一下就好了。
2. 指定版本安装，拒绝被最新版背刺
最新版不一定最好用，这个道理在软件界和感情界通用。想锁版本，在脚本后面追加版本号：
# 安装指定版本 & ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89
WinGet 指定版本
winget install Anthropic.ClaudeCode --version 2.1.893. 自定义安装目录，让 C 盘喘口气
C 盘红不是你的错，是软件的错。官方脚本默认就爱往 C 盘塞，想放 D 盘，手动二进制部署最稳：
- 去 GitHub Releases 下载
claude-code-windows-x64.zip - 解压到目标路径，比如
D:\Tools\ClaudeCode - 把该路径加进系统环境变量
Path - 新增环境变量
CLAUDE_CODE_INSTALL_DIR，指向你的安装路径
已经装 C 盘的想迁移，直接把 .local\bin 剪切走，更新 Path 和上面的变量即可。记得顺手关掉自动更新，不然它偷偷摸摸又回 C 盘安家，比离家出走的猫还执着。
二、核心配置：给 Claude Code 接上国内的云
Claude Code 默认连官方模型，国内网络基本属于"连接中，请稍候，稍候，稍候到天荒地老"。解决办法是走兼容接口，比如阿里云百炼，下面以 Qwen3.6-27B 为例。
1. 全局配置文件
所有持久化配置都住在 C:\Users\用户名\.claude\settings.json，没有文件就自己新建一个，它不会自己长出来。完整模板如下，换掉密钥直接能用：
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-替换为你的阿里云DashScope密钥",
"ANTHROPIC_MODEL": "qwen3.6-27b",
"API_TIMEOUT_MS": "600000"
}
}2. 关键参数，一个一个说清楚
ANTHROPIC_BASE_URL：模型接口地址，阿里云兼容接口就这个，末尾千万别加 /v1，加了直接 404，它对你竖中指ANTHROPIC_AUTH_TOKEN：平台生成的 API 密钥，自己保管好，别截图发群里ANTHROPIC_MODEL：指定具体模型名，想换模型就换它API_TIMEOUT_MS：接口超时时间，长文档建议 600000（10 分钟），不然文档还没读完，它先躺平了
踩坑提醒：报
Arrearage400 错误，别急着骂代码，先摸摸钱包------账户欠费或者免费额度用完了。充值后重启终端，又是一条好汉。
三、中文化：把界面和输出都掰回中文
刚装完大概率是全英文界面，AI 回话还跟你拽英文。我英语四级都能过，不代表我想在工具里做阅读理解。
1. 界面语言设置
全局永久生效
在 settings.json 根节点加一行，重启终端后界面就老实说中文了：
json
"language": "zh-CN"会话内临时切换
进交互窗口后执行下面这条，立刻生效，比许愿还快：
/language zh-CN2. 强制 AI 输出中文
界面中文不代表 AI 回复中文，它可能在界面里对你微笑，转头用英文写注释。想让它全程说人话，加全局系统提示词：
json
"systemPrompt": "你全程使用简体中文回复，所有代码注释、文档、清单、说明文字全部输出中文，禁止英文解释"也可以会话内临时指定：
之后所有回答、编写文档、写代码注释全部只用简体中文输出四、权限优化：和确认弹窗说拜拜
默认安全策略下，AI 干点啥都要弹窗确认。点确认点多了，我甚至练出了肌肉记忆，看见弹窗手就自己动了，跟条件反射似的。
1. 会话内临时放行
# 放行所有Python脚本
/permissions commands allow python
放行全部系统命令
/permissions commands allow all
放行所有文件读写
/permissions files allow all2. 全局永久配置
不想每次会话都敲一遍，就在 settings.json 的 permissions 节点写上，重启后一劳永逸：
json
"permissions": {
"files": "allow",
"commands": "allow"
}3. 安全折中：精细白名单
全开有点心虚，毕竟电脑里还有我的童年照片。可以只放行常用命令，高危操作继续拦着：
json
"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 一次，历史记录堆得越厚，跑得越慢，跟手机缓存一个道理：
/clear② 拆分大任务，控制上下文大小
别一次性让 AI 读十几个大文件，还要同时生成、校验、导出，它忙不过来，你也等不起。拆成单步执行，加载压力小一大截，Brewed 的等待时间肉眼可见地缩短。
③ 关闭自动压缩，手动管控
自动压缩会在后台偷偷干活，容易造成无感知卡顿。关掉它，想压缩的时候自己来：
json
"autoCompact": false手动压缩命令：
/compact④ 拉长超时阈值
长文档处理动不动就超时触发 Stalled，把超时拉长到 10 分钟，给它多点耐心：
json
"API_TIMEOUT_MS": "600000"六、配置技巧：JSON 也能写注释？
标准 JSON 不支持注释，这是它被吐槽多年的老梗。但 Claude Code 的配置解析器偏要特立独行，直接支持 // 注释，还能顺手屏蔽备用配置。
1. 单行注释与参数屏蔽
json
{
"language": "zh-CN", // 界面简体中文
"autoCompact": false, // 关闭自动上下文压缩
// "ANTHROPIC_MODEL": "qwen3.6-plus", // 临时屏蔽，备用模型
"ANTHROPIC_MODEL": "qwen3.6-27b"
}2. 多套配置切换模板
把备用模型配置注释掉，想切的时候去掉注释就行，比换衣服还方便：
json
"env": {
// 阿里云Qwen配置（当前启用）
"ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
"ANTHROPIC_AUTH_TOKEN": "sk-阿里云密钥",
"ANTHROPIC_MODEL": "qwen3.6-27b",
// Claude 官方配置（已屏蔽）
// "ANTHROPIC_BASE_URL": "https://api.anthropic.com",
// "ANTHROPIC_AUTH_TOKEN": "sk-Claude 官方密钥",
// "ANTHROPIC_MODEL": "claude-3.7-sonnet"
}注意：
//注释只有 Claude Code 自己认，把配置复制到其他标准 JSON 工具里，记得先把注释删干净，不然人家直接报错给你看。
七、VSCode 插件配套配置
日常写代码我还是推荐用 VSCode 插件版，毕竟能少开一个窗口是一个，开多了电脑风扇比我还激动。插件版核心配置和 CLI 版通用，在 VSCode 的 settings.json 里加：
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"}
]保存后重载窗口，就能享受和 CLI 版一样的全中文、自动放行、国内模型调用一条龙服务。
写在最后
Claude Code 作为本地代码助手，强就强在能深度操作本地文件、执行脚本，批量文档处理、项目重构、代码审查这些场景，用起来是真的香。
国内环境的核心痛点就三个：网络对接、权限繁琐、长任务卡顿。按上面的配置折腾完，基本能开箱即用。剩下的坑，欢迎评论区一起交流，毕竟一个人踩坑是事故，一群人踩坑是故事。
P.S. 无意间发现了一个巨牛的人工智能教程，非常通俗易懂，对AI感兴趣的朋友强烈推荐去看看，传送门https://blog.csdn.net/qq_34419312