阅读视图

Any牌路由器使用清障!

3s内报403 你就 别瞎琢磨哪配错了


L站都快成Any牌路由器反馈地了
只要一波动一报错就有人问
“我不行 你行不行 你咋配的 为啥我不行 看看你配置 我4xx/5xx 我屯屯鼠 我是猪
哇脑阔噶痛啊

某日 某 快问快答 下的系统推荐帖列表 (竟恐怖如斯)

image

现在!立刻!全方位!排除所有疑问 写一个说明书
必须傻瓜版 多问一句都叉(我)出去!

基础要点

不讲且不用 CCS 等辅助编辑工具

从未使用过CC
新安装 CC 后, 是没有 ~/.claude/settings.json 文件的 (安装指南请看 《 Claude Code 终极版 FAQ 指南 》)
同时 还可能被 登录引导 过程 拦截
~/.claude.json 中顶层开关项 hasCompletedOnboarding 所控制和记录状态
顾名思义 false 即为 登录引导没有过 需要显示
反之 true 即为 已经经过 登录引导 无须再显示
所以 作为 官方服务来说 本就没有所谓的第三方API支持服务 弹出登录引导是正确且合理的行为设计
格局上来说 中国大陆不在服务支持范围 Claude Code 充其量就是一个客户端(发包器) 没有什么魔法
什么花都可以改出来,什么都能搓成你想要的样子 只要花点时间 (可以说是半开源)

此处显而易见的 你不使用官方规定提供的服务 直接打开 ~/.claude.json 搜索 hasCompletedOnboarding
如存在则直接修改值成true 如不存在则自行追加到JSON对象顶层

~/.claude.json 傻瓜对照示例 (点击了解更多详细信息) 登录引导图示 (点击了解更多详细信息)

准备工作完成 能够正常进入看到CC的Prompt输入框

image

接下来是 供应商管理和必要的基础开关项 (国情如此 不得不要)

以空的不存在的 ~/.claude/settings.json 为例进行最小化讲解
(不存在就新建!别问为什么没有,没有触发到创建的逻辑自然没有)

[!Note]+ ~/.claude/settings.json

{
 "env": {
   "HTTPS_PROXY": "http://127.0.0.1:7890",
   "HTTP_PROXY": "http://127.0.0.1:7890",
   "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
   "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
   "DISABLE_INSTALLATION_CHECKS": "1",
   "ENABLE_TOOL_SEARCH": "1"
 },
 "cleanupPeriodDays": 720,
 "model": "opus[1m]"
}

env对象属性值全部必须写为字符串 而不是布尔值或者其他!
字符串内容通常使用 “1”=“yes”=“on” / “0”=“no”=“false”
为统一化 直接写 0/1 通用百分百错不了

  • HTTP_PROXY / HTTPS_PROXY : 对CC指定代理服务器配置 一劳永逸的常规配置项 告别无脑 tun tun

  • CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC :详见 用CC,这个应该写进默认配置

    • 该项为复合设置项 同时包揽:

      • DISABLE_AUTOUPDATER 禁用自动升级
      • DISABLE_BUG_COMMAND 禁用显示 /bug 反馈 命令
      • DISABLE_ERROR_REPORTING 禁用错误报告行为
      • DISABLE_TELEMETRY 禁用遥测!
    • 可以见得 实际上这里面最起作用的是 禁用遥测 这一开关项 但我们国情如此 另外两项附带的都没啥屁用 所以一包四 挺好~ 而自动升级也不是特别必要 因为自主控制升降级 也挺好

    • 如果你需要 自动升级 那么只需让该项代换成 1项 → 3项 不写 DISABLE_AUTOUPDATER 多写另外三项 即可达成

  • CLAUDE_CODE_ATTRIBUTION_HEADER: 是否追加客户端类型区分文本 默认值是追加 详见:出结论了,Claude Code 新版本随机插入 cch 参数,第三方缓存命中率从 90% 降至 30% - #9,来自 Haleclipse

    • 该变量导出来控制是否不需要装填 billing header 到 请求体中 (默认不写就是会装填 所以写成"0",因为该值根本对我们根本没有什么作用)
    • 该内容形如 {"anthropic-billing-header: cc_version=2.1.15.c7e; cc_entrypoint=cli"}
  • DISABLE_INSTALLATION_CHECKS: 禁用安装方式检查 详见:A\ 又疯了 / 区别详细解释

    • 最直观的就是略过检查 以去除 仍在使用所谓遗弃的 npm安装方式所被提示的 黄色警告文本显示
  • ENABLE_TOOL_SEARCH: 启用ToolSearch这一Tool,该Tool的能力是将Tool们全部延后加载 在需要时会自动先调用该工具进行Tool的搜索加载 (因为默认是直接加载到上下文窗口的)

    • 可加可不加 最好不写 因为在 1M上下文窗口实际上不是特别有必要了
    • 且实际上 Sonnet / Opus 4+ 才支持这种能力
    • 为什么和什么时候需要显式指定? 详见: CC环境变量 搞点简单记录
    • 而且Anyrouter上游账号不知道会打到哪批?很有可能并不能被支持

以下是非env 设置类开关项

  • cleanupPeriodDays 用于将默认三十天删除会话记录这一时间覆盖更长 意为不需要删除旧会话 详见 : 啥毙CC 不吐不快
  • model 该项同样属于可写可不写 因为REPL交互式TUI中的 /model 选择器会默认的将选择值写到这里 所以锁全局的意义不大(如果常更换模型的话)默认值:default
    • 且此模块设计有别名系统 即 opus 早期版本可能可以指代 claude-opus-4-5-20251101 而并不需要去记忆具体的模型ID 当前版本为4.6 则 opus 会指代 claude-opus-4-6
    • 默认值别名 default 在不同账户情况下 可能会指代给 sonnet别名 或者 opus别名 具体以打开的 列表项显示为准

全局的 ~/.claude/settings.json 基础开关控制项 说完 接下来就是 三方提供商设定
此处依赖 --settings cli参数来载入更高优先级的 Profile 覆盖值 以达成灵活的供应商切换和管理, 直接创建 ~/.claude/settings.xxxx.json

以下以 anyr0uter 为例进行讲解
创建 ~/.claude/settings.anyrouter.json

[!Note]+ ~/.claude/settings.anyrouter.json

{
 "env": {
   "ANTHROPIC_BASE_URL": "https://anyrouter.top",
   "ANTHROPIC_AUTH_TOKEN": "you-token-to-here"   
 },
 "model": "opus[1m]"
}

应该写什么为什么这样写的 基础逻辑就是 --settings 参数为 整合全局内容覆盖项
只要我们不在全局中写 就可以调整到 Profile (provider) 中写

所以 这就可以解释 为什么 末尾 要写 “model” 这项模型别名指定
因为Any牌路由器已经很久不提供 Sonnet 模型了
所以根本无须考虑 切换使用 Sonnet模型 则直接锁定在推荐的 1M 模型上
但这只针对使用Anyrouter时 不会影响其他的Profile 非常灵活和方便

接下来再以一个 特别的案例对另一块迷惑误区点进行讲解:

创建 ~/.claude/settings.aliyun.json

[!Note]+ ~/.claude/settings.aliyun.json

{
 "env": {
   "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
   "ANTHROPIC_API_KEY": "you-token-to-here",
   "ANTHROPIC_DEFAULT_HAIKU_MODEL": "qwen3.5-flash",
   "ANTHROPIC_DEFAULT_SONNET_MODEL": "qwen3.5-flash",
   "ANTHROPIC_DEFAULT_OPUS_MODEL": "qwen3.5-plus"
 }
}

可以看到 我们在此处为什么会去设定 默认模型路由 而 Anyrouter 不需要?
因为Any牌路由器 提供了 claude-haiku-4-5-20251001 的模型id 这与官方完全匹配
包括 claude-opus-4-6 也是与官方匹配 当然就不需要去覆盖指定

而使用阿里云百炼的时候 模型提供商并没有提供 haiku / sonnet / opus 对等的模型id
只是模型能力体量上我们知道且可以控制其代换的模型
所以把高能力模型id塞给 opus
快速且费率低的模型id塞给 haiku
sonnet无所谓 随意指定

最后 我们撰写完成之后 就可以使用
claude --settings ~/.claude/settings.xxxx.json
加载打开不同的Profile (provider) 来使用不同的提供商配置
同样 末尾仍可以 追加 -r -c 等参数在载入不同的供应商配置时 选择继续上次会话 还是 恢复某个会话

Windows用户不理解 ~ (家目录指代) 的 请看Claude Code 使用原生 `--settings` 选项配置多个自定义模型供应商 加以理解

Q:此处的BASE_URL 应该怎么填 格式怎样
A:CC默认会追加 /v1/messages 拼接 进行 LLM请求,所以 BASE_URL 就是指 抠掉这块之前的那部分 动动你的小脑瓜 不要想当然无脑 往上自己追加 /v1 后缀

Q: API无法连接 (API Error: Unable to connect to API (ECONNRESET))?
A: 佬铁 核查网络抵达性啦 访问不到臣妾也没招w

Q: 我怎么知道供应商提供了哪些模型ID呢?
A: 通常呢 供应商会有一个 /v1/models 的端点,只要 GET请求 附带你的token到请求头中,打过去就能得到 一个 json结果 里面就是 提供的模型ID

Q: 响应码 4xx (no body)?
A: 切模型到 Opus 1M (盲猜Opus没米了)

  • 就算提问也不要光说自己得到了什么响应码错误没有响应码之神 可以透过响应码贯穿得知响应的message,这很重要
  • 那么如何得知message呢 POST打一下也就知道了 如果有的话 比如现在没有米的情况是
    image

Q: 用着用着弹xxx中断了是为何?
A: 存在这么一种情况 Haiku模型他欠费了但主模型Opus是能通的,某时刻乍一上来的时候 通过 -c 继续会话 并不会触发 Haiku 调用 继续单独打到Opus上 则不会有什么问题
但是一旦触及到Haiku调用 就boom了。他很有可能是这种情况


以上全部为手脑并用撰写,零LLM参与
如果对你有一点帮助,点击我的头像点我一个 关注
下回能再见也说不定呢w

接下来会登场的是 (点击了解更多详细信息)

1483 个帖子 - 802 位参与者

阅读完整话题

  •  

《 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-20250720191904599

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

image-20250720194855580

后续右键能够直接在所处文件夹内打开对应的终端Shell
image

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

image

3. PowerShell 7

winget install Microsoft.PowerShell

image

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

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

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

4. Notepad 4

winget install zufuliu.notepad4

image

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

5. Git for Windows

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

image

6. fnm

winget install Schniz.fnm

image

安装成功后同样关闭全部窗口 重新打开一个终端Shell
继续安装 某版本Node

fnm install lts/krypton
fnm use lts/krypton

image

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

notepad $profile

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

image

需要新建,那么我们新建

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

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

image

添加内容后保存

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

image

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

  • 使用刚才安装的版本
fnm use lts/krypton

成功应用默认 Node 版本

  • 设定 npm 镜像源
npm config set registry https://registry.npmmirror.com
  • 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code@2.1.112

或者 继续最新版

npm install -g @cometix/claude-code

毁了 全都毁了
简简单单救赎一下

image

(可选设定)美化相关

image

  • Oh My Posh
winget install JanDeDobbeleer.OhMyPosh --source winget --scope user --force

同样打开 PROFILE 新增激活 OhMyPosh

notepad $profile

image

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

image

image

主题样式很多 任君挑选 Themes | Oh My Posh


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的这个问题
      image
  • 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稳定性问题
      image
  • Q: Windows下MCP Server (Stdio) 全部无法使用?

    A: 改成 command: "cmd" 后接 arg : ["/c","npx"]

  • Q: 红色 Offline 字样是做什么用的?遥测相关会不会用于检测封号?

    A: Offline 只是用作真 连接状态检测 详见

  • Q: 官网 / 中转站 / CCR类自定义重定向API接入,在设定上有何区别

    A:


      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"


    image


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

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

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

    • v1.0.61 已经添加 --settings 参数,能够便捷化指定加载不同的settings.json配置 详细介绍移步 Any牌路由器使用清障!

      image

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

      image


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

1026 个帖子 - 425 位参与者

阅读完整话题

  •