{"repo":"cso1z/claude-ip-guard","free":true,"listed":false,"github":"https://github.com/cso1z/claude-ip-guard","clone":"git clone https://github.com/cso1z/claude-ip-guard.git","description":"A Claude Code hook plugin for IP-based access control · 防 Claude 封号 · Claude IP 检测 · IP 地理位置拦截 · Claude 账号保护","language":"Shell","stars":172,"topics":["access-control","claude","claude-code","hooks","ip-geolocation","anthropic-compliance","claude-ban","ip-guard"],"license":"MIT","category":"networking-infra","readme_excerpt":"claude-ip-guard -blue) 防止 Claude Code 因 IP 地理位置异常导致账号被封的 Hook 插件。 自动检测每次请求的出口 IP — 受限国家直接拦截，新 IP 给出分级警告。 如果这个项目对你有帮助，欢迎点个 ⭐ Star — Star 后可及时收到更新通知，我们会持续根据 Anthropic 政策变化和用户反馈迭代优化。 功能特性 - 受限国家拦截 — IP 位于受限国家时阻断请求，附带可见提示 - 新 IP 分级警告 — 首次出现的 IP 触发软拦截并给出警告，重新发送即可继续 - 代理场景兼容 — 第三方中转 API 或 VPN 分流时自动识别，不误拦 - 网络故障不误拦 — 任何检测失败均放行，不因网络问题阻断正常使用 安装 环境要求 ： bash 、 curl 、 python3 （或 python ）。支持 macOS、Linux、WSL、Windows（Git Bash）。 全局安装 （推荐，对本机所有项目生效）： 项目级安装 （仅对当前项目生效）： 手动安装 ：将 .claude/scripts/ 复制到项目目录，授权执行后将以下配置合并到 .claude/settings.json ： 工作原理 挂载 SessionStart 和 UserPromptSubmit 两个 Hook，在会话启动和每次发送消息前自动检测当前网络环境（直连可达性 + 出口 IP 地理位置），根据结果决定放行或拦截： - HTTP 403 ：Anthropic 明确拒绝该 IP，立即硬拦截 - 直连可达（收到任意 HTTP 响应） ：进入 geo + IP 历史检查流程 - 直连异常（超时/无响应） ：退而依赖 geo 判断，受限地区硬拦截，否则 fail-safe 放行 新 IP 分级警告 出现新 IP 时触发软拦截，根据近 30 天累计出现的不同 IP 数给出分级提示： 近 30 天不同 IP 数 等级 提示前缀 ------------------- ------ --------- 第 1 个 — 直接放行，建立基准，不提示 第 2～3 个 注意 [注意] 第 4～6 个 警告 [警告] 第 7 个及以上 严重 [严重警告] 软拦截仅阻止当次消息， 重新发送即可继续 。 频繁切换 IP 本身也是封号风险因素之一。分级警告的目的是提醒你关注网络环境的稳定性，而不仅仅是拦截受限地区。等级越高，说明近期 IP 变动越频繁，建议排查原因。 禁止国家列表 基于 Anthropic 官方支持地区 及美国 OFAC 出口管制规定： 国家/地区 ISO 代码 原因 ----------- ---------- ------ 中国大陆 CN 监管/地缘政治 俄罗斯 RU 美国制裁 朝鲜 KP OFAC 制裁 伊朗 IR OFAC 制裁 叙利亚 SY OFAC 制裁 古巴 CU OFAC 制裁 白俄罗斯 BY 制裁相关 委内瑞拉 VE 未列入支持名单 缅甸 MM 未列入支持名单 利比亚 LY 未列入支持名单 索马里 SO 未列入支持名单 也门 YE 未列入支持名单 马里 ML 未列入支持名单 中非共和国 CF 未列入支持名单 南苏丹 SS 未列入支持名单 刚果民主共和国 CD 未列入支持名单 厄立特里亚 ER 未列入支持名单 阿富汗 AF 未列入支持名单 乌克兰 UA 俄占区受限，因无法识别具体省份，按整国处理 验证是否生效 关闭 VPN，直接运行检测脚本，通过日志查看检测结果： 常见问题 Q：会影响 Claude Code 的响应","default_branch":null,"files":null,"tree":[],"storefront":"/r/cso1z","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/cso1z/claude-ip-guard/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}