2. Linux.do
  3. 《 Claude Code 终极版 FAQ 指南 》

《 Claude Code 终极版 FAQ 指南 》

哈雷彗星 2025-07-20 21:50 1



-- 施工中 --



即将重写


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



因最近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



安装好后 设定默认打开 系统内置Powershell并且给予默认为管理员权限



后续右键能够直接在所处文件夹内打开对应的终端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


3. PowerShell 7


winget install Microsoft.PowerShell



切换默认为我们刚安装的 Powershell



同样修改其默认配置为 管理员启动



全部关闭后打开新终端窗口后 继续安装其他内容


4. Notepad 4


winget install zufuliu.notepad4



使用命令 Notepad4 打开

使用系统集成设置 替换系统记事本 和 快捷打开方式


5. Git for Windows


winget install --id Git.Git -e --source winget


6. fnm


winget install Schniz.fnm



安装成功后同样关闭全部窗口 重新打开一个终端Shell

继续安装 某版本Node


fnm install lts/krypton



fnm use lts/krypton



需要对FNM给予一个环境启动


notepad $profile

没有已有PROFILE的情况下会提示不存在



需要新建，那么我们新建


New-Item –Path $Profile –Type File –Force

完成后再次使用命令 notepad $profile 打开



添加内容后保存


fnm env --use-on-cd --shell powershell | Out-String | Invoke-Expression


后同样关闭全部窗口 重新打开一个终端Shell



  • 使用刚才安装的版本


fnm use lts/krypton

成功应用默认 Node 版本



  • 设定 npm 镜像源


npm config set registry https://registry.npmmirror.com


  • 全局安装 Claude Code


npm install -g @anthropic-ai/[email protected]

或者 继续最新版


npm install -g @cometix/claude-code

毁了 全都毁了

简简单单救赎一下


（可选设定）美化相关




  • 包含中文的等宽字体

    开发了一年多，开源等宽字体 Maple Mono 发布 v7.0 正式版

    MapleMonoNormal-NF-CN.zip



    • 打开powershell 修改默认字体为 Maple Mono Normal NF CN

      • 点击顶部下拉箭头 → 设置

      • 配置文件项中的Powershell → 其他设置中的外观项 → 字体选择








  • Oh My Posh


winget install JanDeDobbeleer.OhMyPosh --source winget --scope user --force

同样打开 PROFILE 新增激活 OhMyPosh


notepad $profile




oh-my-posh init pwsh --eval | Invoke-Expression



主题样式很多 任君挑选 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的这个问题





  • 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"
    初看似乎没有问题，但其会在换行后多输出一个 \
    我们将其改为 "
    "     即可和 ⌥Option+Enter 行为一致




  • Q: Windows 触发错误异常弹出 Error: cannot open _claude_fs_right:


    A: 暂时卸载VSCode的VSIX扩展程序 其在编辑之时会将目标文件路径传递给VSCode进行协同，目前路径转换存在问题 待修复「并且关闭IDE Auto Connect 功能」



    • 此问题可能已在历史版本中修正，按照如上的安装方式 在Powershell下运行，一并解决了 链接IDE的找不到的问题

    • 1.0.65 已修正链接IDE稳定性问题





  • 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











    • 以上内容均只需在 ~/.claude/settings.json 中的 env 节点下编辑 全篇无须操作系统的环境变量，以及折腾代理软件的诸如 TUN 系统代理等内容 ，来支持CC的使用




    • 并且需要注意ANTHROPIC_API_KEY的优先级要高于官网登录态，只要存在该env，CC将不会使用官网登录态的服务




    • 所以最简单的接入点切换方法暂时就是 copy几份不同的~/.claude/settings.json文件 然后手动进行替换,后续会将这部分功能傻瓜化到GUI中 Claudiatron，以方便快速切换和设定这些内容




    • v1.0.61 已经添加 --settings 参数，能够便捷化指定加载不同的settings.json配置




    • 目前在设置中开启 Verbose Output 恢复原有 详情输出 且添加了 上下文窗口实际值显示







鉴于没有推进SubAgent的内容，这里给到一个集合网站给予参考



  • http://subagents.cc

最新回复 (19)
  • 宙斯 07-20 21:53
    1楼

    我将立即捧场，太棒了！

  • A2401314 07-20 21:55
    2楼

    美美的，支持一下!

  • CRT 07-20 21:57
    3楼

    fnm是node版本管理工具？我一直用的是nvm

  • あ 07-20 21:57
    4楼

    前排捧场

  • youngc 07-20 21:59
    5楼

    谢谢佬友的指南

  • 大帅哥 07-20 22:02
    6楼

    太强了，大佬

  • 哈雷彗星 楼主 07-20 22:03
    7楼

    都可以 自由选择


    版本管理还有很多


    这边推荐用rust写的


    主要是winget安装一把梭了 使用上也方便

  • lueluelue 07-20 22:07
    8楼

    泰裤辣！！！

  • sudijsj 07-20 22:11
    9楼

    ^-^太强了

  • sem ha 07-20 22:28
    10楼

    太强了佬，正好想学下

  • Reno 07-20 22:29
    11楼

    原来这么复杂 ^-^

  • marre 07-20 22:36
    12楼

    支持一下！

  • marre 07-20 22:43
    13楼

    佬，想问



    • 特化的中转站（表明了可以直接接入CC）才可以直接用CC，否则都得用CCR来转换对吗？

    • 如果是的话，造成这种的原因是不是因为现在的各种API站默认出站都是OpenAI格式？需要转成Anthropic格式？


  • 哈雷彗星 楼主 07-20 22:45
    14楼

    全是的


    其直接接驳的 ANTHROPIC_BASE_URL 提供的服务必须是 Anthropic格式

  • marre 07-20 22:47
    15楼

    明白了，专业Anthropic客服。

  • 善解人意屬實有點害羞 07-20 22:57
    16楼

    還在施工啊 我還以為是終端美化教程

  • louder 07-20 22:59
    17楼

    感谢分享！

  • 善解人意屬實有點害羞 07-21 00:48
    18楼

    我真的愛死你了 趕緊完工吧

  • 哈雷彗星 楼主 07-21 00:49
    19楼

    来日方长

* 帖子来源Linux.do
附近帖子
返回
飞读
随机推荐