开始 / Getting Started

chrome-use

chrome-use 让任意 AI agent 直接驱动你已登录的真实 Chrome—— Claude Code、Cursor、Codex、你自己的脚本。它复用你现成的登录会话， 保留现有浏览器配置，公开检测结果见文档： CreepJS 实测 0% 机器人。

广告位 · 招租中

广告位招租

在这里展示你的产品，支持项目持续维护。

咨询广告合作 · leeguoooo@gmail.com

bash

# 一行装好 CLI —— 无 npm、无 token
$ curl -fsSL https://raw.githubusercontent.com/leeguooooo/chrome-use/main/install.sh | sh

✅ 第一次来？

先读安装装上浏览器扩展并连你的真实 Chrome，再走一遍核心循环（snapshot → find → act）——这就是你用 chrome-use 干活的 90%。

为什么用 chrome-use

把 agent 接到你正在使用的 Chrome 配置文件，复用现有登录态。你可以看着它操作，网站需要验证时接管。新建浏览器上下文默认没有这些会话；其他自动化工具也支持持久化配置或已有浏览器连接，选型要比较实际连接路径。

🔒 你真实、已登录的 Chrome

cookies、登录态、指纹全是真的——因为它就是你的真实浏览器。检测结果仅代表已测环境，不保证所有网站都放行。

🧩 走扩展，不走调试端口

一键商店扩展 + 原生消息，不走 --remote-debugging-port，所以永远不弹「Allow remote debugging?」。

🎨 多 agent 隔离

每个 --session 拿到自己彩色的标签组，多个 agent 共用一个真实 Chrome 互不打架。

🕵️ 后台静默运行

全程在后台跑——新标签页不抢焦点，agent 永远不强制前置某个标签、不偷你正在看的前台窗口。

为什么不直接用……

Playwright / Puppeteer / browser-use？新建浏览器上下文没有现有登录态；这些工具也支持持久化上下文或连接已有浏览器，需要比较具体连接方式和会话管理。chrome-use 复用你已有的会话。
Claude 的 Chrome 插件？很好用，但只能给 Claude 用。chrome-use 给任意 agent / CLI 用，同一套真实浏览器。
裸 --remote-debugging-port（CDP）？Chrome 136 限制默认配置文件的远程调试；具体要求随版本和连接模式而变。chrome-use 永远不弹——一键商店扩展，走原生消息。

ℹ️ 拿数据说话

真实浏览器指纹拿去实测过最硬的公开检测器：CreepJS 0% 机器人 · 0% headless，无 Runtime.enable CDP 泄漏（默认关），权限面极小—— 12 个权限，无 <all_urls>。详见连接真实 Chrome 与反检测。

检测结果能说明什么

公开 CreepJS 测试报告为 0% bot、0% headless。这是特定环境的测量，不保证无法被检测或账号不会被封。网站还会判断操作行为、账号历史和网络信号。请查看测试条件；登录验证交给用户处理。

🛡️ CreepJS 0% 机器人 · 0% headless

走扩展连你的真实 Chrome 时不注入任何 JS 补丁——没有伪装，也就没有破绽给测谎器抓。bot.incolumitas / sannysoft / BrowserScan 全绿。

⚙️ 原生覆盖 > JS 谎言

--launch 独立浏览器用原生覆盖：navigator.webdriver=false（Emulation.setAutomationOverride）、timezone、WebRTC 本地 IP、canvas/audio 噪声——都不是能被反查的重定义 getter。headless 默认禁用（本身就是机器人特征）。

🖐️ --humanize 过行为检测

指纹之外，Akamai / PerimeterX / DataDome 还打行为分。开启后光标走曲线贝塞尔轨迹、落在元素内的抖动点、打字节奏可变——且自适应：命中这些厂商的页面自动升级，普通站保持瞬时零开销。

☁️ Cloudflare 一次通过复用

过一次挑战拿到的 cf_clearance（绑 IP+UA）被保存复用，不用每次重刷。随时 chrome-use stealth status 自查 webdriver / chrome / plugins / UA 探针。

反检测与隐身 →