ARTICLE DETAIL

资讯详情

深耕编程入门与网站建设的一线实战洞察。

Claude Quickstarts 容器化部署指南:3 条命令跑通浏览器自动化 Demo

Claude Quickstarts 容器化部署指南:3 条命令跑通浏览器自动化 Demo Claude Quickstarts 容器化部署指南3 条命令跑通浏览器自动化 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 应用集合其中浏览器自动化和计算机操作两个 demo 能直接跑进 Docker。照本文走克隆、填 key、构建启动共 3 条命令本地不用装任何依赖。开工前核对这几项先确认 4 件事缺任何一项都会在后面卡住Docker Engine 不低于 20.10 版本跑docker --version确认主机空闲内存 2GB 以上——容器里要同时跑 Xvfb 虚拟桌面和 Chromium已有 Claude API key网络能正常拉取基础镜像磁盘预留 5GB 以上顺带一提仓库里的customer-support-agent是 Next.js 应用走npm install本地跑不属于容器化路线本文不展开。密钥怎么进容器先说结论密钥只经过.env这一个文件不写进镜像。browser-use-demo目录下的.env.example提供了模板里面ANTHROPIC_API_KEY是占位值docker-compose.yml 靠env_file: .env和ANTHROPIC_API_KEY${ANTHROPIC_API_KEY}两行把它带进容器。四个端口同样支持在.env里覆盖VNC_PORT默认 5900、STREAMLIT_PORT8501、NOVNC_PORT6080、HTTP_PORT8080。后面遇到端口冲突只改.env就行。工程师视角的一点密钥放.env而不是 Dockerfile换 key 时改一个文件重启容器即可不用重新构建。三条命令把容器跑起来第 1 条克隆仓库进入 demo 目录。git clone https://gitcode.com/GitHub_Trending/an/claude-quickstarts cd claude-quickstarts/browser-use-demo目录下能看到Dockerfile、docker-compose.yml、.env.example就说明到位了。第 2 条复制模板并填密钥。cp .env.example .env编辑.env把ANTHROPIC_API_KEY的占位值换成真实 key保存。第 3 条构建并启动。docker-compose up --build做对了长这样日志先逐层拉取含 Chromium 的基础镜像首次约 3~8 分钟随后容器起服务docker ps里容器状态为Up8080、6080 端口已映射。不想构建、想更省事的话computer-use-demo 有官方预构建镜像一条命令直接跑细节见 computer-use-demo/README.mddocker run -it -e ANTHROPIC_API_KEY$ANTHROPIC_API_KEY \ -p 8080:8080 -p 6080:6080 -p 8501:8501 \ ghcr.io/anthropics/anthropic-quickstarts:computer-use-demo-latest第一次启动该看哪里 三个地址各管一件事http://localhost:8080主界面聊天框和桌面视图并排http://localhost:6080NoVNC纯浏览器画面用来实时围观操作http://localhost:8501Streamlit 纯聊天界面在主界面输入Navigate to news.ycombinator.com and tell me the top 3 stories然后切到 6080 看它一步步点开网页。计算机操作 demo 的运行轨迹可以参考这张官方示例图值得盯住的一个细节demo 里的点击不靠像素坐标而是给页面元素编号ref后按编号定位窗口怎么缩放都不会点偏。这套逻辑在browser-use-demo/tools/browser.py里想看实现直接读它。启动卡住时对照这份报错速查⚠️ 四类最常见的报错全部按报错原文 → 一句话判断 → 解决动作给port is already allocated→ 8080 或 6080 被本机其他服务占着。 → 在.env里设HTTP_PORT8090或NOVNC_PORT6081重跑docker-compose up -d。401 invalid_api_key→.env里还是占位值或改完 key 没重启容器。 → 替换成真实 key 并保存再执行docker-compose up -d --force-recreate让环境变量生效。Pulling ... Downloading layer十几分钟没动静 → 基础镜像含 Chromium体积大网络不稳时容易断。 → 给 Docker 配置镜像加速源或换网络空闲时段重跑已拉下的层有本地缓存不会从头再来。8080 页面正常打开6080 却是空白 → VNC 服务还没就绪或 Docker 分配的内存不够。 → 先刷新 NoVNC 页面重试仍空白就把 Docker Desktop 内存配额调到 4GB再docker-compose up -d。收束成模板再往前推一步✅ 到这里整条链路可以固定下来克隆仓库 → 把 key 写进.env→docker-compose up --build→ 三个端口逐一验证。仓库里其他容器化 demo 照这个顺序走就行。延伸动作打开 agents/tools/calculator_mcp.py这个工具只有 55 行照着它的写法在agents/tools/下再加一个自定义工具然后看 agents/agent.py 里 173 行的核心循环如何把它接进去——这是理解 Agent 工具边界最快的路径。【免费下载链接】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),仅供参考
返回列表