《 Claude Code 终极版 FAQ 指南 》

2026-04-13 12:441阅读0评论SEO教程
  • 内容介绍
  • 文章标签
  • 相关推荐
问题描述:
-- 施工中 --
即将重写

“我当 工有所偿 学有所用,无人欺我无依傍”

因最近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 → 其他设置中的外观项 → 字体选择

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 的图片粘贴支持,原只能接收图片文件而不是剪贴板中的图片数据
  • 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:

      1. 官网:设定 HTTP_PROXY / HTTPS_PROXY 环境变量正常登录即可
      • 有使用Claude code的大佬吗,一直报403 - #9,来自 Haleclipse
      • 使用claude code 提示offline - #12,来自 Haleclipse

      1. 中转站:如无魔改 使用其提供的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"

      1. 自定义 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几份不同的~/.claude/settings.json文件 然后手动进行替换,后续会将这部分功能傻瓜化到GUI中 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 → 其他设置中的外观项 → 字体选择

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 的图片粘贴支持,原只能接收图片文件而不是剪贴板中的图片数据
  • 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:

      1. 官网:设定 HTTP_PROXY / HTTPS_PROXY 环境变量正常登录即可
      • 有使用Claude code的大佬吗,一直报403 - #9,来自 Haleclipse
      • 使用claude code 提示offline - #12,来自 Haleclipse

      1. 中转站:如无魔改 使用其提供的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"

      1. 自定义 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几份不同的~/.claude/settings.json文件 然后手动进行替换,后续会将这部分功能傻瓜化到GUI中 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安装一把梭了 使用上也方便


--【拾捌】--:

原来这么复杂


--【拾玖】--:

太强了佬,正好想学下