FEATURED · 精选文章

claude-quickstarts 的 Docker 部署:10 分钟从零到跑通的完整流程

发布时间 / 2026/9/9 21:45:32
来源 / 创域科博编辑部
栏目 / 资讯中心
claude-quickstarts 的 Docker 部署:10 分钟从零到跑通的完整流程 claude-quickstarts 的 Docker 部署10 分钟从零到跑通的完整流程【免费下载链接】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花 10 分钟你会得到 claude-quickstarts 里一个跑在容器里的客服助手能带着知识库回答用户问题本地一个依赖都不用装。全文先给你看部署完长什么样再按最短的 3 条命令走通一遍然后把每一步拆开讲清完成标志最后留一张排障速查表。适合第一次碰 Docker 的同学。先看效果部署完成后你会打开两个页面。客服应用是三栏布局左侧滚动显示模型的推理过程中间是对话区右侧列出每次知识库检索命中的来源。金融分析应用更直接你丢一份 CSV 进去聊天框里就开始往外吐图表。两张图都来自仓库自带素材和实际运行画面一致。 3 条命令先跑起来下面用 browser-use-demo浏览器自动化演示做跟练对象因为它是仓库里唯一把密钥模板和编排文件都备齐的目录。3 条命令敲完你就有一个能访问的服务。git clone https://gitcode.com/GitHub_Trending/an/claude-quickstarts cd claude-quickstarts/browser-use-demo把仓库拿到本地落脚到配置齐全的目录里。cp .env.example .env生成一个带占位符的 .env打开它把 ANTHROPIC_API_KEY 的值换成你的真实密钥。docker-compose up --build这一条最耗时间先逐层构建镜像再启动容器。跑完后浏览器打开 http://localhost:8080 就是主界面http://localhost:6080 是 VNC 桌面视角。✅ 把链路拆开讲上面 3 条命令能跑但你得知道每一步做到位是什么样出问题时才知道卡在哪。确认 Docker 版本达标容器步骤全部依赖 Docker Engine老版本可能缺 compose 等能力先花 5 秒确认一下。docker --version完成标志输出的版本号在 20.10 及以上例如 Docker version 24.0。低于这个数字先升级再继续。把密钥填进 .env.env 在容器启动时被读取密钥仍是占位符的话容器内每次调 API 都会认证失败且报错不会提示你密钥是假的。sed -i s/your_anthropic_api_key_here/你的真实密钥/ .env完成标志执行grep ANTHROPIC_API_KEY .env输出的一行以ANTHROPIC_API_KEYsk-ant-开头。验证容器真的起来了docker-compose up --build在前台跑终端打出 Up 不代表容器内进程已经监听端口用状态命令复核一次。docker-compose ps完成标志列表里有一行 STATUS 含 UpPORTS 列能看到 8080 的端口映射。验证页面返回 200容器状态 Up 和网页能访问之间还差一步内部服务可能刚拉起还没就绪。用 HTTP 状态码当验收标准比看进程状态可靠。curl -sI http://localhost:8080 | head -n 1完成标志第一行包含HTTP/1.1 200 OK。此时浏览器里应能看到 Streamlit 聊天界面。 按场景挑模块仓库里每个子目录都是一个可部署应用按你的用途挑而不是按目录名翻。做客服问答的选 customer-support-agent。它是完整的智能服务台带 Web 界面也暴露 API 接口见 app/api/chat/route.ts方便嵌进自家业务系统。它跑在 Node 里npm install后npm run dev打开 localhost:3000 即可比容器更轻量适合演示企业级客服。做数据可视化的选 financial-data-analyst。在对话里直接生成图表适合分析师和数据团队做报表问答界面元素和上文第二张图一致。想体验桌面自动化的选 computer-use-demo。Claude 在一个 Linux 桌面容器里截屏、点击、打字你在 http://localhost:6080/vnc.html 里实时旁观整个操作过程是新手看 computer use 能力最直观的入口。只做网页操作的选 browser-use-demo。Claude 通过读取 DOM 结构来导航、填表、抓取内容比像素坐标更稳也是本文的跟练对象。现成应用都不够用的选 agents。这是一个刻意精简的参考实现核心循环不到 300 行代码内置计算器、代码执行、文件操作、网络搜索还支持接 MCP 服务器加新工具从这里改造起步成本最低。⚠️ 排障速查表现象常见原因解决办法页面打不开提示端口被占用宿主机的 8080 已被其他进程占走在 .env 里加一行HTTP_PORT8090compose 会自动读取调用报 401 认证失败.env 里密钥还是占位符或没注入容器换成真实密钥重跑docker-compose up -d让变量生效构建卡在 Downloading layer网络拉不到基础镜像给 Docker 配镜像加速源或换时段重试已下载的层有缓存不会从头再来提示 docker-compose 命令不存在新版 Docker 只带 v2 语法改用不带连字符的docker compose up --build 从能跑到用好跑通只是起点下面两个动作各花不到 10 分钟做完你会对这套部署链路有手感。换一个端口。browser-use-demo 的 compose 文件把端口做成了变量你不用碰文件本体echo HTTP_PORT8090 .env docker-compose up -d做完后的现象浏览器打开 localhost:8090 能看到完整界面原 8080 地址不再响应——说明端口覆盖真的生效了。给 agents 加一个工具。照 agents/tools/ 里任意一个文件的结构写一个新工具比如查实时汇率然后在循环里让 Agent 调用它。做完后的现象对话里会多出一段工具调用记录打印工具名和它返回的实时数据回答内容随即引用了刚查到的数字——这正是理解 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),仅供参考
RELATED — 相关阅读

相关资讯

LATEST — 最新资讯

最新发布

TODAY — 本日精选

新闻

WEEKLY — 本周精选

新闻

MONTHLY — 本月精选

新闻