浏览器自动化新境界:使用claude-code-local控制Brave浏览器的完整教程
**claude-code-local** 是一个革命性的本地AI代理工具,让你能够完全在本地设备上运行Claude Code,并通过本地AI模型控制Brave浏览器实现自动化操作。这个强大的工具支持Apple Silicon芯片,提供Gemma 4 31B、Llama 3.3 70B和Qwen 3.5 122B等多种大型语言模型,让你在完全离线、私密的环境中实现浏览器自动化。## 🎯 为什
浏览器自动化新境界:使用claude-code-local控制Brave浏览器的完整教程
claude-code-local 是一个革命性的本地AI代理工具,让你能够完全在本地设备上运行Claude Code,并通过本地AI模型控制Brave浏览器实现自动化操作。这个强大的工具支持Apple Silicon芯片,提供Gemma 4 31B、Llama 3.3 70B和Qwen 3.5 122B等多种大型语言模型,让你在完全离线、私密的环境中实现浏览器自动化。
🎯 为什么选择claude-code-local控制浏览器?
传统的浏览器自动化工具需要依赖云端服务或复杂的脚本编写,而claude-code-local 提供了全新的解决方案:
- 100%本地运行:所有AI推理都在你的MacBook上进行,无需网络连接
- 完全隐私保护:敏感数据永不离开你的设备
- 高速响应:Qwen 3.5模型可达65 tokens/秒的推理速度
- 支持真实浏览器:通过Chrome DevTools协议控制真实的Brave浏览器
🚀 一键安装配置步骤
第一步:克隆项目仓库
git clone https://gitcode.com/gh_mirrors/cl/claude-code-local
cd claude-code-local
第二步:设置MLX虚拟环境
./setup.sh
这个脚本会自动为你配置Python虚拟环境并安装所有必要的依赖项。
第三步:选择AI模型并下载
claude-code-local支持三种强大的本地AI模型:
| 模型 | 大小 | 速度 | 适用场景 |
|---|---|---|---|
| Gemma 4 31B | ~18GB | 中等 | 日常浏览器自动化 |
| Llama 3.3 70B | ~40GB | 较慢 | 复杂任务处理 |
| Qwen 3.5 122B | ~75GB | 65 tok/s | 高性能需求 |
选择适合你需求的模型进行下载,这通常是一次性的过程。
第四步:启动MLX服务器
./scripts/start-mlx-server.sh
服务器启动后,会在本地端口提供Anthropic API兼容接口。
🌐 配置浏览器代理模块
浏览器代理功能通过独立的browser-agent项目实现,但claude-code-local已经为你准备好了便捷的启动器。
智能内存管理管道
claude-code-local的浏览器代理采用了创新的上下文记忆系统:
| 特性 | 传统方式 | claude-code-local改进 |
|---|---|---|
| 内存管理 | 5步后硬性删除 | 32K预算的60%智能修剪 |
| 修剪策略 | 完全删除旧步骤 | 压缩为摘要保留 |
| 原始任务 | 6步后丢失 | 每个周期重新注入 |
| 可见性 | 无状态显示 | 彩色编码上下文计量器 |
| 响应tokens | 1,024 | 2,048 |
启动浏览器代理
只需双击launchers/Browser Agent.command文件,系统会自动:
- 启动MLX服务器
- 打开带远程调试功能的Brave浏览器
- 启动浏览器代理控制台
🎮 浏览器自动化实战指南
基本控制命令
一旦浏览器代理启动,你可以通过自然语言指令控制Brave浏览器:
📝 你的任务
│
🤖 agent.py ← 自主浏览器代理
│
⚡ MLX服务器 ← 本地AI决策
(Gemma · Llama · Qwen)
│
🌐 Brave浏览器 ← 点击、输入、导航
(CDP端口9222)
│
📊 上下文计量器 ← 显示内存使用情况
实际应用场景
场景一:自动化网页数据收集
- "打开Brave浏览器,访问GitHub趋势页面"
- "提取前10个热门仓库的名称和星标数"
- "将结果保存为CSV文件"
场景二:表单自动填写
- "导航到注册页面"
- "填写姓名、邮箱、密码字段"
- "勾选同意条款复选框"
- "点击提交按钮"
场景三:内容监控与通知
- "每30分钟检查一次新闻网站"
- "如果有新文章,提取标题和摘要"
- "通过系统通知提醒我"
🔧 高级配置技巧
优化MLX浏览器模式
编辑launchers/lib/local-settings.json文件,调整浏览器相关参数:
{
"MLX_BROWSER_MODE": "optimized",
"max_context_tokens": 32768,
"response_tokens": 2048
}
集成MCP服务器生态系统
claude-code-local支持完整的MCP(Model Context Protocol)服务器生态系统:
- 文件系统MCP:访问本地项目文件
- GitHub MCP:管理代码仓库和PR
- Brave搜索MCP:安全的网页搜索功能
📊 性能监控与优化
浏览器代理会实时显示上下文使用情况:
Step 5 snapshot() 2.2s
→ [101] heading "The Best Coffee Cake Recipe"...
[Context: 18% ████░░░░░░░░░░░░░░░░ 6K/32K tokens]
颜色编码让你一目了然:
- 绿色:充足的内存空间
- 黄色:中等使用率
- 红色:接近内存限制
🛡️ 安全与隐私保障
数据流完全本地化
你的MacBook → MLX服务器 → 本地AI模型 → Brave浏览器
↑ ↓
本地存储 ← 处理结果 ← 网页数据
所有数据都在你的设备内部循环,特别适合:
- 法律文件处理:NDA保密协议审查
- 医疗记录分析:患者隐私保护
- 金融数据操作:敏感财务信息
- 企业内部文档:商业机密保护
💡 常见问题解答
Q: 需要互联网连接吗? A: 只有在初始下载模型时需要网络,之后可以完全离线运行。
Q: 支持哪些浏览器? A: 主要支持Brave浏览器,理论上也支持其他基于Chromium的浏览器。
Q: 需要多少存储空间? A: 根据选择的模型,需要18GB到75GB的存储空间。
Q: 运行速度如何? A: 在M系列Apple Silicon芯片上,Qwen 3.5模型可达65 tokens/秒。
🎯 总结
claude-code-local为浏览器自动化带来了全新的可能性。通过将强大的本地AI模型与真实的Brave浏览器相结合,你可以在完全私密的环境中实现复杂的网页操作。无论是数据收集、表单填写还是内容监控,这个工具都能提供高效、安全的解决方案。
核心优势总结:
- ✅ 完全离线运行,数据永不离开设备
- ✅ 支持真实的Brave浏览器控制
- ✅ 智能上下文记忆管理系统
- ✅ 多种AI模型选择,适应不同需求
- ✅ 完整的MCP服务器生态系统支持
现在就开始你的本地浏览器自动化之旅吧!只需几个简单的步骤,你就能体验到AI驱动的浏览器控制带来的效率和便利。
更多推荐



所有评论(0)