Nullprint

海外 AI 接入教程:Claude Code / Codex

从零开始:准备账号、安装 AI、连上 Nullprint、跑第一条指令,大约十分钟。在中国大陆、没有境外账号请看国内 AI 接入教程;完整工具说明见 MCP 文档。

选一个 AI,准备账号

AI需要的账号
Claude Code(Anthropic)claude.ai 的 Pro、Max、Team 或 Enterprise 套餐,或有余额的 Anthropic Console 账号。免费版 claude.ai 不含 Claude Code。
Codex(OpenAI)包含 Codex 的 ChatGPT 套餐,或 OpenAI API Key。

两个接 Nullprint 的方式一样,有一个就够。

准备

1. 装好 Nullprint 并保持运行

从下载页安装 Nullprint(Windows / macOS),打开并登录。AI 干活期间保持开着(可以最小化),端口和密钥会自动读取。

2. 装 uv

uv 会在第一次使用时自动下载并运行 nullprint-mcp。打开终端(Mac:终端;Windows:PowerShell)运行:

# macOS
curl -LsSf https://astral.sh/uv/install.sh | sh
# Windows(PowerShell)
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

关掉终端重新打开,输入 uvx --version 有版本号即可。

已经装了 Node.js 18+?可以不装 uv,把下面命令里的 uvx nullprint-mcp 都换成 npx -y nullprint-mcp,服务和工具完全一样。

Claude Code

1. 安装

# macOS
curl -fsSL https://claude.ai/install.sh | bash
# Windows(PowerShell)
irm https://claude.ai/install.ps1 | iex

重新打开终端,claude --version 有版本号即可。

2. 登录

运行 claude,按提示在浏览器里登录 Claude 账号,然后输入 /exit 退出。

3. 连上 Nullprint

claude mcp add --scope user nullprint -- uvx nullprint-mcp

--scope user 表示在任何文件夹里启动 Claude Code 都能用 Nullprint。检查:

claude mcp list

看到 nullprint: uvx nullprint-mcp - ✓ Connected 就连上了。第一次要下载几秒。

4. 试一下

运行 claude,输入:

列出我的 Nullprint 身份,告诉我哪些正在运行。

第一次用工具时 Claude 会请你确认,选允许。会话里输入 /mcp 能看到服务和 17 个工具。

OpenAI Codex

1. 安装

# macOS(Homebrew)
brew install --cask codex
# 任何装了 Node.js 18+ 的系统
npm install -g @openai/codex

2. 登录

运行 codex,选 Sign in with ChatGPT(或用 API Key),登好后退出。

3. 连上 Nullprint

codex mcp add nullprint -- uvx nullprint-mcp

用 codex mcp list 检查。也可以手动写进 ~/.codex/config.toml:

[mcp_servers.nullprint]
command = "uvx"
args = ["nullprint-mcp"]

4. 试一下

运行 codex,输入:

列出我的 Nullprint 身份,告诉我哪些正在运行。

怎么跟 AI 说

你这样说AI 会做什么
建一个身份叫 shop-01,代理 socks5://用户名:密码@IP:端口建身份,指纹自动生成并固定
测一下这 5 条代理,告诉我国家和延迟逐条测出口 IP、国家、延迟
打开 shop-01,进 example.com启动浏览器窗口并跳转
在搜索框填「耳机」然后回车读页面,填写、点击、按键
给 shop-01 做个体检一致性检查,列出不通过的项
哪些身份在跑?把闲着的关掉查看状态并关闭浏览器
删掉 shop-01 / 回收站里有什么 / 恢复它移入回收站(可恢复)、查看、恢复
身份名字要准确(区分大小写)。需要登录的网站,先让 AI 打开页面,密码和验证码自己在窗口里输,登好再交还给 AI。

常见问题

提示 Nullprint daemon 没在运行。 打开 Nullprint 并登录,再试。

找不到 uvx 或 claude。 安装后要重新打开终端。

claude mcp list 显示 Failed to connect。 在终端运行 uvx nullprint-mcp --help 看真正的报错,多半是连不上 PyPI 或缺 Python(uv 会自动装)。

AI 说要先打开会话。 页面操作需要身份已打开,先让它打开身份。

用 Cursor、Windsurf、Cline 或 Claude Desktop? 配置见 MCP 文档。

安全提醒

  • AI 操作的是已登录的身份。付款、改密、删除类操作请自己把关。
  • 用完让它关掉身份。
  • 彻底删除(清空回收站)不开放给 AI。
  • nullprint-mcp 只在你电脑上运行、只连本机 Nullprint;你的指令仍会发给你选的模型厂商。