claude-quickstarts 快速跑通5 种启动方式完整实战对照【免费下载链接】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 是官方 Claude API quickstart 项目集把读文档写 demo合并成了一组可直接运行的命令。这里覆盖 5 种启动通道每条都给出可粘贴命令跑完后你能对任意子项目选对启动路径。项目 30 秒扫描9 个子项目4 类启动形态覆盖 9 个 Quickstart客服、金融、桌面、浏览器、自主编码等启动形态 4 类npm dev / Docker / Compose / Python CLI每个子项目都是参考实现模式可直接搬走Agent 循环骨架见 agent.py不到 300 行而它们的第一步都一样选对启动方式接上 API key。启动方式选路决策表按你手里的环境选方案参数 / 触发方式你手里有什么典型场景Next.js dev servernpm install npm run devAPI key客服版还需 AWS key聊天界面、知识库、金融图表Docker 单容器docker run -p 8080:8080 ...API key Docker虚拟桌面控制远端看屏Docker Composedocker-compose up --buildAPI key Compose纯浏览器自动化DOM 操作Python 本地 CLIpython -m computer_use ...API key macOS建议 VM真桌面控制截图点击循环脚本长任务python autonomous_agent_demo.pyAPI key Claude Code SDK跨会话自主生成应用所有方案都要求ANTHROPIC_API_KEY在 Anthropic 控制台创建Web 应用默认端口 3000容器应用 8080clone 后的目录名统一是claude-quickstarts。一、Next.js dev server配 key 即跑 想要带知识库的客服聊天界面customer-support-agent或上传文件出图表financial-data-analyst走这条。git clone https://gitcode.com/GitHub_Trending/an/claude-quickstarts cd claude-quickstarts/customer-support-agent npm install echo ANTHROPIC_API_KEYyour_api_key .env.local npm run dev.env.localkey 文件放子项目根目录Next.js 启动时读取改完必须重启客服版还需BAWS_ACCESS_KEY_ID/BAWS_SECRET_ACCESS_KEYB 前缀是 Amplify 对 AWS- 前缀的限制npm run dev默认端口 3000另有dev:chat仅聊天区等变体financial-data-analyst 只写 ANTHROPIC_API_KEY要求 Node 18key 已填却空回复或 401通常是漏建.env.local或没重启进程客服版知识库 ID 在 ChatArea.tsx 的knowledgeBases数组里登记写错 ID 回答就没有知识库上下文。二、Docker 单容器虚拟桌面一条命令拉起 ️想让 Claude 控制一台完整 Linux 桌面鼠标 键盘 屏幕又不想自己装 X11 和 VNC。export ANTHROPIC_API_KEYyour_api_key docker run \ -e ANTHROPIC_API_KEY$ANTHROPIC_API_KEY \ -v $HOME/.anthropic:/home/computeruse/.anthropic \ -p 8080:8080 -p 6080:6080 -p 8501:8501 -p 5900:5900 \ -it ghcr.io/anthropics/anthropic-quickstarts:computer-use-demo-latest-p 8080整合界面聊天 屏幕视图入口就它-p 6080/-p 5900NoVNC 浏览器看屏 / VNC 客户端直连-v $HOME/.anthropic持久化 API key 与自定义 system prompt镜像预构建无需本地 build分辨率官方建议 XGA1024x768超过就自己缩放依赖 API 自动缩放会降低精度和速度坐标与图像缩放逻辑在 computer.py。三、Docker Compose纯浏览器自动化DOM 级点击 只需要操作浏览器读 DOM、填表单、抽文本不需要完整桌面时选它。cd claude-quickstarts/browser-use-demo cp .env.example .env # 写入 ANTHROPIC_API_KEY docker-compose up --build.env只填 key视口固定 1920x108016:9--build生产构建开发加--watch可同步代码变更端口分工8080 Streamlit 主界面6080 NoVNC5900 VNC主界面搜 google.com 容易触发 CAPTCHA把 prompt 换成指定站点视口 1920x1080 而模型按 1456x819 处理点击坐标由 coordinate_scaling.py 自动换算别手改。四、Python 本地 CLImacOS 真桌面控制 有 macOS 环境官方强烈建议 VM想读透截图-点击循环的参考实现显式工具、prompt caching、轨迹记录全都有。cd claude-quickstarts/computer-use-best-practices python -m pip install -r requirements.txt python -m playwright install chromium echo ANTHROPIC_API_KEYyour_api_key .env python -m computer_use open TextEdit and type hello world需 Python 3.11macOS 自带 3.9 不行先装新版本常用 flags--model、--thinking {off,low,medium,high,max}、--max-iters N轨迹写入runs/timestamp/可用 Streamlit viewer 回看别在真机跑agent 全权控制鼠标键盘屏幕首次运行要给终端授予 Screen Recording Accessibility 权限预检逻辑在 preflight.py没授权截图和键鼠全废。五、脚本长任务自主编码跨会话生成 想让 Claude 从一份规格文档跨多个会话建完整应用进度靠 git 和 feature 列表持久化。cd claude-quickstarts/autonomous-coding npm install -g anthropic-ai/claude-code pip install -r requirements.txt export ANTHROPIC_API_KEYyour_api_key python autonomous_agent_demo.py --project-dir ./my_project --max-iterations 3--project-dir生成项目输出目录默认 ./autonomous_demo_project--max-iterations限制迭代数首跑建议给 3首轮生成 200 条 feature_list.json 用例耗时数分钟看似卡死属正常--model默认 claude-sonnet-4-5-20250929出现 Command blocked by security hook 是 bash 白名单在正常工作只放行 ls、cat、git、npm 等要加命令改 security.py 的ALLOWED_COMMANDS。公共微调旋钮分辨率、思考级别、迭代数WIDTH/HEIGHTcomputer-use-demo容器屏幕分辨率推荐 1024x768CU_ENABLE_COMPUTER_USE_TOOLSfalsebest-practices关掉桌面工具只留浏览器--thinking offbest-practices关闭思考省 token 降延迟--max-iterations Nautonomous-coding限制单次会话迭代常见报错速查端口、权限、卡死都在这QBrowser not visibleA6080 不通或 Docker 资源不足 → 查端口映射、刷新 NoVNC 页面、给 Docker 加资源。QCommand blocked by security hookA命令不在白名单属正常拦截 → 需要就加进 security.py 的ALLOWED_COMMANDS。QAppears to hang on first runAinitializer 正在写 200 条测试用例 → 盯着[Tool: ...]输出它在干活别 kill。QAPI errorsAkey 未设或模型不兼容 → 复核ANTHROPIC_API_KEY换用该 quickstart 支持的模型。Q几种方案到底怎么选A要 Web 聊天界面用 npm dev server虚拟桌面用 docker run纯浏览器自动化用 docker-composemacOS 真桌面用 python -m computer_use跨会话自主编码用 autonomous_agent_demo.py只想读循环骨架看 agents/。最后在隔离环境把 5 条命令各跑一遍分别对照 3000、8080、6080 端口和终端输出再决定基于哪个 quickstart 开发。【免费下载链接】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），仅供参考