Ipcheck

ipcheck

网络环境诊断工具，一键检测 IP、DNS、代理、IP 风控、时区一致性与 Claude 端点，确保 AI 工具流畅运行、规避封号。

[English](./README_EN.md)


为什么需要这个工具

想让 Claude Code、OpenAI API、Cursor 等 AI 工具流畅稳定运行，网络环境配置至关重要。以下问题可能影响使用体验：

• IPv6 泄露真实地址 — 代理通常只处理 IPv4，IPv6 会暴露你的实际位置
• DNS 泄露 — 使用国内 DNS 会暴露真实地理位置
• IP 风险过高 — 机房 IP 或被滥用的 IP 可能影响连接质量
• 时区不一致 — 本地时区配置与 IP 所在地不匹配
• Claude 端点走了中转 — 第三方中转站可能泄露数据，甚至触发封号

`ipcheck` 一键检测这些问题，确保你的 AI 工具流畅稳定运行，尤其 Claude 启动之前先检测下，原因你懂得，规避封号。

功能

检测项	说明
本机真实 IP / IPv6	经国内直连回显拿到真实公网 IP（即使开着 VPN/TUN 也能露出真实 ISP 出口），并确认 IPv6 是否已禁用
本地 DNS	识别 DNS 来源（国内 / 国外），标注已知 DNS 服务商
出口 IP 信息	出口（代理后）IP、国家 / 地区、城市、运营商、IP 归属、时区
代理检测	环境变量代理、系统代理、TUN/VPN 的开关状态
IP 类型与风险	机房 / 住宅识别、proxycheck.io 风险评分、StopForumSpam 滥用记录、是否被标记为代理
时区一致性	系统时区与 CLI 时区（全 IANA），分别按 CC CLI（认 $TZ）和桌面版（走系统时区）比对出口 IP 时区
Claude 端点检测	识别 Claude Code 端点是官方直连 / 国产大模型 / 第三方中转；中转会提示数据泄露与封号风险，并比对已知端点黑名单
综合结论	汇总各项风险，一句话判定当前环境 Claude 使用为高 / 中 / 低风险

安装

pip install ai-ipcheck

升级到最新版：

pip install --upgrade ai-ipcheck

使用

ipcheck

环境要求

• Python 3.10+
• 支持 macOS / Linux / Windows

结果说明

**本机真实 IP & DNS** — 本机真实 IP 经国内直连回显获取，即使开着 VPN/TUN 也能露出真实 ISP 出口，用于确认真实身份是否泄露。IPv6 建议禁用，大部分代理不处理 IPv6 流量，开启后可能同时暴露两个不同地区的 IP。若检测到国内 DNS，需要在代理软件中调整 DNS 设置。

**出口 IP 信息** — 显示经过代理后的出口 IP、所在国家/地区、运营商、IP 归属和时区。这些信息直接影响 AI 服务对你请求来源的判断。

**代理检测** — `ipcheck` 会展示环境变量代理、系统代理和 TUN/VPN 的开关状态。系统代理只代表系统配置状态，不等于所有 CLI 流量都会继承；Codex、Claude Code 等带沙箱或独立网络栈的工具，可能需要显式设置 `HTTP_PROXY` / `HTTPS_PROXY`，或者开启 TUN 模式兜底。

**IP 风险评估** — 检测 IP 是住宅还是机房类型。机房 IP 不一定有问题，但会进一步查询风险评分和滥用记录。如果风险评分偏高，建议更换节点。

**时区一致性** — 分两条比对：**CC CLI** 比对 CLI 时区（认 `$TZ`）与出口 IP 时区，**桌面版** 比对系统时区（不认 `$TZ`）与出口 IP 时区。Claude Code CLI 认 `$TZ`，可在 shell 或 `~/.claude/settings.json` 的 `env` 里把 `TZ` 设为与出口 IP 匹配的 IANA 时区（如 `America/Los_Angeles`）；Claude 桌面版走系统时区，需改系统设置。

**Claude 端点检测** — 读取 Claude Code 的 `ANTHROPIC_BASE_URL`，判断是官方直连、国产大模型（不经