别再啃文档了:让 AI Agent 手把手带你入门一个新平台

以 Cloudflare Workers 为例，演示如何通过 Claude Code / Codex 等 Agent，从零到部署只靠对话完成

你是不是也这样入门新平台？

拿到一个新平台的文档链接，点开一看——Getting Started、Quick Start、Tutorial、API Reference……几十个标签页铺满浏览器，光目录就让人想关掉。

硬着头皮读了两篇，概念还没串起来，手已经不想动了。

更惨的是：你照着文档敲，一路报错。折腾半小时才发现——文档写的是旧版本，平台早就改了。

入门一个新平台，本不该这么累。

这篇文章讲一个反直觉的方法：别自己啃文档，让 AI Agent 替你啃、替你操作，你只负责做决策。

核心思路

传统入门路径长这样：

读文档 → 理解概念 → 找入口 → 跟教程做 → 遇坑搜索 → 继续做 → 勉强跑通

Agent 辅助入门路径变成这样：

告诉 Agent 目标 → Agent 引导操作 → 你做关键决策 → Agent 处理细节 → 快速跑通

看出区别了吗？

你从”执行者”变成了”决策者”。 Agent 负责读文档、查最新信息、写代码、排错；你只管说”做”还是”不做”。

💬 聊两句：我用的是 Claude Code，但 Codex、Cursor、GitHub Copilot、CodeBuddy、Qoder、Trae 都能做类似的事。不同 Agent 在浏览器控制、代码生成、工具调用上各有侧重——你最常用哪个？评论区聊聊，如果人多我出一期 Agent 横评。

实战：从零到部署 Cloudflare Workers

下面是我用 Claude Code + Kimi WebBridge（浏览器控制插件）入门 Cloudflare 的完整过程。全程没自己读一篇文档，没手动写一行代码。

⚠️ 关于界面路径：文中的按钮位置、菜单层级都基于 2026 年 7 月的 Cloudflare Dashboard。平台会改版，入口会挪，但这套”让 Agent 引导你操作”的方法论不会变——无论界面怎么改，Agent 都能实时看到页面，告诉你当前该点哪里。

💬 为什么选 Cloudflare？ 免费额度大方、全球边缘节点、Workers 生态成熟。但 Vercel、AWS Lambda、阿里云函数计算也各有优势。你平时用哪个 Serverless 平台？评论区说说理由，下篇可以对比实测。

第一步：注册账号

我：帮我注册 Cloudflare

Agent：打开注册页面了，建议用 GitHub 授权登录，点那个绿色按钮就行

我：好

Agent：注册成功，你的账号名和 workers.dev 子域名都生成了

要点：Agent 通过浏览器插件直接看到页面，告诉我点哪里、填什么。我只需要在关键授权步骤自己点一下。

第二步：改子域名

我：子域名想改成我的网名

Agent：进入 Workers 页面（侧边栏 Compute → Workers），Subdomain 旁边有个链接，点击就能改

我：改好了

要点：Agent 一开始说子域名不能改，我纠正了它——实际上能改。这就是 Agent 辅助的真实状态：它会犯错，但你可以纠正，它立刻调整。

第三步：创建第一个 Worker

我：创建一个 Hello World Worker

Agent：点击 Create application，选择 Start with Hello World!，部署后访问地址是 xxx.yourname.workers.dev

要点：全程 Agent 引导点击，30 秒完成。Create application 页面有三个选项（Continue with GitHub / Start with Hello World! / Select a template），Agent 直接告诉你选哪个——不用自己挨个点开看。

第四步：在线编辑代码，加路由

我：给 Worker 加几个路由，/hello、/time、/echo

Agent：代码生成好了，粘贴到在线编辑器，点部署

生成的代码：

export default {  async fetch(request) {    const url = new URL(request.url);    if (url.pathname === '/hello') return new Response('Hello from Cloudflare Workers!');    if (url.pathname === '/time') return new Response(new Date().toISOString());    if (url.pathname === '/echo') return new Response(url.searchParams.get('msg') || 'No message');    return new Response('Try /hello, /time, /echo?msg=xxx');  }};

要点：Agent 直接写代码，我只需粘贴部署。从 Hello World 到多路由 API，一步到位。

第五步：绑定 KV 存储

我：加个 KV 存储

Agent：KV Namespace 创建好了，在 Worker 的 Settings → Bindings 里点击 Add a binding 绑定，Variable 名 MY_KV，代码也扩展好了——新增了计数器和键值读写

扩展后的代码：

if (url.pathname === '/counter') {  const count = parseInt(await env.MY_KV.get('counter') || '0') + 1;  await env.MY_KV.put('counter', count.toString());  return new Response(`Visits: ${count}`);}if (url.pathname === '/set') {  await env.MY_KV.put(url.searchParams.get('key'), url.searchParams.get('value'));  return new Response('OK');}if (url.pathname === '/get') {  const value = await env.MY_KV.get(url.searchParams.get('key'));  return new Response(value || 'Not found');}

要点：Agent 不仅告诉我怎么绑定，还直接生成了配套代码。绑定存储 + 写代码，一个对话搞定。

第六步：绑定 D1 数据库

我：加个 D1 数据库

Agent：D1 创建好了，在 Worker 的 Settings → Bindings 里绑定 Variable DB。建表需要在 Console 里执行 SQL，语句给你，代码也扩展好了

建表 SQL：

CREATE TABLE IF NOT EXISTS visits (  id INTEGER PRIMARY KEY AUTOINCREMENT,  path TEXT,  visited_at TEXT);

新增路由：

if (url.pathname === '/visits') {  await env.DB.prepare('INSERT INTO visits (path, visited_at) VALUES (?, ?)')    .bind(request.url, new Date().toISOString()).run();  const { results } = await env.DB.prepare('SELECT * FROM visits ORDER BY id DESC LIMIT 10').all();  return Response.json(results);}

要点：D1 建表要在 Console 里执行 SQL，Agent 连这个都提醒了——不会出现”绑了数据库却忘了建表”的低级错误。

第七步：本地开发环境

我：想本地开发

Agent：用 npm create cloudflare@latest -- my-app --framework=hono，注意 npm create cloud@latest 已废弃

要点：这是 Agent 最值钱的地方——它知道哪个教程过时了。如果我自己搜，大概率踩进 npm create cloud@latest 的坑，再花半小时排查。

💬 框架怎么选？ 我选了 Hono，轻量、类型安全、Cloudflare 官方推荐。但 Itty Router 更小、纯 Worker 零框架也行——你用 Workers 时偏好哪种？评论区聊聊，人多我出一期框架选型指南。

本地开发流程：

npm create cloudflare@latest -- my-app --framework=honocd my-appnpm installnpm run dev      # 本地开发npm run deploy   # 部署到 Cloudflare

第八步：CI/CD 自动部署

我：想 push 代码自动部署

Agent：在 Cloudflare Dashboard 连接 GitHub 仓库，配置好后 push 即部署

要点：从手动部署到 CI/CD，一个对话完成。Agent 告诉我在哪配置、连哪个仓库，我只需要确认。

第九步：R2 对象存储（遇到决策点）

我：加个 R2 存储

Agent：R2 需要绑定支付信息，这是身份验证，免费额度内不扣费

我：超出免费额度会怎样？能自动拒绝吗？

Agent：不能自动拒绝，超出按量计费，月结。但免费额度很大（10GB + 100万 Class A 操作/月 + 1000万 Class B 操作/月），个人项目很难用超

我：国内卡能用吗？

Agent：支持银联，信用卡成功率更高

要点：这是 Agent 辅助入门最典型的场景——遇到需要决策的节点，Agent 帮你分析利弊，你做决定。不是所有步骤都能自动化，但 Agent 能让你在充分了解情况后快速拍板。

第十步：给项目加个前端（Workers Static Assets）

我：后端 API 有了，想加个前端页面

Agent：不用单独建项目，你现在的 Workers 项目就能托管前端——建个 public/ 目录放静态文件，配上 assets 绑定，前端和 API 一起部署

操作步骤：

1. 1. 建前端目录：项目根目录建 public/，放一个 index.html（用 fetch 调你的 API：/hello、/time、/counter 等）
2. 2. 配置 assets 绑定：wrangler.jsonc 里加上：

{  "main": "src/index.ts",  "assets": {    "binding": "ASSETS",    "directory": "./public"  }}

1. 3. 部署：npm run deploy（也就是 wrangler deploy）——前端文件和 API 一次部署完成

部署后，前端和 API 在同一个域名下：访问根路径 / 返回 public/index.html，访问 /hello、/counter 等走 API 逻辑。

要点：这是 2026 年 Cloudflare 的推荐做法——Workers 是统一部署单元，一个项目同时托管前端静态资源和后端 API。Pages 仍然存在（适合已有的纯静态仓库），但官方已经在 Pages 文档挂上了”迁移到 Workers”的引导。新项目直接用 Workers + Static Assets 更省事：一个项目、一次部署、一个域名，连前后端跨域（CORS）的问题都不存在了。

第十一步：绑定自定义域名

我：给 Worker 绑个自己的域名

Agent：先在 Cloudflare 添加你的域名，然后去域名注册商改 NS 记录指向 Cloudflare，最后在 Worker 的 Domains 页面添加 Custom Domain

操作步骤：

1. 1. 添加域名到 Cloudflare：Dashboard 首页 → Add a site → 输入你的域名 → 选 Free 计划
2. 2. 修改 NS 记录：去域名注册商，把 NS 改成 Cloudflare 分配的两个 NS 地址
3. 3. 点击 Check nameservers now：在 Cloudflare 域名概览页点击检查，NS 传播通常需要几分钟到几小时
4. 4. 给 Worker 添加 Custom Domain：进入 Worker → Settings → Domains & Routes → Add → Custom Domain → 输入完整子域名（如 api.yourdomain.com）→ 点击 Add domain

完成后，Worker 同时拥有两个访问地址：

• • xxx.yourname.workers.dev（workers.dev 默认地址）
• • api.yourdomain.com（自定义域名）

要点：域名绑定涉及三个平台（Cloudflare、域名注册商、Worker 配置），步骤容易搞混。Agent 把完整流程串起来，告诉你每一步在哪做、做什么，不会漏。Cloudflare 会自动创建 DNS 记录和签发 SSL 证书，不用手动配置。

整个过程的关键模式

回顾上面 11 步，能提炼出 Agent 辅助入门的三个核心模式：

模式一：Agent 引导，你操作

注册、创建资源、绑定服务——操作步骤明确，Agent 告诉你点哪里，你动手。

适合：流程性操作、表单填写、配置绑定

模式二：Agent 生成，你粘贴

写代码、写 SQL、写配置——Agent 直接生成，你复制粘贴。

适合：代码编写、配置文件、SQL 语句

模式三：Agent 分析，你决策

是否绑卡、选哪个方案、要不要继续——Agent 给信息和利弊，你拍板。

适合：涉及费用、安全、架构选择的场景

进阶：控制参与度，从引导到自动

上面三个模式默认都是”Agent 说，你做”。但 Agent 既然能控制浏览器，为什么不能让它直接动手？

实际上，你可以根据对流程的熟悉程度，动态调整自己的参与度：

举个例子，这次实战中如果用三档切换：

• • 注册账号 → 引导模式：第一次用 Cloudflare，想看清楚界面长什么样
• • 绑定 KV / D1 → 协作模式：操作套路已经熟，但变量名、Namespace 名这些细节想确认一下
• • 改子域名 → 自动模式：操作简单，不需要决策，让 Agent 直接改

怎么切换？直接告诉 Agent 就行：

“接下来的操作你直接做，不用一步步问我”

“这个我自己来，你告诉我点哪就行”

“重要操作先问我，其他的你自己搞定”

核心原则：人专注探索和决策，Agent 处理执行和细节。 你越熟悉，参与度越低；遇到新概念或决策点，随时拉高参与度。不是非此即彼，而是动态调节。

Agent 辅助入门的四个注意事项

1. Agent 会犯错，关键操作自己验证

我这次就遇到：Agent 一开始说 workers.dev 子域名不能改，实际能改。幸好我知道，纠正了它。

对策：对 Agent 的说法保持怀疑，尤其是”不能做””不支持”这类否定结论，自己验证一下。

2. 文档会过时，让 Agent 查最新版

npm create cloud@latest 已废弃，很多旧教程还在用。Agent 能搜最新信息，但也要看它是否真查了，而不是凭记忆回答。

对策：遇到版本相关问题，明确要求 Agent 查最新文档。

3. 浏览器控制是关键能力

这次能顺利完成，很大程度上靠浏览器控制——Agent 直接看到页面、点击按钮、填写表单。没这个能力，Agent 只能告诉你”去某个页面点某个按钮”，效率大打折扣。

主流方案有 Kimi WebBridge、Codex 内置 Chrome、Browser Use、Playwright MCP 等，各有优劣。这块水很深，一两句说不透——如果你感兴趣，评论区告诉我最想了解哪个方案，人多我单独写一篇详细对比。

对策：选任一支持浏览器控制的 Agent 方案即可，核心能力相同——让 Agent 从”嘴上说”升级到”手上做”。

4. 大步快走，别小步慢走

一开始我让 Agent 一步一步引导，后来发现太慢。改成”帮我加 KV 存储”这种大步骤，Agent 一次完成绑定 + 写代码 + 部署，效率翻倍。

对策：给 Agent 大目标，而不是小指令。信任它的拆解能力。

速查：Cloudflare Workers 免费资源一览

Workers vs Pages：2026 年 Cloudflare 的主推方向是 Workers——通过 Static Assets，一个 Workers 项目能同时托管前端静态文件和后端 API，前后端同源、一次部署。Pages 仍然支持（适合已有的纯静态/JAMstack 仓库），但官方已在 Pages 文档引导新项目迁移到 Workers。新项目直接用 Workers + Static Assets，不必再分前后端两个产品。

总结

传统入门是”读文档 → 跟做 → 踩坑 → 搜索 → 继续”，Agent 辅助入门是”说目标 → Agent 引导 → 你决策 → 快速跑通”。

核心转变一句话：你从执行者变成决策者。

下次遇到一个新平台，别急着啃文档。打开 Agent，告诉它你想做什么，让它带你走。你会发现，入门一个新平台，真的可以像聊天一样简单。

入门之后：从”被引导”到”被代理”

11 步走完，你对 Cloudflare 已经有了基本认知——它有什么资源、怎么绑定、代码怎么写、部署怎么走。这些理解不是白费的，它是你接下来委托 Agent 的底气。

为什么入门阶段要自己动手？因为你需要建立心智模型。知道 KV 是键值存储、D1 是关系型数据库、R2 要绑卡——这些概念一旦建立，你就能用自然语言精准下指令，而不是含糊地说”帮我搞个存储”。

有了这个基础，接下来的玩法完全不同：

• • CLI 优先：不再需要浏览器点来点去，wrangler 命令行能完成大部分操作——创建 KV、建 D1 数据库、部署 Worker，一条命令搞定。Agent 直接在终端执行，比浏览器操作快一个量级。
• • MCP / Skills 加持：Agent 集成了 Cloudflare 的 MCP 工具或自定义 Skill 后，可以直接调用 API 创建资源、管理配置，连命令行都不用拼。
• • 代码即配置：本地项目里 wrangler.toml（或 wrangler.jsonc）声明了所有绑定和配置，Agent 改配置文件 + wrangler deploy 一把梭，比 Dashboard 操作更可靠、可复现、可版本控制。

入门阶段是”Agent 引导，你操作”——你需要看清每一步在做什么。入门之后是”你定目标，Agent 执行”——你只需要说”给这个 Worker 加个 D1 绑定，建个 users 表”，Agent 自己搞定。

从被引导到被代理，前提是你知道这个平台能做什么。 入门的意义，就在于此。

本文基于 2026 年 7 月使用 Claude Code + Kimi WebBridge 入门 Cloudflare Workers 的真实经历撰写。