<?xml version="1.0" encoding="UTF-8"?><rss version="2.0" xmlns:content="http://purl.org/rss/1.0/modules/content/"><channel><title>wstormai</title><description>AI 工具教程 &amp; 会员服务</description><link>https://wstormai.store/</link><language>zh_CN</language><item><title>Claude 降低封号指南：住宅 IP 配置教程</title><link>https://wstormai.store/posts/claude-anti-ban/</link><guid isPermaLink="true">https://wstormai.store/posts/claude-anti-ban/</guid><description>为什么 Claude 会封号？住宅 IP 如何降低风险？V2rayN Socks5 + TUN 模式配置图文教程，附 IP 检测工具和优惠码</description><pubDate>Tue, 17 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2&gt;为什么 Claude 会封号？&lt;/h2&gt;
&lt;p&gt;Claude 风控系统检测以下维度判断账号异常：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;IP 类型&lt;/strong&gt;：数据中心 IP（机房 IP）是最大风险因素，大量用户共用同一段 IP&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;IP 欺诈值&lt;/strong&gt;：高欺诈评分的 IP 已被标记为代理/VPN 出口&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;IP 频繁更换&lt;/strong&gt;：短时间切换不同地区 IP 触发异常登录&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;浏览器指纹&lt;/strong&gt;：时区、语言与 IP 归属地不匹配&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;IP 类型是最关键因素。&lt;/strong&gt; 使用纯净住宅 IP 可以大幅降低风控触发概率。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;什么是住宅 IP？&lt;/h2&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;类型&lt;/th&gt;
&lt;th&gt;说明&lt;/th&gt;
&lt;th&gt;风险等级&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;数据中心 IP&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;来自云服务器、VPS 机房&lt;/td&gt;
&lt;td&gt;高风险，容易被识别为代理&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;住宅 IP&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;来自真实家庭宽带运营商（ISP）&lt;/td&gt;
&lt;td&gt;低风险，与普通用户一致&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;原生住宅 IP&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;IP 注册地与服务器所在地一致&lt;/td&gt;
&lt;td&gt;最低风险&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;住宅 IP 的本质是：你的流量出口看起来像一个普通家庭用户在上网，而不是从机房发出的批量请求。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;如何检测自己的 IP 类型？&lt;/h2&gt;
&lt;p&gt;使用以下工具检测当前 IP 状态（详见 &lt;a href=&quot;/iptools/&quot;&gt;IP工具合集&lt;/a&gt;）：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href=&quot;https://ping0.cc/&quot;&gt;Ping0&lt;/a&gt;&lt;/strong&gt; — 查看 IP 是否为住宅类型&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;&lt;a href=&quot;https://scamalytics.com/&quot;&gt;Scamalytics&lt;/a&gt;&lt;/strong&gt; — 查看欺诈值评分，&lt;strong&gt;低于 30 分为优质&lt;/strong&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;如果你的 IP 显示为 &lt;code&gt;Hosting/Data Center&lt;/code&gt; 且欺诈值超过 50，那封号风险很高。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;住宅 IP 推荐&lt;/h2&gt;
&lt;p&gt;推荐使用 &lt;strong&gt;MiyaIP&lt;/strong&gt; 的住宅代理服务，特点：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;真实 ISP 住宅 IP，非机房 IP&lt;/li&gt;
&lt;li&gt;覆盖多个国家和地区&lt;/li&gt;
&lt;li&gt;支持 Socks5 协议，兼容各种客户端&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;提供中转地址&lt;/strong&gt;，国内直连速度更快更稳定&lt;/li&gt;
&lt;li&gt;适用于 Claude、ChatGPT、Google 等平台&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;a href=&quot;https://www.miyaip.com/?invitecode=8731849&quot;&gt;&lt;img src=&quot;https://www.miyaip.com/banner1.jpg&quot; alt=&quot;MiyaIP 住宅代理&quot; /&gt;&lt;/a&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;访问地址&lt;/strong&gt;：&lt;a href=&quot;https://www.miyaip.com/?invitecode=8731849&quot;&gt;https://www.miyaip.com/?invitecode=8731849&lt;/a&gt;&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;九折优惠&lt;/strong&gt;：结算时输入优惠码 &lt;strong&gt;&lt;code&gt;wstormai&lt;/code&gt;&lt;/strong&gt; 即可享受九折优惠。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;为什么推荐使用中转地址？&lt;/strong&gt; 直连住宅 IP 在国内可能不稳定或速度慢，中转地址通过优质线路转发到住宅出口，兼顾速度和 IP 纯净度。配置时优先选择平台提供的 &lt;strong&gt;中转服务器地址&lt;/strong&gt;，而非直连地址。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3&gt;V2rayN 下载地址&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;平台&lt;/th&gt;
&lt;th&gt;下载链接&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Windows 10/11&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;a href=&quot;https://xiazai.yfjc.win/1/%E7%94%B5%E8%84%91%E5%AE%A2%E6%88%B7%E7%AB%AFWin10-11&quot;&gt;点击下载&lt;/a&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;macOS&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;a href=&quot;https://xiazai.yfjc.win/1/%E8%8B%B9%E6%9E%9C%E7%94%B5%E8%84%91%E5%AE%A2%E6%88%B7%E7%AB%AF&quot;&gt;点击下载&lt;/a&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;macOS 用户注意&lt;/strong&gt;：下载安装后，如果提示应用已损坏或无法打开，请打开终端输入以下命令解除限制：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;xattr -cr /Applications/v2rayN.app
&lt;/code&gt;&lt;/pre&gt;
&lt;/blockquote&gt;
&lt;h2&gt;V2rayN Socks5 配置教程&lt;/h2&gt;
&lt;p&gt;V2rayN 是 Windows / macOS 上最常用的代理客户端，以下是配置住宅 IP（Socks5）的详细步骤。&lt;/p&gt;
&lt;h3&gt;第一步：获取住宅 IP 信息&lt;/h3&gt;
&lt;p&gt;注册 &lt;a href=&quot;https://www.miyaip.com/?invitecode=8731849&quot;&gt;MiyaIP&lt;/a&gt; 后，在控制台获取以下信息：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;中转服务器地址&lt;/strong&gt;（推荐使用中转地址，速度更快更稳定）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;端口号&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;用户名&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;密码&lt;/strong&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;第二步：添加 Socks5 服务器&lt;/h3&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;打开 V2rayN，点击顶部菜单栏 &lt;strong&gt;「配置项」&lt;/strong&gt; → &lt;strong&gt;「添加 [Socks] 服务器」&lt;/strong&gt;&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;在弹出的配置窗口中填写以下信息：&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;字段&lt;/th&gt;
&lt;th&gt;填写内容&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;别名（remarks）&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;自定义名称，方便识别（如 &lt;code&gt;cc&lt;/code&gt;）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;地址（address）&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;填写 MiyaIP 提供的 &lt;strong&gt;中转服务器地址&lt;/strong&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;端口（port）&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;填写对应的端口号（如 &lt;code&gt;8001&lt;/code&gt;）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;用户名&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;填写 MiyaIP 提供的用户名&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;密码&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;填写 MiyaIP 提供的密码&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;ol&gt;
&lt;li&gt;点击 &lt;strong&gt;「确定」&lt;/strong&gt; 保存&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;配置完成后效果如下图所示，可以看到节点类型为 SOCKS，地址指向 MiyaIP 的中转服务器，底部已开启 &lt;strong&gt;TUN 模式&lt;/strong&gt;，路由规则选择 &lt;strong&gt;绕过大陆&lt;/strong&gt;：&lt;/p&gt;
&lt;p&gt;&lt;img src=&quot;/images/v2rayn-socks5-tun-config.png&quot; alt=&quot;V2rayN 配置住宅 IP Socks5 节点并开启 TUN 模式&quot; /&gt;&lt;/p&gt;
&lt;h3&gt;第三步：开启 TUN 模式（强烈推荐）&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;这一步非常重要！&lt;/strong&gt; 特别是使用 Claude Code（命令行版 Claude）时，普通的系统代理模式只能代理浏览器流量，Claude Code 等终端程序的请求可能不走代理，导致 &lt;strong&gt;403 报错&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;开启 TUN 模式可以接管系统所有流量（包括命令行、终端程序），彻底解决这个问题：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;首先，确保 V2rayN &lt;strong&gt;以管理员身份运行&lt;/strong&gt;（右键 V2rayN → 以管理员身份运行），标题栏会显示「以管理员身份运行」字样&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;在主界面底部找到 &lt;strong&gt;「启用 Tun」&lt;/strong&gt; 开关，点击开启（开关变蓝色即为启用）&lt;/p&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;如上图所示，底部状态栏 &lt;strong&gt;「启用 Tun」&lt;/strong&gt; 开关已开启，同时路由规则建议选择 &lt;strong&gt;「V3-绕过大陆(Whitelist)」&lt;/strong&gt;，确保国内流量直连、Claude 流量走住宅 IP&lt;/p&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;TUN 模式 vs 系统代理的区别&lt;/strong&gt;：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;模式&lt;/th&gt;
&lt;th&gt;浏览器&lt;/th&gt;
&lt;th&gt;终端/命令行&lt;/th&gt;
&lt;th&gt;Claude Code&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;系统代理&lt;/td&gt;
&lt;td&gt;✅ 生效&lt;/td&gt;
&lt;td&gt;❌ 大概率不走代理&lt;/td&gt;
&lt;td&gt;❌ 403 报错&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;TUN 模式&lt;/td&gt;
&lt;td&gt;✅ 生效&lt;/td&gt;
&lt;td&gt;✅ 生效&lt;/td&gt;
&lt;td&gt;✅ 正常使用&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;如果你使用 Claude Code，必须开启 TUN 模式，否则会频繁出现 403 错误。&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3&gt;第四步：验证配置&lt;/h3&gt;
&lt;p&gt;配置完成后，验证是否生效：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;访问 &lt;a href=&quot;https://ping0.cc/&quot;&gt;Ping0&lt;/a&gt; — 确认 IP 类型显示为 &lt;strong&gt;&lt;code&gt;Residential&lt;/code&gt;&lt;/strong&gt;（住宅）&lt;/li&gt;
&lt;li&gt;访问 &lt;a href=&quot;https://scamalytics.com/&quot;&gt;Scamalytics&lt;/a&gt; — 确认欺诈值 &lt;strong&gt;低于 30&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;打开 &lt;a href=&quot;https://claude.ai&quot;&gt;Claude.ai&lt;/a&gt; — 正常登录使用&lt;/li&gt;
&lt;li&gt;如果使用 Claude Code，在终端运行测试确认无 403 报错&lt;/li&gt;
&lt;/ol&gt;
&lt;hr /&gt;
&lt;h2&gt;其他降低封号的建议&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;不要频繁切换 IP 地区&lt;/strong&gt;，选定一个地区后固定使用&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;浏览器时区和语言&lt;/strong&gt; 要与 IP 归属地匹配（美国 IP 就用英语 + 美国时区）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;不要多设备同时登录&lt;/strong&gt; 同一账号&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;避免短时间大量请求&lt;/strong&gt;，正常使用节奏即可&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;使用官方客户端&lt;/strong&gt; 或浏览器访问，不要用非官方工具&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Claude Code 用户务必开启 TUN 模式&lt;/strong&gt;，避免 403 问题&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;
&lt;h2&gt;相关教程&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;Claude Code 报 403？→ &lt;a href=&quot;/posts/claude-code-403/&quot;&gt;报错 403 的原理与解决办法&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;Claude Code 怎么用？→ &lt;a href=&quot;/posts/claude-code-tutorial/&quot;&gt;Claude Code 完整教程&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;IP 检测工具 → &lt;a href=&quot;/iptools/&quot;&gt;IP 工具合集&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;
&lt;h2&gt;相关服务&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;需要谷歌账号 / Claude Pro？→ &lt;a href=&quot;/store/&quot;&gt;AI 会员商店&lt;/a&gt;（支付宝付款，自动发货）&lt;/li&gt;
&lt;li&gt;需要接收 Claude 验证码？→ &lt;a href=&quot;/sms/&quot;&gt;Claude 接码服务&lt;/a&gt;（美国实体手机号）&lt;/li&gt;
&lt;li&gt;IP 检测工具合集 → &lt;a href=&quot;/posts/ip-tools/&quot;&gt;IP 工具&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;
&lt;h2&gt;免责声明&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文内容仅供技术学习与交流，旨在帮助用户了解网络协议、IP 类型等计算机网络基础知识，不构成任何使用建议或行为指导。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;本文不提供、不推广任何翻墙工具或非法跨境网络访问服务&lt;/li&gt;
&lt;li&gt;用户应自行遵守《中华人民共和国计算机信息网络国际联网管理暂行规定》《网络安全法》《数据安全法》等相关法律法规&lt;/li&gt;
&lt;li&gt;因读者自行使用本文提及的技术方案所产生的一切法律后果，由使用者本人承担，与本站及作者无关&lt;/li&gt;
&lt;li&gt;本文涉及的第三方服务（包括但不限于 Claude、V2rayN 等）的使用条款由各平台制定，请自行查阅并遵守&lt;/li&gt;
&lt;li&gt;如本文内容与当地法律法规存在冲突，请以法律法规为准，并请勿参考本文相关内容&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;请合法合规使用互联网，共同维护良好的网络环境。&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded></item><item><title>IP 工具合集：查询类型、欺诈值检测、Ping 延迟、测速</title><link>https://wstormai.store/posts/ip-tools/</link><guid isPermaLink="true">https://wstormai.store/posts/ip-tools/</guid><description>精选实用 IP 工具合集：Ping0 查 IP 类型、Scamalytics 查欺诈值、ITDog 多地 Ping 延迟、Speedtest 测速、Whois 域名查询，一站式检测代理节点质量</description><pubDate>Tue, 17 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2&gt;IP 查询与检测&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;IP 地址查询&lt;/strong&gt;：&lt;a href=&quot;https://whatismyipaddress.com/&quot;&gt;WhatIsMyIPAddress&lt;/a&gt;
（查看当前网络的公网 IP 地址、归属地、ISP 运营商信息）&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;IP 类型检测&lt;/strong&gt;：&lt;a href=&quot;https://ping0.cc/&quot;&gt;Ping0&lt;/a&gt;
（识别当前 IP 的类型：原生 / 广播、住宅 / 数据中心，并显示 AS 信息）&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;IP 欺诈值查询&lt;/strong&gt;：&lt;a href=&quot;https://scamalytics.com/&quot;&gt;Scamalytics&lt;/a&gt;
（检测 IP 的欺诈风险评分，&lt;strong&gt;分值越低代表 IP 越干净&lt;/strong&gt;，常用于判断代理 IP 质量）&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;网络延迟与线路测试&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;多地 Ping 测试&lt;/strong&gt;：&lt;a href=&quot;https://www.itdog.cn/ping/&quot;&gt;ITDog Ping&lt;/a&gt;
（从全国多个节点对目标地址进行 Ping 延迟测试，支持 ICMP 协议，直观展示各地到服务器的网络延迟）&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;本地网络环境检测&lt;/strong&gt;：&lt;a href=&quot;https://www.itdog.cn/localhost/&quot;&gt;ITDog 综合检测&lt;/a&gt;
（一站式检测本地网络环境，包括：）&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;IPv6 连通性检测&lt;/li&gt;
&lt;li&gt;线路分流检测（电信 / 联通 / 移动走向）&lt;/li&gt;
&lt;li&gt;IP 泄露测试&lt;/li&gt;
&lt;li&gt;DNS 出口泄露测试&lt;/li&gt;
&lt;li&gt;多地 IP 回程测试&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;
&lt;h2&gt;测速与域名工具&lt;/h2&gt;
&lt;p&gt;&lt;strong&gt;网络测速&lt;/strong&gt;：&lt;a href=&quot;https://www.speedtest.net/zh-Hans&quot;&gt;Speedtest&lt;/a&gt;
（测试当前网络的下载速度、上传速度和延迟，支持选择测速节点）&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;域名 Whois 查询&lt;/strong&gt;：&lt;a href=&quot;https://whoiscx.com/&quot;&gt;WhoisCX&lt;/a&gt;
（查询域名的注册信息、到期时间、注册商、DNS 服务器等详细信息）&lt;/p&gt;
&lt;hr /&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;使用建议&lt;/strong&gt;：测试代理节点质量时，建议依次使用 Ping0（看 IP 类型）→ Scamalytics（看欺诈值）→ Speedtest（看速度）→ ITDog Ping（看延迟）进行综合评估。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr /&gt;
&lt;h2&gt;相关教程&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;为什么 IP 类型很重要？→ &lt;a href=&quot;/posts/claude-anti-ban/&quot;&gt;Claude 降低封号指南：住宅 IP 配置教程&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;Claude Code 报 403 怎么办？→ &lt;a href=&quot;/posts/claude-code-403/&quot;&gt;Claude Code 报错 403 解决办法&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;
&lt;h2&gt;相关服务&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;需要纯净谷歌账号？→ &lt;a href=&quot;/store/&quot;&gt;商店购买&lt;/a&gt;（8-12个月老号）&lt;/li&gt;
&lt;li&gt;Claude 注册验证码 → &lt;a href=&quot;/sms/&quot;&gt;接码服务&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;Claude Code 报 403？→ &lt;a href=&quot;/posts/claude-code-403/&quot;&gt;解决办法&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;
&lt;h2&gt;免责声明&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文内容仅供技术学习与交流，旨在介绍网络诊断与 IP 检测相关工具，不构成任何使用建议或行为指导。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;本文不提供、不推广任何翻墙工具或非法跨境网络访问服务&lt;/li&gt;
&lt;li&gt;用户应自行遵守《中华人民共和国计算机信息网络国际联网管理暂行规定》《网络安全法》《数据安全法》等相关法律法规&lt;/li&gt;
&lt;li&gt;中国大陆对网络接入与跨境通信有严格法律要求，因读者自行使用本文提及的工具所产生的一切法律后果，由使用者本人承担&lt;/li&gt;
&lt;li&gt;如本文内容与当地法律法规存在冲突，请以法律法规为准，并请勿参考本文相关内容&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;请合法合规使用互联网，共同维护良好的网络环境。&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded></item><item><title>Claude 注册全流程：从零开始注册 Claude 账号（2026 最新）</title><link>https://wstormai.store/posts/claude-register/</link><guid isPermaLink="true">https://wstormai.store/posts/claude-register/</guid><description>2026 最新 Claude 注册教程：准备谷歌账号、获取美国手机号、完成短信验证，一站式解决注册难题</description><pubDate>Sat, 21 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2&gt;注册前准备&lt;/h2&gt;
&lt;p&gt;注册 Claude 需要以下三样东西：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;准备项&lt;/th&gt;
&lt;th&gt;说明&lt;/th&gt;
&lt;th&gt;获取方式&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;谷歌账号&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;用于 OAuth 登录 Claude&lt;/td&gt;
&lt;td&gt;&lt;a href=&quot;/store/&quot;&gt;商店购买老号&lt;/a&gt;（推荐）或自行注册&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;美国手机号&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;接收短信验证码&lt;/td&gt;
&lt;td&gt;&lt;a href=&quot;/sms/&quot;&gt;Claude 接码服务&lt;/a&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;纯净 IP&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;避免触发风控&lt;/td&gt;
&lt;td&gt;&lt;a href=&quot;/posts/claude-anti-ban/&quot;&gt;住宅 IP 配置教程&lt;/a&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;为什么推荐买老号？&lt;/strong&gt; 新注册的谷歌账号容易触发 Claude 的风控，8个月以上的老号通过率更高。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr /&gt;
&lt;h2&gt;第一步：准备谷歌账号&lt;/h2&gt;
&lt;h3&gt;方案一：购买现成老号（推荐）&lt;/h3&gt;
&lt;ol&gt;
&lt;li&gt;前往 &lt;a href=&quot;/store/&quot;&gt;商店&lt;/a&gt; 购买谷歌账号&lt;/li&gt;
&lt;li&gt;支付宝付款后自动获得卡密&lt;/li&gt;
&lt;li&gt;在商店页面输入卡密，提取账号信息（邮箱 + 密码 + 2FA 密钥）&lt;/li&gt;
&lt;li&gt;前往 &lt;a href=&quot;https://2fa.run&quot;&gt;2fa.run&lt;/a&gt; 输入 2FA 密钥获取动态验证码&lt;/li&gt;
&lt;li&gt;登录谷歌后 &lt;strong&gt;立即修改密码&lt;/strong&gt;&lt;/li&gt;
&lt;/ol&gt;
&lt;h3&gt;方案二：自行注册&lt;/h3&gt;
&lt;p&gt;如果选择自行注册谷歌账号，建议：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;使用纯净住宅 IP 注册&lt;/li&gt;
&lt;li&gt;注册后养号至少一周再用于 Claude&lt;/li&gt;
&lt;li&gt;绑定手机号和辅助邮箱&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;
&lt;h2&gt;第二步：获取美国手机号&lt;/h2&gt;
&lt;p&gt;Claude 注册必须通过美国手机号短信验证，虚拟号码（如 Google Voice）通常无法通过验证。&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;前往 &lt;a href=&quot;/sms/&quot;&gt;Claude 接码服务&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;输入卡密（&lt;a href=&quot;/store/&quot;&gt;商店购买&lt;/a&gt; · &lt;a href=&quot;https://m.tb.cn/h.ignzAZj?tk=PTlmUBA42MM&quot;&gt;闲鱼购买&lt;/a&gt;）&lt;/li&gt;
&lt;li&gt;点击「获取美国号码」，系统分配一个美国实体手机号&lt;/li&gt;
&lt;li&gt;将号码复制到 Claude 注册页面&lt;/li&gt;
&lt;li&gt;等待验证码（通常 30 秒内到达）&lt;/li&gt;
&lt;li&gt;2 分钟内未收到可点击「换号重试」&lt;/li&gt;
&lt;/ol&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;提示&lt;/strong&gt;：每张卡密可获取 3 次号码（含换号），确保验证成功率。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr /&gt;
&lt;h2&gt;第三步：注册 Claude&lt;/h2&gt;
&lt;ol&gt;
&lt;li&gt;打开 &lt;a href=&quot;https://claude.ai&quot;&gt;claude.ai&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;点击 &lt;strong&gt;Continue with Google&lt;/strong&gt;，使用准备好的谷歌账号登录&lt;/li&gt;
&lt;li&gt;进入手机号验证页面&lt;/li&gt;
&lt;li&gt;国家选择 &lt;strong&gt;United States (+1)&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;输入从接码服务获取的美国手机号（不含 +1 前缀）&lt;/li&gt;
&lt;li&gt;点击发送验证码&lt;/li&gt;
&lt;li&gt;回到接码页面复制验证码，填入 Claude&lt;/li&gt;
&lt;li&gt;完成注册！&lt;/li&gt;
&lt;/ol&gt;
&lt;hr /&gt;
&lt;h2&gt;第四步：确保账号安全&lt;/h2&gt;
&lt;p&gt;注册成功后，做以下几件事降低封号风险：&lt;/p&gt;
&lt;h3&gt;使用纯净 IP&lt;/h3&gt;
&lt;p&gt;Claude 对 IP 类型非常敏感，数据中心 IP 会导致 403 或封号：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;使用住宅 IP 访问（&lt;a href=&quot;/posts/claude-anti-ban/&quot;&gt;配置教程&lt;/a&gt;）&lt;/li&gt;
&lt;li&gt;不要频繁切换 IP 地区&lt;/li&gt;
&lt;li&gt;用 &lt;a href=&quot;https://ping0.cc/&quot;&gt;Ping0&lt;/a&gt; 检测 IP 类型，确保显示 &lt;code&gt;Residential&lt;/code&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;正常使用习惯&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;不要短时间内大量请求&lt;/li&gt;
&lt;li&gt;不要使用自动化脚本批量操作&lt;/li&gt;
&lt;li&gt;保持稳定的使用频率&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;
&lt;h2&gt;常见问题&lt;/h2&gt;
&lt;h3&gt;Q: 注册时提示 &quot;Unable to create account&quot;？&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;换一个谷歌账号试试（老号成功率更高）&lt;/li&gt;
&lt;li&gt;确保使用的是住宅 IP，不是机房 IP&lt;/li&gt;
&lt;li&gt;清除浏览器缓存后重试&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;Q: 手机号验证收不到码？&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;在 &lt;a href=&quot;/sms/&quot;&gt;接码服务&lt;/a&gt; 点击「换号重试」&lt;/li&gt;
&lt;li&gt;确保号码正确输入（不含 +1 前缀）&lt;/li&gt;
&lt;li&gt;每张卡密有 3 次机会&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;Q: 注册成功但登录 403？&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;参考 &lt;a href=&quot;/posts/claude-code-403/&quot;&gt;403 解决办法&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;开启 TUN 模式 + 住宅 IP&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;Q: 想用 Claude Code？&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;参考 &lt;a href=&quot;/posts/claude-code-tutorial/&quot;&gt;Claude Code 安装教程&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;终端环境需要 TUN 模式或设置代理环境变量&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;
&lt;h2&gt;注册流程总结&lt;/h2&gt;
&lt;pre&gt;&lt;code&gt;准备谷歌账号 → 获取美国手机号 → 注册 Claude → 配置住宅 IP
   ↓               ↓                              ↓
 商店购买          接码服务                    IP 配置教程
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;完成以上步骤，你就拥有了一个可以正常使用的 Claude 账号。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;相关资源&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/store/&quot;&gt;AI 会员商店&lt;/a&gt; — Claude Pro / ChatGPT Plus / Super Grok / 谷歌账号，支付宝付款自动发货&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/sms/&quot;&gt;Claude 接码服务&lt;/a&gt; — 美国实体手机号验证码&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/posts/claude-anti-ban/&quot;&gt;住宅 IP 配置教程&lt;/a&gt; — 降低封号风险&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/posts/claude-code-tutorial/&quot;&gt;Claude Code 安装教程&lt;/a&gt; — 终端使用 Claude&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/posts/claude-tips/&quot;&gt;Claude 实用技巧&lt;/a&gt; — Prompt 模板和使用技巧&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/posts/ip-tools/&quot;&gt;IP 工具合集&lt;/a&gt; — 检测 IP 类型和质量&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;
&lt;h2&gt;免责声明&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文内容仅供技术学习与交流，旨在介绍 Claude AI 平台的注册流程，不构成任何使用建议或行为指导。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;本文不提供、不推广任何翻墙工具或非法跨境网络访问服务&lt;/li&gt;
&lt;li&gt;用户应自行遵守《中华人民共和国计算机信息网络国际联网管理暂行规定》《网络安全法》《数据安全法》等相关法律法规&lt;/li&gt;
&lt;li&gt;使用境外 AI 服务需自行确保访问方式合法合规，因此产生的一切法律后果由使用者本人承担&lt;/li&gt;
&lt;li&gt;如本文内容与当地法律法规存在冲突，请以法律法规为准，并请勿参考本文相关内容&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;请合法合规使用互联网，共同维护良好的网络环境。&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded></item><item><title>Claude 实用技巧：让 AI 更好地帮你干活</title><link>https://wstormai.store/posts/claude-tips/</link><guid isPermaLink="true">https://wstormai.store/posts/claude-tips/</guid><description>Claude 使用技巧合集：如何写出高效 Prompt、善用 Projects 和 Artifacts、搭配 Claude Code 实现复杂任务，附常用 Prompt 模板</description><pubDate>Fri, 20 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2&gt;写出好 Prompt 的核心原则&lt;/h2&gt;
&lt;p&gt;很多人用 Claude 的方式是「一句话丢过去」，然后抱怨回答不好。其实 Claude 的输出质量 &lt;strong&gt;80% 取决于你怎么问&lt;/strong&gt;。&lt;/p&gt;
&lt;h3&gt;1. 给角色，定边界&lt;/h3&gt;
&lt;pre&gt;&lt;code&gt;你是一个资深的 Python 后端工程师，精通 FastAPI 和 PostgreSQL。
请帮我设计一个用户认证系统的数据库模型。
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;比起直接说「帮我写个登录系统」，给角色定义能让 Claude 的回答 &lt;strong&gt;更专业、更聚焦&lt;/strong&gt;。&lt;/p&gt;
&lt;h3&gt;2. 给示例，定格式&lt;/h3&gt;
&lt;p&gt;不要说「帮我整理数据」，而是：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;请把以下数据整理成表格，格式如下：

| 名称 | 价格 | 评分 |
|------|------|------|
| 示例 | ¥99 | 4.5  |

数据：iPhone 16 售价 6999 评分 4.8，Pixel 9 售价 5999 评分 4.6...
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;给了示例，Claude 就知道你要什么。&lt;/strong&gt;&lt;/p&gt;
&lt;h3&gt;3. 分步骤，拆任务&lt;/h3&gt;
&lt;p&gt;复杂任务不要一次全塞给 Claude，拆开来效果更好：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;第一步：分析这段代码的逻辑，用中文解释每个函数的作用
第二步：找出潜在的 bug 和性能问题
第三步：给出修改建议，不要直接改代码
&lt;/code&gt;&lt;/pre&gt;
&lt;hr /&gt;
&lt;h2&gt;善用 Projects（项目知识库）&lt;/h2&gt;
&lt;p&gt;Claude Pro/Max 用户可以使用 &lt;strong&gt;Projects&lt;/strong&gt; 功能，相当于给 Claude 一个「长期记忆」：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;上传文档&lt;/strong&gt;：把 API 文档、设计稿、需求文档丢进去，Claude 可以随时引用&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;设置 Instructions&lt;/strong&gt;：定义项目规则，比如「用中文回答」「代码用 TypeScript」&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;跨对话记忆&lt;/strong&gt;：同一个 Project 下的对话共享上下文&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;适用场景&lt;/strong&gt;：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;场景&lt;/th&gt;
&lt;th&gt;怎么用&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;开发项目&lt;/td&gt;
&lt;td&gt;上传 README、架构文档，让 Claude 理解项目背景&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;学术研究&lt;/td&gt;
&lt;td&gt;上传论文 PDF，让 Claude 帮你总结和对比&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;内容创作&lt;/td&gt;
&lt;td&gt;设置写作风格、受众定义，保持风格一致&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;hr /&gt;
&lt;h2&gt;Artifacts 的妙用&lt;/h2&gt;
&lt;p&gt;Artifacts 是 Claude 的「创作画板」，可以生成独立的内容块：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;代码文件&lt;/strong&gt; — 生成完整可运行的代码，支持预览&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;网页&lt;/strong&gt; — 直接生成 HTML/CSS/JS 页面，实时预览&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;SVG 图表&lt;/strong&gt; — 流程图、架构图、数据可视化&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Markdown 文档&lt;/strong&gt; — 报告、方案、文档&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;技巧&lt;/strong&gt;：用「请生成一个 Artifact」明确告诉 Claude 你想要独立的输出，而不是嵌在对话里的代码块。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;Claude Code 进阶用法&lt;/h2&gt;
&lt;p&gt;如果你已经装了 Claude Code（&lt;a href=&quot;/posts/claude-code-tutorial/&quot;&gt;安装教程&lt;/a&gt;），这些技巧能大幅提升效率：&lt;/p&gt;
&lt;h3&gt;CLAUDE.md — 项目级指令&lt;/h3&gt;
&lt;p&gt;在项目根目录创建 &lt;code&gt;CLAUDE.md&lt;/code&gt; 文件，Claude Code 每次启动都会读取：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;# 项目规则

- 使用 TypeScript，严格模式
- 测试框架用 Vitest
- 提交信息用中文
- 不要修改 .env 文件
- API 路由放在 src/routes/ 下
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;常用命令速查&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;命令&lt;/th&gt;
&lt;th&gt;作用&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;/compact&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;压缩上下文，释放 token&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;/clear&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;清空对话历史&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;/cost&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;查看本次会话 token 消耗&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;claude --model opus&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;指定使用 Opus 模型&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;claude --chat&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;只对话不修改文件&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;h3&gt;高效工作流&lt;/h3&gt;
&lt;ol&gt;
&lt;li&gt;&lt;strong&gt;先 &lt;code&gt;/chat&lt;/code&gt; 讨论方案&lt;/strong&gt;，对齐思路后再让它动手改代码&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;用 Git 分支保护&lt;/strong&gt;：在新分支上让 Claude Code 操作，review 后再合并&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;给明确的边界&lt;/strong&gt;：「只修改 src/utils/auth.ts，不要动其他文件」&lt;/li&gt;
&lt;/ol&gt;
&lt;hr /&gt;
&lt;h2&gt;常用 Prompt 模板&lt;/h2&gt;
&lt;h3&gt;代码审查&lt;/h3&gt;
&lt;pre&gt;&lt;code&gt;请审查以下代码，关注：
1. 安全漏洞（注入、XSS 等）
2. 性能问题
3. 可维护性
4. 命名规范

只列出有问题的部分，不要重写整段代码。
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;技术方案设计&lt;/h3&gt;
&lt;pre&gt;&lt;code&gt;我需要实现 [功能描述]。
技术栈：[列出技术栈]
约束条件：[性能要求/兼容性等]

请给出 2-3 个方案，对比优缺点，推荐一个并说明理由。
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;文档写作&lt;/h3&gt;
&lt;pre&gt;&lt;code&gt;请为以下 API 写技术文档：
- 包含接口说明、请求参数、返回格式、错误码
- 给出 curl 和 Python 调用示例
- 用中文撰写
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;学习助手&lt;/h3&gt;
&lt;pre&gt;&lt;code&gt;我正在学习 [主题]，我的背景是 [你的背景]。
请用类比的方式解释 [概念]，由浅入深，
每解释一步给我一个练习题验证理解。
&lt;/code&gt;&lt;/pre&gt;
&lt;hr /&gt;
&lt;h2&gt;相关资源&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;&lt;a href=&quot;/posts/claude-code-tutorial/&quot;&gt;Claude Code 完整安装教程&lt;/a&gt; — 从零开始使用 Claude Code&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/posts/claude-anti-ban/&quot;&gt;Claude 降低封号指南&lt;/a&gt; — 住宅 IP 降低风控风险&lt;/li&gt;
&lt;li&gt;&lt;a href=&quot;/claude/&quot;&gt;Claude AI 工具合集&lt;/a&gt; — 官方入口、客户端、第三方工具&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;
&lt;p&gt;持续更新中，欢迎收藏。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;相关服务&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;还没有 Claude 账号？→ &lt;a href=&quot;/sms/&quot;&gt;Claude 接码服务&lt;/a&gt; + &lt;a href=&quot;/store/&quot;&gt;AI 会员商店&lt;/a&gt;（谷歌账号 / Claude Pro）&lt;/li&gt;
&lt;li&gt;Claude Code 安装 → &lt;a href=&quot;/posts/claude-code-tutorial/&quot;&gt;完整教程&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;降低封号风险 → &lt;a href=&quot;/posts/claude-anti-ban/&quot;&gt;住宅 IP 配置指南&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;
&lt;h2&gt;免责声明&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文内容仅供技术学习与交流，旨在分享 Claude AI 的使用技巧，不构成任何使用建议或行为指导。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;本文不提供、不推广任何翻墙工具或非法跨境网络访问服务&lt;/li&gt;
&lt;li&gt;用户应自行遵守《中华人民共和国计算机信息网络国际联网管理暂行规定》《网络安全法》《数据安全法》等相关法律法规&lt;/li&gt;
&lt;li&gt;使用境外 AI 服务需自行确保访问方式合法合规，因此产生的一切法律后果由使用者本人承担&lt;/li&gt;
&lt;li&gt;如本文内容与当地法律法规存在冲突，请以法律法规为准，并请勿参考本文相关内容&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;请合法合规使用互联网，共同维护良好的网络环境。&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded></item><item><title>Claude 全系列报错 403 Forbidden 解决办法（TUN 模式）</title><link>https://wstormai.store/posts/claude-code-403/</link><guid isPermaLink="true">https://wstormai.store/posts/claude-code-403/</guid><description>Claude Code、VSCode 插件、Claude 桌面客户端、Cowork 报 403 的原理与解决方案：系统代理不覆盖终端/客户端，IP 被风控拦截。V2rayN 开启 TUN 模式 + 住宅 IP 一劳永逸</description><pubDate>Wed, 18 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2&gt;现象描述&lt;/h2&gt;
&lt;p&gt;使用 Claude 相关工具时，突然报错：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;Error: 403 Forbidden
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;不同产品的具体表现：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;产品&lt;/th&gt;
&lt;th&gt;403 表现&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Claude Code（终端）&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;执行 &lt;code&gt;claude&lt;/code&gt; 命令后直接返回 403&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;VSCode Claude 插件&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;插件无法连接，提示认证失败或请求被拒绝&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Claude 桌面客户端&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;打开后无法发送消息，提示 403 或网络错误&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Claude Cowork&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;协作功能无法加载，请求被服务器拒绝&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;共同特征：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;浏览器访问 claude.ai 正常，但客户端/终端/插件不行&lt;/li&gt;
&lt;li&gt;时好时坏，偶尔能用偶尔 403&lt;/li&gt;
&lt;li&gt;换了网络环境后突然恢复&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;如果你遇到以上情况，本文将从原理层面分析原因，并给出彻底的解决方案。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;403 的本质原因&lt;/h2&gt;
&lt;p&gt;403 Forbidden 不是密码错误，也不是账号被封，而是 &lt;strong&gt;Anthropic 的服务器拒绝了你的请求&lt;/strong&gt;。被拒绝的核心原因只有一个：&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;你的 IP 地址被 Anthropic 的风控系统判定为异常。&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;Anthropic 的风控会检测以下维度：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;检测维度&lt;/th&gt;
&lt;th&gt;说明&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;IP 类型&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;数据中心 IP（机房 IP）会被直接拦截&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;IP 欺诈值&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;高欺诈评分的 IP 被标记为代理/VPN&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;IP 黑名单&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;已知的代理服务出口 IP 被封锁&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;请求频率&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;同一 IP 大量 API 请求触发限流&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;大多数 403 的直接原因是：&lt;strong&gt;你用的是机房 IP（数据中心 IP），不是住宅 IP。&lt;/strong&gt;&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;为什么浏览器能用，终端却 403？&lt;/h2&gt;
&lt;p&gt;这是最让人困惑的地方。明明挂了代理，浏览器访问 claude.ai 正常，但 Claude Code 或 VSCode 插件却报 403。&lt;/p&gt;
&lt;p&gt;原因在于 &lt;strong&gt;代理的工作模式不同&lt;/strong&gt;：&lt;/p&gt;
&lt;h3&gt;系统代理模式（HTTP Proxy）&lt;/h3&gt;
&lt;pre&gt;&lt;code&gt;浏览器           ──→  系统代理  ──→  代理服务器  ──→  Claude API  ✅
终端程序         ──→  直连      ──→  Claude API  ❌ (真实IP)
Claude Code      ──→  直连      ──→  Claude API  ❌ (403!)
VSCode 插件      ──→  直连      ──→  Claude API  ❌ (403!)
Claude 桌面客户端 ──→  直连      ──→  Claude API  ❌ (403!)
Cowork           ──→  直连      ──→  Claude API  ❌ (403!)
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;系统代理（HTTP Proxy）只对 &lt;strong&gt;主动读取系统代理设置的程序&lt;/strong&gt; 生效。浏览器会读取系统代理，但终端程序、CLI 工具、编辑器插件、Electron 客户端 &lt;strong&gt;不会自动走系统代理&lt;/strong&gt;。&lt;/p&gt;
&lt;p&gt;这意味着：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;浏览器 → 走代理 → 住宅 IP → 正常&lt;/li&gt;
&lt;li&gt;Claude Code / 桌面客户端 / Cowork → 不走代理 → 真实 IP / 机房 IP → &lt;strong&gt;403&lt;/strong&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;TUN 模式（虚拟网卡）&lt;/h3&gt;
&lt;pre&gt;&lt;code&gt;浏览器           ──→  TUN虚拟网卡  ──→  代理服务器  ──→  Claude API  ✅
终端程序         ──→  TUN虚拟网卡  ──→  代理服务器  ──→  Claude API  ✅
Claude Code      ──→  TUN虚拟网卡  ──→  代理服务器  ──→  Claude API  ✅
VSCode 插件      ──→  TUN虚拟网卡  ──→  代理服务器  ──→  Claude API  ✅
Claude 桌面客户端 ──→  TUN虚拟网卡  ──→  代理服务器  ──→  Claude API  ✅
Cowork           ──→  TUN虚拟网卡  ──→  代理服务器  ──→  Claude API  ✅
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;TUN 模式在系统网络层创建一个虚拟网卡，&lt;strong&gt;接管所有程序的网络流量&lt;/strong&gt;，不管程序是否支持代理设置。这就是为什么 TUN 模式能彻底解决所有 Claude 产品的 403 问题。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;解决方案&lt;/h2&gt;
&lt;h3&gt;方案一：V2rayN 开启 TUN 模式（推荐）&lt;/h3&gt;
&lt;p&gt;这是最简单有效的方案，适用于 Windows 和 macOS。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;前提条件&lt;/strong&gt;：需要有一个纯净的住宅 IP 节点。如果你还没有，可以参考 &lt;a href=&quot;/posts/claude-anti-ban/&quot;&gt;纯净住宅 IP 配置指南&lt;/a&gt; 获取。&lt;/p&gt;
&lt;h4&gt;Windows 操作步骤&lt;/h4&gt;
&lt;ol&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;以管理员身份运行 V2rayN&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;右键 V2rayN → 以管理员身份运行&lt;/li&gt;
&lt;li&gt;标题栏会显示「以管理员身份运行」字样&lt;/li&gt;
&lt;li&gt;⚠️ 不以管理员运行则 TUN 模式无法生效&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;开启 TUN 模式&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;在主界面底部找到 &lt;strong&gt;「启用 Tun」&lt;/strong&gt; 开关&lt;/li&gt;
&lt;li&gt;点击开启（开关变蓝色即为启用）&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;设置路由规则&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;路由规则选择 &lt;strong&gt;「V3-绕过大陆(Whitelist)」&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;这样国内流量直连不受影响，Claude 流量走住宅 IP&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;
&lt;p&gt;&lt;strong&gt;验证是否生效&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;打开终端，运行 &lt;code&gt;curl https://api.ip.sb/ip&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;如果返回的是你的住宅 IP 地址，说明 TUN 模式已生效&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;/ol&gt;
&lt;h4&gt;macOS 操作步骤&lt;/h4&gt;
&lt;ol&gt;
&lt;li&gt;打开 V2rayN（如果提示无法打开，终端执行 &lt;code&gt;xattr -cr /Applications/v2rayN.app&lt;/code&gt;）&lt;/li&gt;
&lt;li&gt;同样开启 TUN 模式并设置绕过大陆路由规则&lt;/li&gt;
&lt;li&gt;macOS 可能需要在系统偏好设置中允许 V2rayN 的网络扩展权限&lt;/li&gt;
&lt;/ol&gt;
&lt;h3&gt;方案二：手动设置环境变量（备选）&lt;/h3&gt;
&lt;p&gt;如果无法使用 TUN 模式，可以手动为终端设置代理环境变量：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;# 设置代理（端口以你自己代理软件实际放出的端口为准）
export https_proxy=http://127.0.0.1:端口号
export http_proxy=http://127.0.0.1:端口号
export all_proxy=socks5://127.0.0.1:端口号

# 然后运行 Claude Code
claude
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;可以将这些环境变量写入 &lt;code&gt;~/.bashrc&lt;/code&gt; 或 &lt;code&gt;~/.zshrc&lt;/code&gt; 使其永久生效：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;echo &apos;export https_proxy=http://127.0.0.1:端口号&apos; &amp;gt;&amp;gt; ~/.bashrc
echo &apos;export http_proxy=http://127.0.0.1:端口号&apos; &amp;gt;&amp;gt; ~/.bashrc
echo &apos;export all_proxy=socks5://127.0.0.1:端口号&apos; &amp;gt;&amp;gt; ~/.bashrc
source ~/.bashrc
&lt;/code&gt;&lt;/pre&gt;
&lt;blockquote&gt;
&lt;p&gt;⚠️ 注意：这个方法仅对终端中的 Claude Code 有效，VSCode 插件可能仍需 TUN 模式。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h4&gt;方案二补充：让 Claude 桌面客户端也继承代理&lt;/h4&gt;
&lt;p&gt;环境变量只对终端中的 Claude Code CLI 生效。如果你使用的是 &lt;strong&gt;Claude 桌面客户端&lt;/strong&gt;（macOS），需要从终端带代理环境启动它，否则桌面客户端不会走代理。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;操作步骤（分两步确认）：&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;第一步：彻底退出 Claude&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;必须先完全退出 Claude，否则新启动的实例不会继承终端的环境变量：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;右键点击 Dock 栏中的 Claude 图标 → 选择 &lt;strong&gt;Quit&lt;/strong&gt;（彻底退出）&lt;/li&gt;
&lt;li&gt;⚠️ 不要只关窗口，必须 Quit 彻底退出进程&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;第二步：在终端带代理启动 Claude&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;打开终端，逐行输入以下命令（每输完一行按回车）：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;export http_proxy=http://127.0.0.1:端口号
export https_proxy=http://127.0.0.1:端口号
open -a Claude
&lt;/code&gt;&lt;/pre&gt;
&lt;blockquote&gt;
&lt;p&gt;端口号以你自己代理软件设置中显示的本地监听端口为准。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;p&gt;&lt;strong&gt;确认是否生效：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;Dock 栏的 Claude 图标重新亮起 = 启动成功&lt;/li&gt;
&lt;li&gt;终端没有任何输出 = 正常（无输出就是成功）&lt;/li&gt;
&lt;li&gt;如果提示 &lt;code&gt;The file /Applications/Claude.app does not exist&lt;/code&gt;，说明客户端安装路径不同，需要调整路径&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;第三步：验证代理是否继承&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;在 Claude 桌面客户端中发送任何消息，如果正常回复不再 403，说明代理环境已成功继承。&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;💡 &lt;strong&gt;原理&lt;/strong&gt;：macOS 中通过 &lt;code&gt;open -a&lt;/code&gt; 启动的应用会继承当前终端 Shell 的环境变量，包括 &lt;code&gt;http_proxy&lt;/code&gt; 和 &lt;code&gt;https_proxy&lt;/code&gt;。所以从设置了代理变量的终端启动 Claude，Claude 就会走代理。但如果是从 Dock 或 Launchpad 直接点击启动，则不会继承任何终端环境变量。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3&gt;方案三：VSCode 代理设置（仅 VSCode 插件）&lt;/h3&gt;
&lt;p&gt;如果只是 VSCode 插件报 403，可以在 VSCode 中配置代理：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;打开 VSCode 设置（&lt;code&gt;Ctrl + ,&lt;/code&gt;）&lt;/li&gt;
&lt;li&gt;搜索 &lt;code&gt;proxy&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;在 &lt;strong&gt;Http: Proxy&lt;/strong&gt; 中填写代理地址：&lt;code&gt;http://127.0.0.1:端口号&lt;/code&gt;（端口以你代理软件为准）&lt;/li&gt;
&lt;li&gt;重启 VSCode&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;但这种方式不一定对所有插件生效，&lt;strong&gt;TUN 模式仍然是最可靠的方案&lt;/strong&gt;。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;为什么住宅 IP 这么重要？&lt;/h2&gt;
&lt;p&gt;即使你开了 TUN 模式，如果你的代理出口 IP 是机房 IP，依然会 403。关键在于 IP 的类型：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;IP 类型&lt;/th&gt;
&lt;th&gt;来源&lt;/th&gt;
&lt;th&gt;Claude 风控结果&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;数据中心 IP&lt;/td&gt;
&lt;td&gt;VPS、云服务器、廉价机场&lt;/td&gt;
&lt;td&gt;❌ 大概率 403&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;住宅 IP&lt;/td&gt;
&lt;td&gt;真实家庭宽带 ISP&lt;/td&gt;
&lt;td&gt;✅ 正常使用&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;原生住宅 IP&lt;/td&gt;
&lt;td&gt;IP 归属地与服务器一致&lt;/td&gt;
&lt;td&gt;✅ 最佳&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;如何检测你的 IP 类型&lt;/strong&gt;：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;访问 &lt;a href=&quot;https://ping0.cc/&quot;&gt;Ping0&lt;/a&gt; — 查看 IP 类型是否为 &lt;code&gt;Residential&lt;/code&gt;&lt;/li&gt;
&lt;li&gt;访问 &lt;a href=&quot;https://scamalytics.com/&quot;&gt;Scamalytics&lt;/a&gt; — 欺诈值低于 30 为优质&lt;/li&gt;
&lt;/ol&gt;
&lt;p&gt;如果你的 IP 显示为 &lt;code&gt;Hosting&lt;/code&gt; 或 &lt;code&gt;Data Center&lt;/code&gt;，那就是机房 IP，需要换成住宅 IP。&lt;/p&gt;
&lt;p&gt;推荐使用 &lt;a href=&quot;https://www.miyaip.com/?invitecode=8731849&quot;&gt;MiyaIP 住宅代理&lt;/a&gt;，支持 Socks5 协议和中转地址，国内直连速度快。&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;优惠码 &lt;strong&gt;&lt;code&gt;wstormai&lt;/code&gt;&lt;/strong&gt; 享九折优惠。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr /&gt;
&lt;h2&gt;排查流程图&lt;/h2&gt;
&lt;p&gt;遇到 403 时按以下步骤排查：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;Claude Code / 桌面客户端 / VSCode / Cowork 报 403
         │
         ▼
  浏览器访问 claude.ai 正常吗？
         │
    ┌────┴────┐
    是        否
    │         │
    ▼         ▼
  代理没有    IP 本身有问题
  覆盖终端    或账号问题
    │         │
    ▼         ▼
  开启 TUN   检查 IP 类型
  模式       是否为住宅 IP
    │         │
    ▼         ▼
  验证终端    换住宅 IP
  IP 是否     节点
  已变化
    │
    ▼
  IP 是住宅类型吗？
    │
  ┌─┴──┐
  是    否
  │    │
  ▼    ▼
 正常  换住宅 IP
 使用  节点
&lt;/code&gt;&lt;/pre&gt;
&lt;hr /&gt;
&lt;h2&gt;常见问题&lt;/h2&gt;
&lt;h3&gt;Q: 开了 TUN 模式还是 403？&lt;/h3&gt;
&lt;p&gt;检查以下几点：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;是否以 &lt;strong&gt;管理员身份&lt;/strong&gt; 运行 V2rayN&lt;/li&gt;
&lt;li&gt;当前选择的节点是否是 &lt;strong&gt;住宅 IP&lt;/strong&gt;（不是所有节点都是住宅 IP）&lt;/li&gt;
&lt;li&gt;在终端运行 &lt;code&gt;curl https://api.ip.sb/ip&lt;/code&gt; 确认出口 IP 是否已变化&lt;/li&gt;
&lt;li&gt;访问 &lt;a href=&quot;https://ping0.cc/&quot;&gt;Ping0&lt;/a&gt; 确认 IP 类型&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;Q: 用了住宅 IP 还是偶尔 403？&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;可能住宅 IP 被多人共用，已被标记，换一个节点试试&lt;/li&gt;
&lt;li&gt;检查 IP 欺诈值，Scamalytics 评分应低于 30&lt;/li&gt;
&lt;li&gt;确保没有频繁切换 IP 地区&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;Q: macOS 上 TUN 模式不生效？&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;检查系统偏好设置 → 隐私与安全性 → 网络扩展，确认已允许 V2rayN&lt;/li&gt;
&lt;li&gt;运行 &lt;code&gt;xattr -cr /Applications/v2rayN.app&lt;/code&gt; 解除系统限制&lt;/li&gt;
&lt;li&gt;重启 V2rayN 后再开启 TUN&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;Q: 环境变量设置了也不管用？&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;确认代理软件正在运行且端口正确&lt;/li&gt;
&lt;li&gt;某些程序使用独立的 DNS 解析，可能绕过了代理&lt;/li&gt;
&lt;li&gt;这种情况下只有 TUN 模式能彻底解决&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;
&lt;h2&gt;总结&lt;/h2&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;问题&lt;/th&gt;
&lt;th&gt;原因&lt;/th&gt;
&lt;th&gt;解决方案&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;终端 Claude Code 403&lt;/td&gt;
&lt;td&gt;终端不走系统代理&lt;/td&gt;
&lt;td&gt;开启 TUN 模式&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;VSCode 插件 403&lt;/td&gt;
&lt;td&gt;插件不走系统代理&lt;/td&gt;
&lt;td&gt;开启 TUN 模式 / VSCode 代理设置&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Claude 桌面客户端 403&lt;/td&gt;
&lt;td&gt;Electron 应用不走系统代理&lt;/td&gt;
&lt;td&gt;开启 TUN 模式 / 终端带代理启动&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;Cowork 403&lt;/td&gt;
&lt;td&gt;独立进程不走系统代理&lt;/td&gt;
&lt;td&gt;开启 TUN 模式&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;开了代理还 403&lt;/td&gt;
&lt;td&gt;IP 是机房 IP&lt;/td&gt;
&lt;td&gt;换纯净住宅 IP&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;浏览器正常其他都不行&lt;/td&gt;
&lt;td&gt;系统代理只覆盖浏览器&lt;/td&gt;
&lt;td&gt;TUN 模式接管所有流量&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;一句话总结：开 TUN + 住宅 IP = 彻底解决所有 Claude 产品的 403。&lt;/strong&gt;&lt;/p&gt;
&lt;hr /&gt;
&lt;ul&gt;
&lt;li&gt;相关教程：&lt;a href=&quot;/posts/claude-anti-ban/&quot;&gt;纯净住宅 IP 配置指南&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;IP 检测工具：&lt;a href=&quot;/iptools/&quot;&gt;IP工具合集&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;
&lt;h2&gt;相关服务&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;Claude Code 完整安装教程 → &lt;a href=&quot;/posts/claude-code-tutorial/&quot;&gt;安装教程&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;需要注册 Claude？→ &lt;a href=&quot;/sms/&quot;&gt;Claude 接码服务&lt;/a&gt;（美国手机号验证码）&lt;/li&gt;
&lt;li&gt;谷歌账号 / Claude Pro 购买 → &lt;a href=&quot;/store/&quot;&gt;AI 会员商店&lt;/a&gt;（支付宝付款，自动发货）&lt;/li&gt;
&lt;li&gt;住宅 IP 降低风控 → &lt;a href=&quot;/posts/claude-anti-ban/&quot;&gt;IP 配置指南&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;
&lt;h2&gt;免责声明&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文内容仅供技术学习与交流，旨在帮助用户理解网络代理原理、HTTP 状态码及常见网络故障排查方法，不构成任何使用建议或行为指导。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;本文不提供、不推广任何翻墙工具或非法跨境网络访问服务&lt;/li&gt;
&lt;li&gt;用户应自行遵守《中华人民共和国计算机信息网络国际联网管理暂行规定》《网络安全法》《数据安全法》等相关法律法规&lt;/li&gt;
&lt;li&gt;因读者自行使用本文提及的技术方案所产生的一切法律后果，由使用者本人承担，与本站及作者无关&lt;/li&gt;
&lt;li&gt;如本文内容与当地法律法规存在冲突，请以法律法规为准，并请勿参考本文相关内容&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;请合法合规使用互联网，共同维护良好的网络环境。&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded></item><item><title>Claude Code 教程：安装、订阅、登录到使用（2026最新）</title><link>https://wstormai.store/posts/claude-code-tutorial/</link><guid isPermaLink="true">https://wstormai.store/posts/claude-code-tutorial/</guid><description>Claude Code 完整入门教程：Node.js 安装、Pro/Max 订阅方案对比、OAuth 和 API Key 登录、常用命令速查、CLAUDE.md 配置、403/401/429 等常见报错解决</description><pubDate>Wed, 18 Mar 2026 00:00:00 GMT</pubDate><content:encoded>&lt;h2&gt;Claude Code 是什么？&lt;/h2&gt;
&lt;p&gt;Claude Code 是 Anthropic 官方推出的 &lt;strong&gt;终端 AI 编程助手&lt;/strong&gt;，直接在命令行中与 Claude 对话，支持：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;代码搜索与阅读&lt;/strong&gt;：理解整个项目结构，搜索函数定义和引用&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;代码编辑与生成&lt;/strong&gt;：直接修改文件、创建新文件、重构代码&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Git 操作&lt;/strong&gt;：自动提交、创建分支、生成 PR&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;终端命令执行&lt;/strong&gt;：运行测试、安装依赖、执行构建&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;多文件协作&lt;/strong&gt;：跨文件修改，理解上下文关系&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;与浏览器版 Claude 不同，Claude Code &lt;strong&gt;直接操作你本地的代码仓库&lt;/strong&gt;，是真正意义上的 AI 编程搭档。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;前置条件&lt;/h2&gt;
&lt;p&gt;在安装 Claude Code 之前，你需要准备：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;条件&lt;/th&gt;
&lt;th&gt;说明&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;操作系统&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;macOS 10.15+、Ubuntu 20.04+ / Debian 10+、Windows 10/11&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Node.js&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;版本 &amp;gt;= 18（推荐 LTS 版本）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Claude 订阅&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;需要 Pro 或 Max 订阅（详见下方订阅方案）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;网络环境&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;能正常访问 Anthropic API（国内需代理，建议 &lt;a href=&quot;/posts/claude-code-403/&quot;&gt;TUN 模式&lt;/a&gt;）&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;hr /&gt;
&lt;h2&gt;第一步：安装 Node.js&lt;/h2&gt;
&lt;p&gt;Claude Code 基于 Node.js 运行，需要先安装 Node.js 18 或更高版本。&lt;/p&gt;
&lt;h3&gt;检查是否已安装&lt;/h3&gt;
&lt;p&gt;打开终端，输入：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;node --version
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;如果输出 &lt;code&gt;v18.x.x&lt;/code&gt; 或更高版本，可以跳过此步骤。&lt;/p&gt;
&lt;h3&gt;macOS 安装 Node.js&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;方法一：使用 Homebrew（推荐）&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;# 安装 Homebrew（如果没有）
/bin/bash -c &quot;$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)&quot;

# 安装 Node.js LTS 版本
brew install node@22
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;方法二：直接下载安装包&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;访问 &lt;a href=&quot;https://nodejs.org/zh-cn&quot;&gt;Node.js 官网&lt;/a&gt; 下载 macOS 安装包（.pkg），双击安装即可。&lt;/p&gt;
&lt;h3&gt;Windows 安装 Node.js&lt;/h3&gt;
&lt;p&gt;Claude Code 已原生支持 Windows 10/11，直接在 PowerShell 或 cmd 中使用即可。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;方法一：官网下载安装（推荐）&lt;/strong&gt;&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;访问 &lt;a href=&quot;https://nodejs.org/zh-cn&quot;&gt;Node.js 官网&lt;/a&gt;，下载 Windows 安装包（.msi）&lt;/li&gt;
&lt;li&gt;双击运行安装程序，一路点击 Next 即可&lt;/li&gt;
&lt;li&gt;安装完成后打开 &lt;strong&gt;命令提示符（cmd）&lt;/strong&gt; 或 &lt;strong&gt;PowerShell&lt;/strong&gt;，验证安装：&lt;/li&gt;
&lt;/ol&gt;
&lt;pre&gt;&lt;code&gt;node --version
npm --version
&lt;/code&gt;&lt;/pre&gt;
&lt;hr /&gt;
&lt;h2&gt;第二步：安装 Claude Code&lt;/h2&gt;
&lt;p&gt;Node.js 安装完成后，即可安装 Claude Code。&lt;/p&gt;
&lt;h3&gt;macOS 安装 Claude Code&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;方法一：使用 npm（通用）&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;npm install -g @anthropic-ai/claude-code
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;如果遇到权限错误，加 &lt;code&gt;sudo&lt;/code&gt;：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;sudo npm install -g @anthropic-ai/claude-code
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;方法二：使用 Homebrew&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;brew install claude-code
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Homebrew 安装的好处是后续更新可以直接 &lt;code&gt;brew upgrade claude-code&lt;/code&gt;，统一管理。&lt;/p&gt;
&lt;h3&gt;Windows 安装 Claude Code&lt;/h3&gt;
&lt;p&gt;以 &lt;strong&gt;管理员身份&lt;/strong&gt; 打开 PowerShell，执行：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;npm install -g @anthropic-ai/claude-code
&lt;/code&gt;&lt;/pre&gt;
&lt;blockquote&gt;
&lt;p&gt;如果遇到权限问题，请确认是以管理员身份运行的 PowerShell。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3&gt;Linux 安装 Claude Code&lt;/h3&gt;
&lt;pre&gt;&lt;code&gt;npm install -g @anthropic-ai/claude-code
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;如果遇到权限错误（&lt;code&gt;EACCES&lt;/code&gt;），加 &lt;code&gt;sudo&lt;/code&gt;：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;sudo npm install -g @anthropic-ai/claude-code
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;验证安装&lt;/h3&gt;
&lt;p&gt;安装完成后验证：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;claude --version
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;如果输出版本号，说明安装成功。&lt;/p&gt;
&lt;h3&gt;更新 Claude Code&lt;/h3&gt;
&lt;p&gt;Claude Code 更新频繁，建议定期更新：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;# npm 用户
npm update -g @anthropic-ai/claude-code

# macOS Homebrew 用户
brew upgrade claude-code
&lt;/code&gt;&lt;/pre&gt;
&lt;hr /&gt;
&lt;h2&gt;第三步：选择订阅方案&lt;/h2&gt;
&lt;p&gt;Claude Code 需要有效的订阅才能使用。目前有以下方案：&lt;/p&gt;
&lt;h3&gt;方案对比&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;方案&lt;/th&gt;
&lt;th&gt;价格&lt;/th&gt;
&lt;th&gt;Claude Code 用量&lt;/th&gt;
&lt;th&gt;模型&lt;/th&gt;
&lt;th&gt;适用人群&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Pro&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;$20/月&lt;/td&gt;
&lt;td&gt;有限制，会触发限流&lt;/td&gt;
&lt;td&gt;Sonnet&lt;/td&gt;
&lt;td&gt;轻度使用、体验为主&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Max 5x&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;$100/月&lt;/td&gt;
&lt;td&gt;Pro 的 5 倍用量&lt;/td&gt;
&lt;td&gt;Sonnet + Opus&lt;/td&gt;
&lt;td&gt;日常开发、中度使用&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Max 20x&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;$200/月&lt;/td&gt;
&lt;td&gt;Pro 的 20 倍用量&lt;/td&gt;
&lt;td&gt;Sonnet + Opus&lt;/td&gt;
&lt;td&gt;重度开发、团队主力&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;API Key&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;按量计费&lt;/td&gt;
&lt;td&gt;无限制（按 token 付费）&lt;/td&gt;
&lt;td&gt;全部模型&lt;/td&gt;
&lt;td&gt;灵活用量、企业用户&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;建议&lt;/strong&gt;：如果你每天大量使用 Claude Code 进行编程，建议直接上 Max 5x（$100/月），Pro 订阅在高强度使用时会频繁触发限流，体验较差。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;h3&gt;如何订阅&lt;/h3&gt;
&lt;p&gt;开通 Claude Pro/Max 订阅，推荐直接去&lt;a href=&quot;https://m.tb.cn/h.iTl4zGh?tk=9nNqUA9dRGj&quot;&gt;闲鱼购买&lt;/a&gt;成品号或代充服务，省去外币信用卡的麻烦。&lt;/p&gt;
&lt;p&gt;如果想自己操作：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;访问 &lt;a href=&quot;https://claude.ai&quot;&gt;claude.ai&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;登录你的 Anthropic 账号（没有就注册一个）&lt;/li&gt;
&lt;li&gt;点击左下角 &lt;strong&gt;头像&lt;/strong&gt; → &lt;strong&gt;Settings&lt;/strong&gt; → &lt;strong&gt;Subscription&lt;/strong&gt;&lt;/li&gt;
&lt;li&gt;选择 &lt;strong&gt;Pro&lt;/strong&gt; 或 &lt;strong&gt;Max&lt;/strong&gt; 方案，完成支付（需要外币信用卡 Visa / Mastercard）&lt;/li&gt;
&lt;/ol&gt;
&lt;blockquote&gt;
&lt;p&gt;📱 注册 Claude 需要海外手机号接收验证码。如果没有海外号码，可以使用接码服务：&lt;a href=&quot;https://m.tb.cn/h.ignzAZj?tk=PTlmUBA42MM&quot;&gt;闲鱼接码&lt;/a&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr /&gt;
&lt;h2&gt;第四步：登录 Claude Code&lt;/h2&gt;
&lt;p&gt;安装完成后，在终端进入你的项目目录，然后启动 Claude Code：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;cd /your/project/path
claude
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;首次运行会提示你登录认证。&lt;/p&gt;
&lt;h3&gt;登录方式一：浏览器 OAuth 登录（推荐）&lt;/h3&gt;
&lt;p&gt;这是最简单的登录方式，适用于 Pro / Max 订阅用户：&lt;/p&gt;
&lt;ol&gt;
&lt;li&gt;终端运行 &lt;code&gt;claude&lt;/code&gt; 后，会显示一个 URL&lt;/li&gt;
&lt;li&gt;按回车键自动打开浏览器（或手动复制 URL 到浏览器）&lt;/li&gt;
&lt;li&gt;在浏览器中登录你的 Claude 账号&lt;/li&gt;
&lt;li&gt;授权 Claude Code 访问你的账号&lt;/li&gt;
&lt;li&gt;浏览器显示「Authorization successful」，回到终端即可使用&lt;/li&gt;
&lt;/ol&gt;
&lt;pre&gt;&lt;code&gt;┌──────────────────────────────────────────┐
│ ✻ Welcome to Claude Code!               │
│                                          │
│   To get started, log in to your         │
│   Anthropic account.                     │
│                                          │
│   Press Enter to open the browser...     │
└──────────────────────────────────────────┘
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;登录方式二：API Key 登录&lt;/h3&gt;
&lt;p&gt;如果你使用 API Key（按量付费），可以通过环境变量设置：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;# 临时设置（当前终端会话有效）
export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxx
claude

# 或者写入配置文件永久生效
echo &apos;export ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxx&apos; &amp;gt;&amp;gt; ~/.bashrc
source ~/.bashrc
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;API Key 在 &lt;a href=&quot;https://console.anthropic.com&quot;&gt;Anthropic Console&lt;/a&gt; → API Keys 页面创建。&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;⚠️ &lt;strong&gt;注意&lt;/strong&gt;：API Key 是按 token 计费的，大量使用可能产生较高费用。建议先在 Console 设置 Usage Limit（用量上限）。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr /&gt;
&lt;h2&gt;第五步：开始使用&lt;/h2&gt;
&lt;p&gt;登录成功后，你就进入了 Claude Code 的交互界面。以下是核心用法：&lt;/p&gt;
&lt;h3&gt;基础对话&lt;/h3&gt;
&lt;p&gt;直接用自然语言描述你想做的事情：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;&amp;gt; 帮我看看这个项目的整体结构

&amp;gt; 找到所有处理用户认证的代码

&amp;gt; src/api/auth.ts 这个文件是做什么的？
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;代码编辑&lt;/h3&gt;
&lt;p&gt;Claude Code 可以直接修改你的文件：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;&amp;gt; 给 login 函数添加参数校验

&amp;gt; 把这个组件从 class 组件重构为 hooks

&amp;gt; 修复 useEffect 的依赖项警告
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;修改前 Claude Code 会展示 diff，你确认后才会写入文件。&lt;/p&gt;
&lt;h3&gt;终端命令&lt;/h3&gt;
&lt;p&gt;Claude Code 可以执行终端命令：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;&amp;gt; 运行测试看看有没有失败的

&amp;gt; 安装 axios 依赖

&amp;gt; 构建项目并检查是否有报错
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;Git 操作&lt;/h3&gt;
&lt;pre&gt;&lt;code&gt;&amp;gt; 提交当前的修改，写一个合适的 commit message

&amp;gt; 创建一个新分支叫 feature/user-auth

&amp;gt; 帮我创建一个 PR，描述这次的改动
&lt;/code&gt;&lt;/pre&gt;
&lt;hr /&gt;
&lt;h2&gt;常用命令速查&lt;/h2&gt;
&lt;p&gt;在 Claude Code 交互界面中，可以使用以下斜杠命令：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;命令&lt;/th&gt;
&lt;th&gt;作用&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;/help&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;查看帮助信息&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;/clear&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;清除当前对话上下文&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;/compact&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;压缩对话历史，释放上下文空间&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;/model&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;切换模型（如 Opus、Sonnet）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;/cost&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;查看当前会话的 token 用量和费用&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;/permissions&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;管理工具权限设置&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;/fast&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;切换快速模式（更快的响应速度）&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;h3&gt;命令行参数&lt;/h3&gt;
&lt;p&gt;Claude Code 也支持直接在终端中传入参数执行单次任务：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;# 非交互模式：执行单条指令后退出
claude -p &quot;解释这个项目的目录结构&quot;

# 继续上次的对话
claude --continue

# 从上次对话继续，并追加新指令
claude --continue &quot;接着上次的，现在把测试也写了&quot;

# 指定模型
claude --model opus
claude --model sonnet
&lt;/code&gt;&lt;/pre&gt;
&lt;hr /&gt;
&lt;h2&gt;权限管理&lt;/h2&gt;
&lt;p&gt;Claude Code 在执行某些操作时会请求你的确认：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;文件读取&lt;/strong&gt;：默认允许&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;文件编辑/创建&lt;/strong&gt;：需要确认（可设置为自动允许）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;终端命令执行&lt;/strong&gt;：需要确认&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Git 操作&lt;/strong&gt;：需要确认&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;你可以通过 &lt;code&gt;/permissions&lt;/code&gt; 命令调整权限级别，或在操作提示时选择：&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Allow once&lt;/strong&gt;：仅本次允许&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Allow always&lt;/strong&gt;：始终允许该类操作&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Deny&lt;/strong&gt;：拒绝执行&lt;/li&gt;
&lt;/ul&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;建议&lt;/strong&gt;：对于信任的项目，可以将文件编辑设为自动允许，提升效率。但对于 &lt;code&gt;rm&lt;/code&gt;、&lt;code&gt;git push&lt;/code&gt; 等破坏性操作，建议保持手动确认。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr /&gt;
&lt;h2&gt;CLAUDE.md 项目配置&lt;/h2&gt;
&lt;p&gt;在项目根目录创建 &lt;code&gt;CLAUDE.md&lt;/code&gt; 文件，可以为 Claude Code 提供项目上下文和规则：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;# 项目说明

这是一个基于 React + TypeScript 的前端项目。

## 代码规范

- 使用函数式组件和 Hooks
- CSS 使用 Tailwind
- 测试使用 Vitest

## 常用命令

- 开发：`pnpm dev`
- 构建：`pnpm build`
- 测试：`pnpm test`

## 注意事项

- 不要修改 src/generated/ 目录下的文件
- API 请求统一使用 src/lib/api.ts 中的封装
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;Claude Code 每次启动时都会自动读取 &lt;code&gt;CLAUDE.md&lt;/code&gt;，让它更好地理解你的项目。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;实用技巧&lt;/h2&gt;
&lt;h3&gt;1. 大型任务分步执行&lt;/h3&gt;
&lt;p&gt;不要一次给出过于复杂的指令，拆分成多个小步骤效果更好：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;# ❌ 不推荐
&amp;gt; 帮我重构整个认证系统，加上 JWT、刷新令牌、权限管理、日志记录

# ✅ 推荐
&amp;gt; 先帮我看看当前的认证逻辑是怎么实现的
&amp;gt; 现在把 session 认证改为 JWT
&amp;gt; 加上 refresh token 机制
&amp;gt; 最后给关键操作加上日志
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;2. 提供上下文&lt;/h3&gt;
&lt;p&gt;告诉 Claude Code 相关的文件和背景，能让它更准确地完成任务：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;&amp;gt; 参考 src/api/users.ts 的风格，给 products 写一套类似的 CRUD API
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;3. 让 Claude Code 先分析再动手&lt;/h3&gt;
&lt;p&gt;对于不确定的修改，先让它分析方案：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;&amp;gt; 不要改代码，先告诉我你打算怎么修复这个 bug
&lt;/code&gt;&lt;/pre&gt;
&lt;h3&gt;4. 善用 /compact&lt;/h3&gt;
&lt;p&gt;长对话会消耗大量上下文窗口。当你觉得对话变长时，使用 &lt;code&gt;/compact&lt;/code&gt; 压缩历史，Claude Code 会保留关键信息并释放空间。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;常见报错展示与原理解析&lt;/h2&gt;
&lt;p&gt;使用 Claude Code 过程中可能遇到各种报错，下面展示最重要的几类错误，分析原理并给出解决方案。&lt;/p&gt;
&lt;hr /&gt;
&lt;h3&gt;400 Bad Request&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;报错信息：&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;Error: 400 {&quot;type&quot;:&quot;error&quot;,&quot;error&quot;:{&quot;type&quot;:&quot;invalid_request_error&quot;,
&quot;message&quot;:&quot;model: invalid model id&quot;}}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;或：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;Error: 400 invalid_request_error
  Could not process the request. Please check your input and try again.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;原理解析：&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;400 表示 &lt;strong&gt;请求本身有问题&lt;/strong&gt;，服务器收到请求也认你的身份，但请求内容不符合 API 规范。&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;场景&lt;/th&gt;
&lt;th&gt;具体原因&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Claude Code 版本过旧&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;旧版本使用了已下线的模型 ID 或已废弃的 API 参数&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;模型 ID 错误&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;手动指定了不存在的模型名称，如拼写错误 &lt;code&gt;cluade-sonnet&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;配置文件损坏&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;~/.claude/&lt;/code&gt; 下的配置文件被意外修改或损坏&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;解决方案：&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;# 1. 最常见原因：版本过旧，更新到最新版
npm update -g @anthropic-ai/claude-code

# 2. 确认模型名称正确
claude --model sonnet    # ✅
claude --model opus      # ✅
claude --model cluade    # ❌ 拼写错误

# 3. 清除缓存重新登录
rm -rf ~/.claude/projects/
claude login
&lt;/code&gt;&lt;/pre&gt;
&lt;hr /&gt;
&lt;h3&gt;401 Unauthorized&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;报错信息：&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;Error: 401 Unauthorized

  Invalid authorization header. Please ensure your API key
  or session token is correct.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;或：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;Error: 401 {&quot;type&quot;:&quot;error&quot;,&quot;error&quot;:{&quot;type&quot;:&quot;authentication_error&quot;,
&quot;message&quot;:&quot;invalid x-api-key&quot;}}
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;原理解析：&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;401 是 &lt;strong&gt;服务器不认你的身份&lt;/strong&gt;，和 403（有身份但被拒绝访问）不同：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;请求 ──→ Anthropic API
             │
        检查认证信息
             │
     ┌───────┴───────┐
   有凭据           无凭据/凭据无效
     │                    │
  继续处理(→403等)   直接拒绝(401)
&lt;/code&gt;&lt;/pre&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;场景&lt;/th&gt;
&lt;th&gt;具体原因&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;API Key 写错&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;复制时多了空格、少了字符、混了中英文引号&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;API Key 已删除&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;在 Console 删除了 Key 但环境变量还是旧的&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;OAuth Token 过期&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;长时间未使用，Token 自然过期&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;环境变量被覆盖&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;&lt;code&gt;.bashrc&lt;/code&gt;、&lt;code&gt;.zshrc&lt;/code&gt;、&lt;code&gt;.profile&lt;/code&gt; 互相覆盖&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;解决方案：&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;# API Key 用户：检查 Key 是否正确
echo $ANTHROPIC_API_KEY
# 确认以 sk-ant- 开头，没有多余空格

# 测试 Key 是否有效
curl -s https://api.anthropic.com/v1/messages \
  -H &quot;x-api-key: $ANTHROPIC_API_KEY&quot; \
  -H &quot;anthropic-version: 2023-06-01&quot; \
  -H &quot;content-type: application/json&quot; \
  -d &apos;{&quot;model&quot;:&quot;claude-sonnet-4-20250514&quot;,&quot;max_tokens&quot;:10,&quot;messages&quot;:[{&quot;role&quot;:&quot;user&quot;,&quot;content&quot;:&quot;hi&quot;}]}&apos; \
  | head -c 200

# OAuth 用户：重新登录
claude login

# 检查环境变量是否被多处覆盖
grep -n &quot;ANTHROPIC_API_KEY&quot; ~/.bashrc ~/.zshrc ~/.profile 2&amp;gt;/dev/null
&lt;/code&gt;&lt;/pre&gt;
&lt;hr /&gt;
&lt;h3&gt;403 Forbidden&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;报错信息：&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;Error: 403 Forbidden

  API Error: Your request was rejected by our safety systems.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;原理解析：&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;403 是国内用户遇到的 &lt;strong&gt;最高频报错&lt;/strong&gt;。不是密码错、不是账号封禁，而是 &lt;strong&gt;IP 被风控拦截&lt;/strong&gt;：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;你的终端 ──→ 直连/机房IP ──→ Anthropic API
                                   │
                              风控检测 IP 类型
                                   │
                              判定为异常 → 403
&lt;/code&gt;&lt;/pre&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;原因&lt;/th&gt;
&lt;th&gt;说明&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;终端没走代理&lt;/td&gt;
&lt;td&gt;浏览器走了系统代理，但终端/CLI 不读取系统代理，直连出去&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;IP 是机房类型&lt;/td&gt;
&lt;td&gt;代理出口是数据中心 IP，不是住宅 IP&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;IP 欺诈值高&lt;/td&gt;
&lt;td&gt;出口 IP 被大量人使用，已被标记&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;解决方案：&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;开启 &lt;strong&gt;TUN 模式&lt;/strong&gt; + 使用 &lt;strong&gt;纯净住宅 IP&lt;/strong&gt;。&lt;/p&gt;
&lt;blockquote&gt;
&lt;p&gt;完整原理分析和解决步骤见：&lt;a href=&quot;/posts/claude-code-403/&quot;&gt;Claude Code 报错 403 的原理与解决办法&lt;/a&gt;&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr /&gt;
&lt;h3&gt;429 Too Many Requests（限流）&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;报错信息：&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;Error: 429 Too Many Requests

  Rate limit exceeded. You&apos;ve sent too many requests.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;或 Pro 用户常见的：&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;⚠ You&apos;ve hit your usage limit. Your limit will reset in 3 hours.
  Upgrade to Max for higher limits: https://claude.ai/settings
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;原理解析：&lt;/strong&gt;&lt;/p&gt;
&lt;p&gt;Anthropic 对每个订阅等级设置了用量上限：&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;订阅&lt;/th&gt;
&lt;th&gt;限流机制&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Pro&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;上限较低，高强度使用 ~2-4 小时触发&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Max 5x&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Pro 的 5 倍额度，日常一般不触发&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;Max 20x&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Pro 的 20 倍额度，极难触发&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;API Key&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;RPM / TPM 限制，可在 Console 查看&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;限流不是封号，等冷却期后自动恢复。&lt;/p&gt;
&lt;p&gt;&lt;strong&gt;解决方案：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;&lt;strong&gt;Pro 用户&lt;/strong&gt;：等待 reset（2-5 小时），或升级 Max&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;Max 用户&lt;/strong&gt;：等待 reset（1-2 小时），或 &lt;code&gt;/model sonnet&lt;/code&gt; 切换模型（额度独立）&lt;/li&gt;
&lt;li&gt;&lt;strong&gt;API 用户&lt;/strong&gt;：降低请求频率，或在 Console 申请提升限额&lt;/li&gt;
&lt;/ul&gt;
&lt;blockquote&gt;
&lt;p&gt;&lt;strong&gt;技巧&lt;/strong&gt;：Pro 经常触发限流说明该升级了。$100/月的 Max 5x 性价比最高。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr /&gt;
&lt;h3&gt;网络连接错误&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;报错信息：&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;Error: fetch failed
  cause: ConnectTimeoutError: Connect Timeout Error
&lt;/code&gt;&lt;/pre&gt;
&lt;pre&gt;&lt;code&gt;Error: getaddrinfo ENOTFOUND api.anthropic.com
&lt;/code&gt;&lt;/pre&gt;
&lt;pre&gt;&lt;code&gt;Error: connect ETIMEDOUT 104.18.xx.xx:443
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;原理解析：&lt;/strong&gt;&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;错误关键词&lt;/th&gt;
&lt;th&gt;含义&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;ENOTFOUND&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;DNS 解析失败，域名无法解析&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;ETIMEDOUT&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;TCP 连接超时，能解析但连不上&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;ECONNRESET&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;连接被中间设备重置&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;ECONNREFUSED&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;连接被拒绝&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;解决方案：&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;# 测试连通性
curl -v https://api.anthropic.com 2&amp;gt;&amp;amp;1 | head -20

# 确认出口 IP 是否走了代理
curl https://api.ip.sb/ip
&lt;/code&gt;&lt;/pre&gt;
&lt;blockquote&gt;
&lt;p&gt;国内 &lt;code&gt;api.anthropic.com&lt;/code&gt; 大概率无法直连，必须代理。推荐 &lt;a href=&quot;/posts/claude-code-403/&quot;&gt;TUN 模式&lt;/a&gt;。&lt;/p&gt;
&lt;/blockquote&gt;
&lt;hr /&gt;
&lt;h3&gt;500 / 529 服务端错误&lt;/h3&gt;
&lt;p&gt;&lt;strong&gt;报错信息：&lt;/strong&gt;&lt;/p&gt;
&lt;pre&gt;&lt;code&gt;Error: 500 Internal Server Error
&lt;/code&gt;&lt;/pre&gt;
&lt;pre&gt;&lt;code&gt;Error: 529 API Overloaded
  The API is temporarily overloaded.
&lt;/code&gt;&lt;/pre&gt;
&lt;p&gt;&lt;strong&gt;原理解析：&lt;/strong&gt;&lt;/p&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;状态码&lt;/th&gt;
&lt;th&gt;含义&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;500&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;Anthropic 服务器内部错误，和你无关&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;502/503&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;服务暂时不可用，部署或维护中&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;strong&gt;529&lt;/strong&gt;&lt;/td&gt;
&lt;td&gt;API 过载，新模型发布后几天内常见&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;解决方案：&lt;/strong&gt;&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;等几秒到几分钟重试&lt;/li&gt;
&lt;li&gt;查看 &lt;a href=&quot;https://status.anthropic.com&quot;&gt;Anthropic 状态页&lt;/a&gt; 确认是否服务异常&lt;/li&gt;
&lt;li&gt;高峰期（北美工作时间）可换时段使用&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;
&lt;h3&gt;报错速查表&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;状态码&lt;/th&gt;
&lt;th&gt;类别&lt;/th&gt;
&lt;th&gt;原因&lt;/th&gt;
&lt;th&gt;快速解决&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;400&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;请求错误&lt;/td&gt;
&lt;td&gt;版本过旧 / 参数错误&lt;/td&gt;
&lt;td&gt;&lt;code&gt;npm update -g @anthropic-ai/claude-code&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;401&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;认证无效&lt;/td&gt;
&lt;td&gt;Key 错误 / Token 过期&lt;/td&gt;
&lt;td&gt;检查 Key 或 &lt;code&gt;claude login&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;403&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;IP 风控&lt;/td&gt;
&lt;td&gt;IP 被拦截&lt;/td&gt;
&lt;td&gt;TUN 模式 + 住宅 IP&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;429&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;限流&lt;/td&gt;
&lt;td&gt;用量超限&lt;/td&gt;
&lt;td&gt;等待 reset 或升级订阅&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;500/529&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;服务端&lt;/td&gt;
&lt;td&gt;Anthropic 服务器问题&lt;/td&gt;
&lt;td&gt;等待重试&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;&lt;code&gt;ETIMEDOUT&lt;/code&gt;&lt;/td&gt;
&lt;td&gt;网络&lt;/td&gt;
&lt;td&gt;连不上 API&lt;/td&gt;
&lt;td&gt;检查代理和网络&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;hr /&gt;
&lt;h2&gt;其他常见问题&lt;/h2&gt;
&lt;h3&gt;Q: 响应很慢或经常超时？&lt;/h3&gt;
&lt;ul&gt;
&lt;li&gt;检查网络连接是否稳定&lt;/li&gt;
&lt;li&gt;使用 &lt;code&gt;/fast&lt;/code&gt; 切换快速模式&lt;/li&gt;
&lt;li&gt;如果使用代理，确保代理节点延迟较低&lt;/li&gt;
&lt;li&gt;大文件或大项目首次分析会较慢，后续会利用缓存&lt;/li&gt;
&lt;/ul&gt;
&lt;h3&gt;Q: Max 订阅和 API Key 哪个划算？&lt;/h3&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;使用强度&lt;/th&gt;
&lt;th&gt;推荐方案&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;每天几次简单对话&lt;/td&gt;
&lt;td&gt;Pro（$20/月）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;每天 1-3 小时编程&lt;/td&gt;
&lt;td&gt;Max 5x（$100/月）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;全天重度使用&lt;/td&gt;
&lt;td&gt;Max 20x（$200/月）&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;不确定用量 / 按需使用&lt;/td&gt;
&lt;td&gt;API Key（按量付费）&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;Max 订阅的优势是 &lt;strong&gt;费用可预测&lt;/strong&gt;，不管用多少都是固定月费；API Key 灵活但可能在不注意时产生高额费用。&lt;/p&gt;
&lt;h3&gt;Q: Windows 上可以直接用吗？&lt;/h3&gt;
&lt;p&gt;可以。Claude Code 已原生支持 Windows 10/11，在 PowerShell 或命令提示符中安装即可使用，无需额外配置。&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;总结&lt;/h2&gt;
&lt;table&gt;
&lt;thead&gt;
&lt;tr&gt;
&lt;th&gt;步骤&lt;/th&gt;
&lt;th&gt;操作&lt;/th&gt;
&lt;/tr&gt;
&lt;/thead&gt;
&lt;tbody&gt;
&lt;tr&gt;
&lt;td&gt;1. 安装 Node.js&lt;/td&gt;
&lt;td&gt;&lt;code&gt;nvm install --lts&lt;/code&gt; 或官网下载&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;2. 安装 Claude Code&lt;/td&gt;
&lt;td&gt;&lt;code&gt;npm install -g @anthropic-ai/claude-code&lt;/code&gt;&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;3. 订阅&lt;/td&gt;
&lt;td&gt;claude.ai → Settings → Subscription&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;4. 登录&lt;/td&gt;
&lt;td&gt;终端运行 &lt;code&gt;claude&lt;/code&gt;，浏览器授权&lt;/td&gt;
&lt;/tr&gt;
&lt;tr&gt;
&lt;td&gt;5. 使用&lt;/td&gt;
&lt;td&gt;进入项目目录，&lt;code&gt;claude&lt;/code&gt; 开始对话&lt;/td&gt;
&lt;/tr&gt;
&lt;/tbody&gt;
&lt;/table&gt;
&lt;p&gt;&lt;strong&gt;一句话上手：装好 Node.js，npm 装 Claude Code，订阅后 &lt;code&gt;claude&lt;/code&gt; 命令启动，开始对话就行。&lt;/strong&gt;&lt;/p&gt;
&lt;hr /&gt;
&lt;h2&gt;相关教程&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;遇到 403？→ &lt;a href=&quot;/posts/claude-code-403/&quot;&gt;Claude Code 报错 403 解决办法&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;需要住宅 IP？→ &lt;a href=&quot;/posts/claude-anti-ban/&quot;&gt;Claude 降低封号指南：住宅 IP 配置教程&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;IP 检测工具 → &lt;a href=&quot;/iptools/&quot;&gt;IP 工具合集&lt;/a&gt;&lt;/li&gt;
&lt;li&gt;更多 Claude 工具 → &lt;a href=&quot;/claude/&quot;&gt;Claude AI 工具合集&lt;/a&gt;&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;
&lt;h2&gt;相关服务&lt;/h2&gt;
&lt;ul&gt;
&lt;li&gt;Claude Code 报 403？→ &lt;a href=&quot;/posts/claude-code-403/&quot;&gt;403 解决办法&lt;/a&gt;（TUN 模式 + 住宅 IP）&lt;/li&gt;
&lt;li&gt;需要注册 Claude 账号？→ &lt;a href=&quot;/sms/&quot;&gt;Claude 接码服务&lt;/a&gt;（美国手机号验证码）&lt;/li&gt;
&lt;li&gt;谷歌账号 / Claude Pro 购买 → &lt;a href=&quot;/store/&quot;&gt;AI 会员商店&lt;/a&gt;（支付宝付款，自动发货）&lt;/li&gt;
&lt;/ul&gt;
&lt;hr /&gt;
&lt;h2&gt;免责声明&lt;/h2&gt;
&lt;blockquote&gt;
&lt;p&gt;本文内容仅供技术学习与交流，旨在介绍 Claude Code 工具的安装与使用方法，不构成任何使用建议或行为指导。&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;本文不提供、不推广任何翻墙工具或非法跨境网络访问服务&lt;/li&gt;
&lt;li&gt;用户应自行遵守《中华人民共和国计算机信息网络国际联网管理暂行规定》《网络安全法》《数据安全法》等相关法律法规&lt;/li&gt;
&lt;li&gt;使用境外 AI 服务需自行确保访问方式合法合规，因此产生的一切法律后果由使用者本人承担&lt;/li&gt;
&lt;li&gt;如本文内容与当地法律法规存在冲突，请以法律法规为准，并请勿参考本文相关内容&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;&lt;strong&gt;请合法合规使用互联网，共同维护良好的网络环境。&lt;/strong&gt;&lt;/p&gt;
&lt;/blockquote&gt;
</content:encoded></item></channel></rss>