企业官网建设流程全解析

Docker 部署 Claude：10 分钟把一个 AI 应用直接跑进容器

【免费下载链接】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

明天要交 demo，本地装依赖来不及，怎么办？把应用直接容器化。claude-quickstarts 是 Anthropic 维护的一组示例项目，仓库里每个子项目都是一个基于 Claude API、可直接部署的应用：客服助手、金融数据分析、桌面自动化、自主编码……拿过来配个密钥就能跑，不用自己拼框架、配环境。Docker 部署 Claude、用容器跑 AI 应用，就是下面这条链路的顺序：克隆、配密钥、构建镜像、启动容器。

动手前，两分钟确认环境

需要 Linux、macOS 或 Windows 上装了 20.10 以上的 Docker、约 2GB 可用内存、一个 Claude API 密钥，网络能正常拉取基础镜像。先敲这两条核对：

docker --version echo $ANTHROPIC_API_KEY

第一条输出不低于 20.10 即可，第二条能看到一串sk-ant-开头的值才算密钥就绪。

先把代码拉到本地

仓库不大，克隆下来进入你要部署的子目录。每个子项目都是独立工程，后面所有构建和启动操作都在子目录里进行：

git clone https://gitcode.com/GitHub_Trending/an/claude-quickstarts cd claude-quickstarts/browser-use-demo

目录结构里能看到agent_demo、image、tests等文件夹，说明代码完整。

密钥怎么注入容器

这一步是整个链路里最容易翻车的地方。子目录里带了.env.example模板，复制一份改名叫.env，再把里面的ANTHROPIC_API_KEY换成真实密钥：

cp .env.example .env

然后用编辑器打开.env填好密钥。compose 文件只会读取.env，不会碰.example，漏掉这个复制动作，容器起来后调用 API 必然认证失败。

构建镜像

在子目录执行构建，compose 会按里面的Dockerfile逐层执行，装好 X11、VNC、Python 等桌面自动化依赖：

docker-compose build

最后一行出现Successfully built就对了。这一步最耗时，取决于网络。

启动容器并验证

后台拉起服务，再看一眼进程状态：

docker-compose up -d docker ps

docker ps里这个容器状态是Up，就说明容器化部署 Claude API 应用成功了。浏览器打开http://localhost:8080进入应用界面，6080端口还能单独看桌面画面。

仓库里还有客服助手这类带 Web 界面的应用：customer-support-agent/暴露了app/api/chat/route.ts这样的 API 接口，方便嵌进自己的业务系统。

挑两个最出效果的子项目看看

🎬computer-use-demo/：Claude 在一个 Linux 桌面容器里截屏、点击、打字，通过浏览器里的 VNC 界面实时围观。它是整个仓库 Docker 化程度最高的示例，也是新手体验 computer use 最直接的入口。跑起来后你看到的每一轮，就是 Agent 的一次"看屏—决策—执行"循环：

🔧agents/：刻意保持精简的 LLM Agent 参考实现，核心逻辑不到 300 行，演示"LLM 在循环中调用工具"的基本模式。内置计算器、代码执行、文件操作、网络搜索等工具，支持接入 MCP 服务器扩展。当你觉得现成应用不够用时，从这里开始改造。

端口冲突、401 和拉取超时，碰上了怎么办

端口被占用：容器起不来或页面打不开，通常是 8080、8501 这类端口已被宿主机其他进程占了。试试在.env里用HTTP_PORT、STREAMLIT_PORT等环境变量覆盖映射，不用改文件本体，换个空闲端口再docker-compose up -d。

调用报 401：服务正常启动了，但一调 API 就认证失败，多半是.env里还留着占位值，或者密钥没真正进容器环境。确认真实密钥已保存，然后docker-compose up -d重启一遍，让环境变量重新注入。

docker build卡住或超时：拉基础镜像的网络不稳，卡在Downloading layer。给 Docker 配个镜像加速源，或者换个网络好的时段重试。已完成的层有本地缓存，重跑不会从头开始。

下一步：动手改一次

去agents/tools/下，照现有工具的写法加一个调你自己接口的工具，跑一遍，看 Agent 怎么多调一次、输出变成什么样——这是理解 Docker 部署 LLM Agent 能力边界最快的方式。仓库里还有浏览器自动化、自主编码、托管 Agent 等子项目，都按上面同一套流程部署。这条链路，就是你以后部署任何 AI 应用 Docker 镜像的通用模板了。

【免费下载链接】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