Docker 部署 Claude 浏览器自动化应用browser-use-demo 容器化上手指南【免费下载链接】claude-quickstartsA collection of projects designed to help developers quickly get started with building deployable applications using the Claude API项目地址: https://gitcode.com/GitHub_Trending/an/claude-quickstartsClaude Quickstarts 是 Anthropic 官方提供的一组基于 Claude API 的应用模板覆盖智能客服、金融数据分析、浏览器与桌面自动化等场景。本文以其中的browser-use-demo为例说明如何用 Docker 把聊天界面 受控浏览器完整跑起来模板本身即容器化实现执行构建命令后浏览器自动导航、读取网页、填写表单等能力开箱可用。为什么选这组模板官方参考实现API 调用方式可直接复用容器隔离浏览器/桌面操作不进宿主机模板间代码模式一致改一处即可迁移内置 Streamlit 界面与 NoVNC 远程桌面环境自检清单部署前逐项确认可避免大多数启动失败已安装 Docker Engine 20.10 及以上版本并可用 Docker Compose宿主机 5900、8501、6080、8080 端口空闲或愿意在配置中改绑已在 Claude Console 申请到 ANTHROPIC_API_KEY预留足够的磁盘空间用于拉取和构建镜像建议容器可用内存 2GB 以上部署实操镜像构建与容器启动克隆仓库并进入模板目录执行以下命令仓库只需克隆一次后续各模板共用git clone https://gitcode.com/GitHub_Trending/an/claude-quickstarts cd claude-quickstarts/browser-use-demo配置环境变量文件执行以下命令生成配置文件然后编辑.env将ANTHROPIC_API_KEY占位值替换为真实密钥文件末尾还提供VNC_PORT、STREAMLIT_PORT、NOVNC_PORT、HTTP_PORT四个可选端口项默认 5900、8501、6080、8080cp .env.example .envdocker-compose.yml已声明以当前目录为构建上下文无需单独执行构建命令。用 Docker Compose 构建并启动执行以下命令Compose 会自动构建镜像并启动容器首次构建需下载 Playwright 与浏览器依赖耗时较长属正常现象docker-compose up --build容器就绪后通过三个入口验证部署结果浏览器访问http://localhost:8080打开 Streamlit 聊天界面输入导航到某新闻站并告诉我前 3 条标题即可观察模型自主操作浏览器http://localhost:6080/vnc.html提供 NoVNC 远程桌面用于实时观看浏览器画面5900 端口供 VNC 客户端直连。开发阶段可改用docker-compose up --build --watch源码文件变动会自动同步重启容器。仓库内另一套桌面级演示 computer-use-demo/ 走的是预构建镜像路线执行以下命令直接拉起 Linux 桌面X11 VNC同样映射 8080 与 6080 两个入口docker run -e ANTHROPIC_API_KEY$ANTHROPIC_API_KEY \ -p 5900:5900 -p 8501:8501 -p 6080:6080 -p 8080:8080 \ -it ghcr.io/anthropics/anthropic-quickstarts:computer-use-demo-latest它支持多代模型与多版本计算机工具集侧边栏可切换适合作为通用桌面控制的参考。关键目录导读browser-use-demo/容器内浏览器自动化的核心模块browser_use_demo/loop.py是模型与 API 的采样循环browser_use_demo/tools/browser.py定义全部浏览器动作browser_use_demo/browser_tool_utils/存放 DOM 提取的 JavaScript 工具。computer-use-demo/桌面级演示含image/下的 Xvfb、x11vnc 等容器启动脚本与 Dockerfile。agents/通用智能体示例含 agents/tools/ 下的 MCP 接入、代码执行、网络搜索等工具定义可作为自研工具的结构参照。调优与安全要点️ 分辨率README 明确不建议向 API 发送超过 XGA 的截图否则 API 侧缩放会降低精度并拖慢响应需要高分辨率时应自行缩放并回映射坐标可参考coordinate_scaling.py的实现。 端口与资源四个端口均可在.env中改绑避免与宿主机服务冲突为容器设置内存上限并配置日志轮转防止长期运行占满磁盘。 密钥管理API 密钥只写入.env该文件已在.gitignore中排除不要提交到版本库。⚠️ 网络隔离容器内浏览器已具备隔离性但访问互联网时建议配置域名白名单减少接触恶意内容的概率。⚠️ 数据与确认不要让模型接触账号登录信息等敏感数据对金融交易、同意条款等产生实际后果的操作保留人工确认。常见问题端口冲突.env中对应的*_PORT项改为宿主机空闲端口后重启容器即可也可用docker ps查看当前占用情况。提示 API 密钥无效核对.env中的值是否完整、无多余空格确认该密钥对应的账号已开通 Claude API 权限且余额有效。8080 可访问但 6080 看不到浏览器画面确认容器仍在运行、6080 端口未被防火墙拦截然后在 NoVNC 页面刷新重试仍无画面时检查宿主机分配给 Docker 的资源是否充足。部署完成后建议从 browser-use-demo/browser_use_demo/loop.py 入手阅读请求处理逻辑再对照tools/browser.py的工具定义扩展自己的动作若需要 macOS 原生环境的最佳实践版本可继续看computer-use-best-practices模板。【免费下载链接】claude-quickstartsA collection of projects designed to help developers quickly get started with building deployable applications using the Claude API项目地址: https://gitcode.com/GitHub_Trending/an/claude-quickstarts创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Docker 部署 Claude 浏览器自动化应用：browser-use-demo 容器化上手指南
Docker 部署 Claude 浏览器自动化应用browser-use-demo 容器化上手指南【免费下载链接】claude-quickstartsA collection of projects designed to help developers quickly get started with building deployable applications using the Claude API项目地址: https://gitcode.com/GitHub_Trending/an/claude-quickstartsClaude Quickstarts 是 Anthropic 官方提供的一组基于 Claude API 的应用模板覆盖智能客服、金融数据分析、浏览器与桌面自动化等场景。本文以其中的browser-use-demo为例说明如何用 Docker 把聊天界面 受控浏览器完整跑起来模板本身即容器化实现执行构建命令后浏览器自动导航、读取网页、填写表单等能力开箱可用。为什么选这组模板官方参考实现API 调用方式可直接复用容器隔离浏览器/桌面操作不进宿主机模板间代码模式一致改一处即可迁移内置 Streamlit 界面与 NoVNC 远程桌面环境自检清单部署前逐项确认可避免大多数启动失败已安装 Docker Engine 20.10 及以上版本并可用 Docker Compose宿主机 5900、8501、6080、8080 端口空闲或愿意在配置中改绑已在 Claude Console 申请到 ANTHROPIC_API_KEY预留足够的磁盘空间用于拉取和构建镜像建议容器可用内存 2GB 以上部署实操镜像构建与容器启动克隆仓库并进入模板目录执行以下命令仓库只需克隆一次后续各模板共用git clone https://gitcode.com/GitHub_Trending/an/claude-quickstarts cd claude-quickstarts/browser-use-demo配置环境变量文件执行以下命令生成配置文件然后编辑.env将ANTHROPIC_API_KEY占位值替换为真实密钥文件末尾还提供VNC_PORT、STREAMLIT_PORT、NOVNC_PORT、HTTP_PORT四个可选端口项默认 5900、8501、6080、8080cp .env.example .envdocker-compose.yml已声明以当前目录为构建上下文无需单独执行构建命令。用 Docker Compose 构建并启动执行以下命令Compose 会自动构建镜像并启动容器首次构建需下载 Playwright 与浏览器依赖耗时较长属正常现象docker-compose up --build容器就绪后通过三个入口验证部署结果浏览器访问http://localhost:8080打开 Streamlit 聊天界面输入导航到某新闻站并告诉我前 3 条标题即可观察模型自主操作浏览器http://localhost:6080/vnc.html提供 NoVNC 远程桌面用于实时观看浏览器画面5900 端口供 VNC 客户端直连。开发阶段可改用docker-compose up --build --watch源码文件变动会自动同步重启容器。仓库内另一套桌面级演示 computer-use-demo/ 走的是预构建镜像路线执行以下命令直接拉起 Linux 桌面X11 VNC同样映射 8080 与 6080 两个入口docker run -e ANTHROPIC_API_KEY$ANTHROPIC_API_KEY \ -p 5900:5900 -p 8501:8501 -p 6080:6080 -p 8080:8080 \ -it ghcr.io/anthropics/anthropic-quickstarts:computer-use-demo-latest它支持多代模型与多版本计算机工具集侧边栏可切换适合作为通用桌面控制的参考。关键目录导读browser-use-demo/容器内浏览器自动化的核心模块browser_use_demo/loop.py是模型与 API 的采样循环browser_use_demo/tools/browser.py定义全部浏览器动作browser_use_demo/browser_tool_utils/存放 DOM 提取的 JavaScript 工具。computer-use-demo/桌面级演示含image/下的 Xvfb、x11vnc 等容器启动脚本与 Dockerfile。agents/通用智能体示例含 agents/tools/ 下的 MCP 接入、代码执行、网络搜索等工具定义可作为自研工具的结构参照。调优与安全要点️ 分辨率README 明确不建议向 API 发送超过 XGA 的截图否则 API 侧缩放会降低精度并拖慢响应需要高分辨率时应自行缩放并回映射坐标可参考coordinate_scaling.py的实现。 端口与资源四个端口均可在.env中改绑避免与宿主机服务冲突为容器设置内存上限并配置日志轮转防止长期运行占满磁盘。 密钥管理API 密钥只写入.env该文件已在.gitignore中排除不要提交到版本库。⚠️ 网络隔离容器内浏览器已具备隔离性但访问互联网时建议配置域名白名单减少接触恶意内容的概率。⚠️ 数据与确认不要让模型接触账号登录信息等敏感数据对金融交易、同意条款等产生实际后果的操作保留人工确认。常见问题端口冲突.env中对应的*_PORT项改为宿主机空闲端口后重启容器即可也可用docker ps查看当前占用情况。提示 API 密钥无效核对.env中的值是否完整、无多余空格确认该密钥对应的账号已开通 Claude API 权限且余额有效。8080 可访问但 6080 看不到浏览器画面确认容器仍在运行、6080 端口未被防火墙拦截然后在 NoVNC 页面刷新重试仍无画面时检查宿主机分配给 Docker 的资源是否充足。部署完成后建议从 browser-use-demo/browser_use_demo/loop.py 入手阅读请求处理逻辑再对照tools/browser.py的工具定义扩展自己的动作若需要 macOS 原生环境的最佳实践版本可继续看computer-use-best-practices模板。【免费下载链接】claude-quickstartsA collection of projects designed to help developers quickly get started with building deployable applications using the Claude API项目地址: https://gitcode.com/GitHub_Trending/an/claude-quickstarts创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考