《 Claude Code 终极版 FAQ 指南 》
- 内容介绍
- 文章标签
- 相关推荐
-- 施工中 --
即将重写
因最近CC的更新发版速度很快,官方文档的内容存在滞后性“我当 工有所偿 学有所用,无人欺我无依傍”
本篇QA 实时 跟进 一些“隐晦”的问题 记录正确的解决方案
解决大家对于Claude Code的从基础到高级的疑惑和问题
这也是本篇的意义所在
安装部分
部分软件包存在 个人偏好
如你明白其作用和意义 按需选择
如不明白 请悉数按序执行安装
目的是正确 方便 快乐 的使用
<<< 准备工作 从富强软件中获得其提供的Proxy端口 >>>
$env:HTTP_PROXY="http://127.0.0.1:Port"; $env:HTTPS_PROXY="http://127.0.0.1:Port"<<< Powershell中执行以上命令后被富强软件正确代理 >>>
以保证 诸多软件包的安装拉取正常进行
Windows
1. Windows Terminal
image-202507201919045991920×1488 144 KB
安装好后 设定默认打开 系统内置Powershell并且给予默认为管理员权限
image-202507201948555801920×994 74.5 KB
后续右键能够直接在所处文件夹内打开对应的终端Shell
2. WinGet
$progressPreference = 'silentlyContinue'
Install-PackageProvider -Name NuGet -Force | Out-Null
Install-Module -Name Microsoft.WinGet.Client -Force -Repository PSGallery | Out-Null
Write-Host "Using Repair-WinGetPackageManager cmdlet to bootstrap WinGet..."
Repair-WinGetPackageManager -AllUsers
image1920×534 77.2 KB
3. PowerShell 7
winget install Microsoft.PowerShell
image1920×533 87.3 KB
切换默认为我们刚安装的 Powershell
image1920×1000 89.8 KB
同样修改其默认配置为 管理员启动
image1676×164 68.1 KB
全部关闭后打开新终端窗口后 继续安装其他内容
4. Notepad 4
winget install zufuliu.notepad4
image1920×504 64.9 KB
使用命令 Notepad4 打开
使用系统集成设置 替换系统记事本 和 快捷打开方式
image1438×1546 128 KB
5. Git for Windows
winget install --id Git.Git -e --source winget
image2340×464 153 KB
6. fnm
winget install Schniz.fnm
image1920×503 60.3 KB
安装成功后同样关闭全部窗口 重新打开一个终端Shell
继续安装 某版本Node
fnm install lts/krypton
fnm use lts/krypton
image2342×426 146 KB
需要对FNM给予一个环境启动
notepad $profile
没有已有PROFILE的情况下会提示不存在
image964×378 91.6 KB
需要新建,那么我们新建
New-Item –Path $Profile –Type File –Force
完成后再次使用命令 notepad $profile 打开
image1628×502 108 KB
添加内容后保存
fnm env --use-on-cd --shell powershell | Out-String | Invoke-Expression
image1394×200 84.9 KB
后同样关闭全部窗口 重新打开一个终端Shell
- 使用刚才安装的版本
fnm use lts/krypton
成功应用默认 Node 版本
- 设定 npm 镜像源
npm config set registry https://registry.npmmirror.com
- 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code
image1552×496 100 KB
(可选设定)美化相关
-
包含中文的等宽字体
开发了一年多,开源等宽字体 Maple Mono 发布 v7.0 正式版
MapleMonoNormal-NF-CN.zip- 打开powershell 修改默认字体为
Maple Mono Normal NF CN- 点击顶部下拉箭头 → 设置
- 配置文件项中的Powershell → 其他设置中的外观项 → 字体选择
- 打开powershell 修改默认字体为
image1978×1315 129 KB
- Oh My Posh
winget install JanDeDobbeleer.OhMyPosh --source winget --scope user --force
同样打开 PROFILE 新增激活 OhMyPosh
notepad $profile
image1544×576 174 KB
oh-my-posh init pwsh --eval | Invoke-Expression
image1350×236 102 KB
image1268×226 57.9 KB
主题样式很多 任君挑选 Themes | Oh My Posh
- Claude Code StatusLine | 小工具 大用处!| 超绝更新自定义
FAQ
-
Q: Windows Plan Mode 切换问题
A: Windows下claude code如何切换到plan模式? - #4,来自 Haleclipse
- 仅在 Node v24.2.0 / v22.17.0 以上Shift+Tab正确工作
- 其中 在不支持的Node版本上自动回退绑定到 Alt+M
- 2.0.31 使用bun构建的CC 全端统一为 Shift+Tab,因其不存在node的这个问题
image1474×310 12.2 KB
-
Q: Windows 图片粘贴方法
A: win下 claude code 怎么上传图片。 - #28,来自 Haleclipse
- macOS 1.0.61 增加了 ⌘ + V 的图片粘贴支持
原强制为 Ctrl + V 现粘贴体验更加一致 - Windows 1.0.93 增加了 Alt + V 的图片粘贴支持,原只能接收图片文件而不是剪贴板中的图片数据
- macOS 1.0.61 增加了 ⌘ + V 的图片粘贴支持
-
Q: macOS下 iTerm2 下换行绑定 工作正常,但VSCode类内嵌终端 该功能多出一个
\?A: 因为历史问题兼容性 目前给到的
keybindings.json绑定内容为"\\\r\n"
初看似乎没有问题,但其会在换行后多输出一个\
我们将其改为"\u001B\u000A"即可和 ⌥Option+Enter 行为一致 -
Q: Windows 触发错误异常弹出
Error: cannot open _claude_fs_right:A: 暂时卸载VSCode的VSIX扩展程序 其在编辑之时会将目标文件路径传递给VSCode进行协同,目前路径转换存在问题 待修复「并且关闭IDE Auto Connect 功能」
- 此问题可能已在历史版本中修正,按照如上的安装方式 在Powershell下运行,一并解决了 链接IDE的找不到的问题
- 1.0.65 已修正链接IDE稳定性问题
image1190×250 20.8 KB
-
Q: Windows下MCP Server (Stdio) 全部无法使用?
A: 改成
command: "cmd"后接arg : ["/c","npx"]- 原理:关于Windows原生运行claude code的问题 - #4,来自 Haleclipse
- 样例:Claude Code 原生 Windows 的 MCP 错误处理
claude mcp add --transport sse context7 https://mcp.context7.com/sse --header "CONTEXT7_API_KEY: YOUR_API_KEY"
-
Q: 红色 Offline 字样是做什么用的?遥测相关会不会用于检测封号?
A: Offline 只是用作真 连接状态检测 详见
- windows claude code显示offline,但是不影响使用。 - #10,来自 Haleclipse
- 遥测信息仅元数据 封号不相关: windows claude code显示offline,但是不影响使用。 - #7,来自 Haleclipse
-
Q: 官网 / 中转站 / CCR类自定义重定向API接入,在设定上有何区别
A:
-
- 官网:设定
HTTP_PROXY/HTTPS_PROXY环境变量正常登录即可
- 有使用Claude code的大佬吗,一直报403 - #9,来自 Haleclipse
- 使用claude code 提示offline - #12,来自 Haleclipse
- 官网:设定
-
- 中转站:如无魔改 使用其提供的api端点地址和key设定即可
ANTHROPIC_BASE_URL(需是 Anthropic 形式接口)ANTHROPIC_API_KEY(只有标准 Anthropic 填写此项)ANTHROPIC_AUTH_TOKEN(有极高概率是此项)- 二选一而非可以共存
- 二选一而非可以共存
- 案例:接入月之暗面K2 (标准 Anthropic 形式接口)
"ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic""ANTHROPIC_API_KEY":"你的Key"
- 案例:Aηyrouter (NewAPI 转换得来)
"ANTHROPIC_BASE_URL": "https://aηyrouter.top""ANTHROPIC_AUTH_TOKEN": "sk-xxxxxx"
-
- 自定义 Anthropic 兼容接口接入:
-
同中转站 但KEY处可置空 按照Proxy提供者的要求处理
-
案例:接入 Qwen Coder
-
CCR 接入GLM-4.5支持触发思考应如何配置?
- GLM4.5如何在claude code里开启思考? - #27,来自 Haleclipse
image1676×890 78.2 KB
-
以上内容均只需在
~/.claude/settings.json中的env节点下编辑 全篇无须操作系统的环境变量,以及折腾代理软件的诸如 TUN 系统代理等内容 ,来支持CC的使用 -
并且需要注意
ANTHROPIC_API_KEY的优先级要高于官网登录态,只要存在该env,CC将不会使用官网登录态的服务 -
所以最简单的接入点切换方法暂时就是 copy几份不同的,后续会将这部分功能傻瓜化到GUI中~/.claude/settings.json文件 然后手动进行替换Claudiatron,以方便快速切换和设定这些内容 -
v1.0.61 已经添加
--settings参数,能够便捷化指定加载不同的settings.json配置
image358×188 20.8 KB -
目前在设置中开启
Verbose Output恢复原有 详情输出 且添加了 上下文窗口实际值显示
image2364×264 32.7 KB
-
鉴于没有推进SubAgent的内容,这里给到一个集合网站给予参考
- http://subagents.cc
--【壹】--:
fnm是node版本管理工具?我一直用的是nvm
--【贰】--:
我将立即捧场,太棒了!
--【叁】--:
我真的愛死你了 趕緊完工吧
--【肆】--:
還在施工啊 我還以為是終端美化教程
--【伍】--:
前排捧场
--【陆】--:
谢谢佬友的指南
--【柒】--:
美美的,支持一下!
--【捌】--:
支持一下!
--【玖】--:
太强了,大佬
--【拾】--:
佬,想问
- 特化的中转站(表明了可以直接接入CC)才可以直接用CC,否则都得用CCR来转换对吗?
- 如果是的话,造成这种的原因是不是因为现在的各种API站默认出站都是OpenAI格式?需要转成Anthropic格式?
--【拾壹】--:
来日方长
--【拾贰】--:
明白了,专业Anthropic客服。
--【拾叁】--:
泰裤辣!!!
--【拾肆】--:
感谢分享!
--【拾伍】--:
全是的
其直接接驳的 ANTHROPIC_BASE_URL 提供的服务必须是 Anthropic格式
--【拾陆】--:
太强了
--【拾柒】--:
都可以 自由选择
版本管理还有很多
这边推荐用rust写的
主要是winget安装一把梭了 使用上也方便
--【拾捌】--:
原来这么复杂
--【拾玖】--:
太强了佬,正好想学下
-- 施工中 --
即将重写
因最近CC的更新发版速度很快,官方文档的内容存在滞后性“我当 工有所偿 学有所用,无人欺我无依傍”
本篇QA 实时 跟进 一些“隐晦”的问题 记录正确的解决方案
解决大家对于Claude Code的从基础到高级的疑惑和问题
这也是本篇的意义所在
安装部分
部分软件包存在 个人偏好
如你明白其作用和意义 按需选择
如不明白 请悉数按序执行安装
目的是正确 方便 快乐 的使用
<<< 准备工作 从富强软件中获得其提供的Proxy端口 >>>
$env:HTTP_PROXY="http://127.0.0.1:Port"; $env:HTTPS_PROXY="http://127.0.0.1:Port"<<< Powershell中执行以上命令后被富强软件正确代理 >>>
以保证 诸多软件包的安装拉取正常进行
Windows
1. Windows Terminal
image-202507201919045991920×1488 144 KB
安装好后 设定默认打开 系统内置Powershell并且给予默认为管理员权限
image-202507201948555801920×994 74.5 KB
后续右键能够直接在所处文件夹内打开对应的终端Shell
2. WinGet
$progressPreference = 'silentlyContinue'
Install-PackageProvider -Name NuGet -Force | Out-Null
Install-Module -Name Microsoft.WinGet.Client -Force -Repository PSGallery | Out-Null
Write-Host "Using Repair-WinGetPackageManager cmdlet to bootstrap WinGet..."
Repair-WinGetPackageManager -AllUsers
image1920×534 77.2 KB
3. PowerShell 7
winget install Microsoft.PowerShell
image1920×533 87.3 KB
切换默认为我们刚安装的 Powershell
image1920×1000 89.8 KB
同样修改其默认配置为 管理员启动
image1676×164 68.1 KB
全部关闭后打开新终端窗口后 继续安装其他内容
4. Notepad 4
winget install zufuliu.notepad4
image1920×504 64.9 KB
使用命令 Notepad4 打开
使用系统集成设置 替换系统记事本 和 快捷打开方式
image1438×1546 128 KB
5. Git for Windows
winget install --id Git.Git -e --source winget
image2340×464 153 KB
6. fnm
winget install Schniz.fnm
image1920×503 60.3 KB
安装成功后同样关闭全部窗口 重新打开一个终端Shell
继续安装 某版本Node
fnm install lts/krypton
fnm use lts/krypton
image2342×426 146 KB
需要对FNM给予一个环境启动
notepad $profile
没有已有PROFILE的情况下会提示不存在
image964×378 91.6 KB
需要新建,那么我们新建
New-Item –Path $Profile –Type File –Force
完成后再次使用命令 notepad $profile 打开
image1628×502 108 KB
添加内容后保存
fnm env --use-on-cd --shell powershell | Out-String | Invoke-Expression
image1394×200 84.9 KB
后同样关闭全部窗口 重新打开一个终端Shell
- 使用刚才安装的版本
fnm use lts/krypton
成功应用默认 Node 版本
- 设定 npm 镜像源
npm config set registry https://registry.npmmirror.com
- 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code
image1552×496 100 KB
(可选设定)美化相关
-
包含中文的等宽字体
开发了一年多,开源等宽字体 Maple Mono 发布 v7.0 正式版
MapleMonoNormal-NF-CN.zip- 打开powershell 修改默认字体为
Maple Mono Normal NF CN- 点击顶部下拉箭头 → 设置
- 配置文件项中的Powershell → 其他设置中的外观项 → 字体选择
- 打开powershell 修改默认字体为
image1978×1315 129 KB
- Oh My Posh
winget install JanDeDobbeleer.OhMyPosh --source winget --scope user --force
同样打开 PROFILE 新增激活 OhMyPosh
notepad $profile
image1544×576 174 KB
oh-my-posh init pwsh --eval | Invoke-Expression
image1350×236 102 KB
image1268×226 57.9 KB
主题样式很多 任君挑选 Themes | Oh My Posh
- Claude Code StatusLine | 小工具 大用处!| 超绝更新自定义
FAQ
-
Q: Windows Plan Mode 切换问题
A: Windows下claude code如何切换到plan模式? - #4,来自 Haleclipse
- 仅在 Node v24.2.0 / v22.17.0 以上Shift+Tab正确工作
- 其中 在不支持的Node版本上自动回退绑定到 Alt+M
- 2.0.31 使用bun构建的CC 全端统一为 Shift+Tab,因其不存在node的这个问题
image1474×310 12.2 KB
-
Q: Windows 图片粘贴方法
A: win下 claude code 怎么上传图片。 - #28,来自 Haleclipse
- macOS 1.0.61 增加了 ⌘ + V 的图片粘贴支持
原强制为 Ctrl + V 现粘贴体验更加一致 - Windows 1.0.93 增加了 Alt + V 的图片粘贴支持,原只能接收图片文件而不是剪贴板中的图片数据
- macOS 1.0.61 增加了 ⌘ + V 的图片粘贴支持
-
Q: macOS下 iTerm2 下换行绑定 工作正常,但VSCode类内嵌终端 该功能多出一个
\?A: 因为历史问题兼容性 目前给到的
keybindings.json绑定内容为"\\\r\n"
初看似乎没有问题,但其会在换行后多输出一个\
我们将其改为"\u001B\u000A"即可和 ⌥Option+Enter 行为一致 -
Q: Windows 触发错误异常弹出
Error: cannot open _claude_fs_right:A: 暂时卸载VSCode的VSIX扩展程序 其在编辑之时会将目标文件路径传递给VSCode进行协同,目前路径转换存在问题 待修复「并且关闭IDE Auto Connect 功能」
- 此问题可能已在历史版本中修正,按照如上的安装方式 在Powershell下运行,一并解决了 链接IDE的找不到的问题
- 1.0.65 已修正链接IDE稳定性问题
image1190×250 20.8 KB
-
Q: Windows下MCP Server (Stdio) 全部无法使用?
A: 改成
command: "cmd"后接arg : ["/c","npx"]- 原理:关于Windows原生运行claude code的问题 - #4,来自 Haleclipse
- 样例:Claude Code 原生 Windows 的 MCP 错误处理
claude mcp add --transport sse context7 https://mcp.context7.com/sse --header "CONTEXT7_API_KEY: YOUR_API_KEY"
-
Q: 红色 Offline 字样是做什么用的?遥测相关会不会用于检测封号?
A: Offline 只是用作真 连接状态检测 详见
- windows claude code显示offline,但是不影响使用。 - #10,来自 Haleclipse
- 遥测信息仅元数据 封号不相关: windows claude code显示offline,但是不影响使用。 - #7,来自 Haleclipse
-
Q: 官网 / 中转站 / CCR类自定义重定向API接入,在设定上有何区别
A:
-
- 官网:设定
HTTP_PROXY/HTTPS_PROXY环境变量正常登录即可
- 有使用Claude code的大佬吗,一直报403 - #9,来自 Haleclipse
- 使用claude code 提示offline - #12,来自 Haleclipse
- 官网:设定
-
- 中转站:如无魔改 使用其提供的api端点地址和key设定即可
ANTHROPIC_BASE_URL(需是 Anthropic 形式接口)ANTHROPIC_API_KEY(只有标准 Anthropic 填写此项)ANTHROPIC_AUTH_TOKEN(有极高概率是此项)- 二选一而非可以共存
- 二选一而非可以共存
- 案例:接入月之暗面K2 (标准 Anthropic 形式接口)
"ANTHROPIC_BASE_URL": "https://api.moonshot.cn/anthropic""ANTHROPIC_API_KEY":"你的Key"
- 案例:Aηyrouter (NewAPI 转换得来)
"ANTHROPIC_BASE_URL": "https://aηyrouter.top""ANTHROPIC_AUTH_TOKEN": "sk-xxxxxx"
-
- 自定义 Anthropic 兼容接口接入:
-
同中转站 但KEY处可置空 按照Proxy提供者的要求处理
-
案例:接入 Qwen Coder
-
CCR 接入GLM-4.5支持触发思考应如何配置?
- GLM4.5如何在claude code里开启思考? - #27,来自 Haleclipse
image1676×890 78.2 KB
-
以上内容均只需在
~/.claude/settings.json中的env节点下编辑 全篇无须操作系统的环境变量,以及折腾代理软件的诸如 TUN 系统代理等内容 ,来支持CC的使用 -
并且需要注意
ANTHROPIC_API_KEY的优先级要高于官网登录态,只要存在该env,CC将不会使用官网登录态的服务 -
所以最简单的接入点切换方法暂时就是 copy几份不同的,后续会将这部分功能傻瓜化到GUI中~/.claude/settings.json文件 然后手动进行替换Claudiatron,以方便快速切换和设定这些内容 -
v1.0.61 已经添加
--settings参数,能够便捷化指定加载不同的settings.json配置
image358×188 20.8 KB -
目前在设置中开启
Verbose Output恢复原有 详情输出 且添加了 上下文窗口实际值显示
image2364×264 32.7 KB
-
鉴于没有推进SubAgent的内容,这里给到一个集合网站给予参考
- http://subagents.cc
--【壹】--:
fnm是node版本管理工具?我一直用的是nvm
--【贰】--:
我将立即捧场,太棒了!
--【叁】--:
我真的愛死你了 趕緊完工吧
--【肆】--:
還在施工啊 我還以為是終端美化教程
--【伍】--:
前排捧场
--【陆】--:
谢谢佬友的指南
--【柒】--:
美美的,支持一下!
--【捌】--:
支持一下!
--【玖】--:
太强了,大佬
--【拾】--:
佬,想问
- 特化的中转站(表明了可以直接接入CC)才可以直接用CC,否则都得用CCR来转换对吗?
- 如果是的话,造成这种的原因是不是因为现在的各种API站默认出站都是OpenAI格式?需要转成Anthropic格式?
--【拾壹】--:
来日方长
--【拾贰】--:
明白了,专业Anthropic客服。
--【拾叁】--:
泰裤辣!!!
--【拾肆】--:
感谢分享!
--【拾伍】--:
全是的
其直接接驳的 ANTHROPIC_BASE_URL 提供的服务必须是 Anthropic格式
--【拾陆】--:
太强了
--【拾柒】--:
都可以 自由选择
版本管理还有很多
这边推荐用rust写的
主要是winget安装一把梭了 使用上也方便
--【拾捌】--:
原来这么复杂
--【拾玖】--:
太强了佬,正好想学下

