rú hé 如何 yòng 用 c l a u d e claude code code bǎ 把 c l a u d e claude code code biàn chéng 变成 gè rén 个人 zhù shǒu 助手
i n f j infj guǎng zhōu 广州 shēn zhèn 深圳 gè rén 个人 wǎng zhàn 网站 ： y r z h e yrzhe . t o p top
i n f j infj guǎng zhōu 广州 shēn zhèn 深圳 gè rén 个人 wǎng zhàn 网站 ： y r z h e yrzhe . t o p top
i n f j infj guǎng zhōu 广州 shēn zhèn 深圳 gè rén 个人 wǎng zhàn 网站 ： y r z h e yrzhe . t o p top
i n f j infj guǎng zhōu 广州 shēn zhèn 深圳 gè rén 个人 wǎng zhàn 网站 ： y r z h e yrzhe . t o p top
M a t r i x Matrix shǒu yè 首页 tuī jiàn 推荐
M a t r i x Matrix shì 是 shǎo shù pài 少数派 de 的 xiě zuò 写作 shè qū 社区 ， wǒ men 我们 zhǔ zhāng 主张 fēn xiǎng 分享 zhēn shí 真实 de 的 chǎn pǐn 产品 tǐ yàn 体验 ， yǒu 有 shí yòng jià zhí 实用价值 de 的 jīng yàn 经验 yǔ 与 sī kǎo 思考 。 wǒ men 我们 huì 会 bù dìng qī 不定期 tiāo xuǎn 挑选 M a t r i x Matrix zuì 最 yōu zhì 优质 de 的 wén zhāng 文章 ， zhǎn shì 展示 lái zì 来自 yòng hù 用户 de 的 zuì 最 zhēn shí 真实 de 的 tǐ yàn 体验 hé 和 guān diǎn 观点 。 wén zhāng 文章 dài biǎo 代表 zuò zhě 作者 gè rén guān diǎn 个人观点 ， shǎo shù pài 少数派 jǐn 仅 duì 对 biāo tí 标题 hé 和 pái bǎn 排版 lüè zuò 略作 xiū gǎi 修改 。
wǒ 我 bú shì 不是 chéng xù yuán 程序员 ， biān chéng 编程 néng lì 能力 yě 也 yī bān 一般 ， dàn shì 但是 qián liǎng tiān 前两天 wǒ huā 我花 le 了 yí gè 一个 xià wǔ 下午 yòng 用 Claude Claude code code hé 和 Claude Claude agent agent sdk sdk ， zài 在 zì jǐ 自己 de 的 fú wù qì 服务器 shàng 上 gòu jiàn 构建 le 了 yí gè 一个 wán zhěng 完整 de 的 gè rén 个人 AI AI agent agent xiǎo 小 zhù shǒu 助手 ， suī rán 虽然 hái 还 bǐ jiào 比较 cū cāo 粗糙 ， dàn shì 但是 wǒ 我 xiàn zài 现在 kě yǐ 可以 24 24 / 7 7 tōng guò 通过 tā 它 fēn xī 分析 shù jù 数据 、 chǔ lǐ 处理 wén jiàn 文件 、 gòu jiàn 构建 jiè miàn 界面 。
quán chéng 全程 wǒ 我 méi yǒu 没有 xiě 写 yì háng 一行 dài mǎ 代码 ， zhǐ shì 只是 zài 在 gòu sī 构思 hé 和 jiāo liú 交流 。 zài 在 hé 和 Claude Claude code code jiāo liú 交流 ， bìng qiě 并且 mù qián 目前 hái 还 yì zhí 一直 zài 在 dié dài 迭代 ， yǐ hòu 以后 yě 也 yí dìng 一定 shì 是 zhè yàng 这样 de 的 fāng shì 方式 ， wǒ 我 xiǎng 想 zhè 这 jiù shì 就是 vibe vibe coding coding de 的 lè qù 乐趣 ， bú shì 不是 zhǎng wò 掌握 biān chéng yǔ yán 编程语言 huò 或 kuàng jià 框架 ， ér shì 而是 bǎ 把 AI AI dàng zuò 当作 nǐ 你 sī wéi 思维 de 的 yán shēn 延伸 — — yǐ 以 duì huà 对话 de 的 sù dù 速度 ， bǎ 把 mó hu 模糊 de 的 xiǎng fǎ 想法 biàn chéng 变成 zhēn shí 真实 kě yòng 可用 de 的 chǎn pǐn 产品 。
chǎn pǐn 产品 gǎn bǐ 感比 dài mǎ 代码 néng lì 能力 hěn 很 xī quē 稀缺
jīn nián 今年 ， wǒ 我 zì jǐ 自己 gòu jiàn 构建 le 了 jǐ shí gè 几十个 demo demo ， bú shì 不是 wèi le 为了 xuàn yào 炫耀 ， ér shì 而是 wǒ 我 fā xiàn 发现 ： demo demo shì 是 chuán dá 传达 xiǎng fǎ 想法 zuì 最 yǒu xiào 有效 de 的 méi jiè 媒介 。
yě 也 shì 是 dé yì yú 得益于 cǐ 此 ， wǒ 我 jìn rù 进入 dào 到 AI AI chū chuàng 初创 dāng 当 chǎn pǐn 产品 jīng lǐ 经理 ， hòu lái 后来 mentor mentor gēn 跟 wǒ 我 shuō 说 wǒ 我 de 的 jiǎn lì 简历 dōu 都 méi yǒu 没有 biǎo xiàn 表现 chū 出 wǒ 我 hé 和 gōng sī 公司 de 的 qì hé 契合 dù 度 ， ér shì 而是 wǒ 我 zài 在 github github lǐ miàn 里面 de 的 yī xiē 一些 xiàng mù 项目 ， ràng 让 tā 他 tè bié 特别 xiǎng yào 想要 wǒ 我 。
demo demo yǒu 有 jǐ céng 几层 jià zhí 价值 ， shǒu xiān 首先 shì 是 bǎ 把 nǐ 你 de 的 sī xiǎng 思想 wài huà 外化 ， bǎ 把 mó hu 模糊 de 的 xiǎng fǎ 想法 biàn chéng 变成 jù tǐ 具体 de 的 ， zài 在 nǐ 你 shí jiàn 实践 de 的 guò chéng 过程 zhōng 中 ， nǐ 你 huì 会 fā xiàn 发现 nǐ 你 jiē xià lái 接下来 de 的 sī kǎo 思考 huì 会 gèng 更 qīng sōng 轻松 ， yīn wèi 因为 nǐ 你 de 的 sī kǎo 思考 shì 是 jī yú 基于 yí gè 一个 yǐ yǒu 已有 de 的 dōng xī 东西 qù 去 yán shēn 延伸 ， ér 而 bú shì 不是 yì zhí 一直 zài 在 tiān mǎ xíng kōng 天马行空 de 的 xiǎng xiàng 想象 。 jiù 就 xiàng 像 AI AI de 的 sī kǎo 思考 mó shì 模式 yī yàng 一样 ， kě shì huà 可视化 nǐ 你 de 的 sī kǎo 思考 guò chéng 过程 wǎng wǎng 往往 huì 会 gǎi biàn 改变 nǐ 你 de 的 jié lùn 结论 ， xiān qián 先前 de 的 t o k e n token huì 会 shōu liǎn 收敛 nǐ 你 hòu miàn 后面 t o k e n token de 的 shū chū 输出 ， bù zhì yú 不至于 zuì hòu 最后 xiǎng fǎ 想法 hěn 很 hǎo 好 ， shí jiàn 实践 qǐ lái 起来 jiù 就 …
dì èr gè 第二个 jiù shì 就是 wǒ 我 zài 在 qián wén 前文 tí dào 提到 de 的 ， ràng 让 bié rén 别人 xiāng xìn 相信 nǐ 你 kàn dào 看到 de 的 ， jiàn lì 建立 xìn rèn 信任 。 zài 在 xué xiào 学校 de 的 shí hòu 时候 ， hěn duō 很多 rén 人 duì 对 AI AI de 的 lǐ jiě 理解 hái 还 zhǐ shì 只是 tíng liú 停留 zài 在 jiǎn dān 简单 de 的 duì huà 对话 ， wǒ 我 xiě 写 le 了 hěn zhǎng 很长 de 的 rú hé 如何 yòng 用 AI AI gāo xiào 高效 fēn xī 分析 、 diào yán 调研 、 fǎng tán 访谈 de 的 gōng zuò 工作 liú 流 fāng àn 方案 ， xiǎng 想 hé 和 tóng xué 同学 yī qǐ 一起 zuò 做 yī xiē 一些 shì lái 事来 fù néng 赋能 yī xià 一下 xiàn yǒu 现有 de 的 gōng zuò 工作 — — méi 没 fǎn yīng 反应 。 rán hòu 然后 wǒ 我 zuò 做 le 了 yí gè 一个 demo demo ， yòng 用 c o z e coze hé 和 fēi shū 飞书 biǎo gé 表格 ， zhǐ huā 只花 le 了 jǐ gè 几个 xiǎo shí 小时 ， jiāng 将 wǒ men 我们 zhī qián 之前 de 的 lái fǎng zhě 来访者 fǎng tán 访谈 dào 到 fēn xī 分析 de 的 zhěng gè 整个 guò chéng 过程 liú chéng huà 流程化 。 cóng 从 lái fǎng zhě 来访者 yù yuē 预约 、 shí jiān 时间 ān pái 安排 、 dào fǎng 到访 qián 前 tōng zhī 通知 yǐ jí 以及 guò chéng 过程 zhōng 中 lù yīn 录音 zhuǎn xiě 转写 dào 到 fēn xī 分析 ， rán hòu 然后 tā men 他们 jiù 就 xìn 信 le 了 。
wèi shén me 为什么 ？ yīn wèi 因为 demo demo shì 是 xìn xī 信息 mì dù 密度 zuì gāo 最高 de 的 gé shì 格式 ： bào gào huì 报告会 ràng 让 rén 人 shuì zhe 睡着 、 S l i d e s Slides huì 会 ràng 让 rén 人 fēn xīn 分心 、 D e m o Demo ràng 让 rén 人 kàn dào 看到 zì jǐ 自己 yǎn jīng 眼睛 de 的 zhēn shí 真实 xìn xī 信息 …
dì sān céng 第三层 jiù shì 就是 AI AI yǐ jīng 已经 ràng 让 wǒ men 我们 （ zhì shǎo 至少 shì 是 wǒ 我 zhè yàng 这样 méi 没 jì shù 技术 bèi jǐng 背景 de 的 rén 人 ） lì yòng 利用 zuì dī 最低 de 的 chéng běn 成本 ， ràng 让 bié rén 别人 kàn dào 看到 nǐ 你 de 的 xiǎng fǎ 想法 dào 到 chǎn pǐn 产品 。 cóng 从 gài niàn 概念 dào 到 kě yòng 可用 chǎn pǐn 产品 ， demo demo de 的 chéng běn 成本 zuì dī 最低 ， yí gè 一个 xià wǔ 下午 + yí gè 一个 AI AI gōng jù 工具 = nǐ 你 kě yǐ 可以 zhǎn shì 展示 gěi 给 1 0 0 100 gè rén 个人 de 的 dōng xī 东西 ， zhè 这 jiù shì 就是 wèi shén me 为什么 wǒ 我 duì 对 demo demo zhe mí 着迷 。
vibe vibe coding coding de 的 liù dà 六大 hé xīn 核心 jì qiǎo 技巧
jì qiǎo 技巧 1 1 ： bù yào 不要 píng kōng 凭空 chuàng zào 创造 ， xué xí 学习 bié rén 别人 yǐ jīng 已经 zuò guò 做过 de 的
zhè 这 tīng 听 qǐ lái 起来 yǒu diǎn 有点 fǎn 反 zhí jué 直觉 shì 是 ba 吧 ， ér qiě 而且 hěn duō 很多 rén 人 kěn dìng 肯定 huì 会 shuō 说 nǐ 你 zhè 这 bù 不 jiù shì 就是 chāo 抄 ， dàn 但 zhè 这 shì 是 zuì kuài 最快 de 的 qián jìn 前进 fāng shì 方式 。
dāng 当 wǒ 我 yòng 用 Claude Claude code code gòu jiàn 构建 yí gè 一个 w e b web d a s h b o a r d dashboard de 的 shí hòu 时候 ， wǒ 我 méi yǒu 没有 ràng 让 tā 他 píng kōng 凭空 chuàng jiàn 创建 ， ér shì 而是 ：
zài 在 G i t H u b GitHub shàng 上 zhǎo 找 yí gè 一个 kāi yuán 开源 qián duān 前端 xiàng mù 项目
gào sù 告诉 AI AI ： 「 àn zhào 按照 zhè gè 这个 xiàng mù 项目 de 的 shè jì 设计 fēng gé 风格 ， gěi 给 wǒ 我 yí gè 一个 R e a c t React D a s h b o a r d Dashboard zǔ jiàn 组件 kù 库 」
AI AI lǐ jiě 理解 le 了 měi xué 美学 ， zhí jiē 直接 shēng chéng 生成 le 了 pǐ pèi 匹配 de 的 dài mǎ 代码
jiǎ rú 假如 wǒ 我 zhí jiē 直接 chuàng zào 创造 ne 呢 ？ tā huì 他会 gěi 给 wǒ 我 yí gè 一个 「 gěi 给 wǒ 我 yí gè 一个 piāo liàng 漂亮 de 的 d a s h b o a r d dashboard 」 ， dàn shì 但是 xū yào 需要 1 0 10 lún 轮 fǎn kuì 反馈 diào zhěng 调整 yán sè 颜色 、 jiān jù 间距 。 wǒ 我 hěn 很 qīng chǔ 清楚 ， zì jǐ 自己 bìng 并 bú shì 不是 yí gè 一个 shè jì shī 设计师 ， bìng qiě 并且 wǒ 我 zì jǐ 自己 nǎo zi lǐ 脑子里 de 的 xiǎng fǎ 想法 shèn zhì 甚至 dōu 都 bú shì 不是 hěn 很 qīng chǔ 清楚 ， yǔ qí 与其 qù 去 zuò 做 tián kōng tí 填空题 ， bù rú 不如 qù 去 zuò 做 xuǎn zé tí 选择题 。
zài 在 nǎ 哪 sōu suǒ 搜索 ？ G i t H u b GitHub shàng 上 de 的 kāi yuán 开源 xiàng mù 项目 （ bāo kuò 包括 yàng shì biǎo 样式表 ） 、 shè jì 设计 zhǎn shì 展示 wǎng zhàn 网站 （ D r i b b b l e Dribbble 、 B e h a n c e Behance ） 、 jìng pǐn 竞品 dài mǎ 代码 （ yòng 用 liú lǎn qì 浏览器 kāi fā zhě 开发者 gōng jù 工具 jiǎn chá 检查 ） … …
wǒ 我 zì jǐ 自己 wú liáo 无聊 de 的 shí hòu 时候 bǐ jiào 比较 xǐ huān 喜欢 kàn 看 m o b b i n mobbin ， qù 去 shuā 刷 yī shuā 一刷 wǎng zhàn 网站 huò zhě 或者 shàng 上 x x qù 去 kàn kàn 看看 dà jiā 大家 de 的 fēn xiǎng 分享 ， rán hòu 然后 yòng 用 m y m i n d mymind qù 去 jì lù 记录 yī xiē 一些 hǎo 好 de 的 chuàng yì 创意 ， bù jǐn jǐn 不仅仅 shì 是 jì lù 记录 ， yǒu shí hòu 有时候 guāng kàn 光看 zhè xiē 这些 jiù 就 tǐng 挺 kāi xīn 开心 de 的 。
qí shí 其实 bù jǐn jǐn 不仅仅 shì 是 yí gè 一个 shè jì 设计 ， bāo kuò 包括 shuō 说 yī xiē 一些 yǒu yòng 有用 de 的 ， kě néng 可能 wǒ 我 xiàn zài 现在 yòng bù shàng 用不上 ， dàn shì 但是 wǒ 我 jué dé 觉得 tā 它 fēi cháng 非常 yǒu yòng 有用 ， wǒ 我 jiù 就 huì 会 xiān 先 bǎ 把 tā 它 jì lù xià lái 记录下来 。 hòu miàn 后面 wǒ 我 xū yào 需要 de 的 shí hòu 时候 ， wǒ 我 jiù 就 zhí jiē 直接 cóng zhōng 从中 qù 去 zhǎo 找 。
yǒu 有 yí gè 一个 jì lù 记录 de 的 guò chéng 过程 ， jiù 就 huì 会 ràng 让 nǐ 你 de 的 jì yì 记忆 liú xià 留下 yí gè 一个 yìn xiàng 印象 。 nǐ 你 hòu xù 后续 zài 再 qù 去 zuò 做 yí gè 一个 shén me 什么 dōng xī 东西 de 的 shí hòu 时候 ， kě néng 可能 jiù 就 huì 会 xiǎng qǐ 想起 zhè gè 这个 dōng xī 东西 。 xiǎng qǐ 想起 zhè gè 这个 dōng xī 东西 ， nǐ 你 jiù 就 bù yòng 不用 zài 再 qù 去 dà hǎi lāo zhēn 大海捞针 dì qù 地去 zhǎo 找 ， nǐ 你 kě yǐ 可以 cóng 从 yǐ jīng 已经 shōu jí 收集 dào 到 de 的 dì fāng 地方 qù 去 jìn xíng 进行 yí gè 一个 xún zhǎo 寻找 。
zhè 这 bú shì 不是 「 pīn còu 拼凑 guài wù 怪物 」 — — zhè 这 shì 是 zuì 最 gāo xiào 高效 de 的 xué xí 学习 fāng shì 方式 。 zhù míng 著名 de 的 R o g u e l i k e Roguelike yóu xì 游戏 kāi fā 开发 fāng fǎ lùn 方法论 jiù shì 就是 zhè yàng 这样 ： zhàn 站 zài 在 jù rén 巨人 jiān bǎng 肩膀 shàng 上 ， kuài sù 快速 dié dài 迭代 。
jì qiǎo 技巧 2 2 ： bù duàn 不断 wèn 问 AI AI ， zhú bù 逐步 tàn suǒ 探索 — — měi gè 每个 cāo zuò qián 操作前 dōu 都 yào 要 wèn 问 wèi shén me 为什么
wǒ 我 zuì chū 最初 duì 对 V P S VPS yī wú suǒ zhī 一无所知 。 shén me 什么 shì 是 S S H SSH ？ duān kǒu 端口 zhuǎn fā 转发 zěn me 怎么 yòng 用 ？ D o c k e r Docker shì 是 shén me 什么 ？
dàn 但 wǒ 我 méi yǒu 没有 qù 去 mǎi 买 kè chéng 课程 ， ér shì 而是 zài 在 měi gè 每个 cāo zuò qián 操作前 dōu 都 wèn 问 AI AI ：
「 wǒ 我 zěn yàng 怎样 zài 在 shǒu jī 手机 shàng 上 yuǎn chéng 远程 kòng zhì 控制 Claude Claude C o d e Code ？ 」
「 zhè gè 这个 S S H SSH mì yào 密钥 shì 是 yòng lái 用来 gàn shén me 干什么 de 的 ？ 」
「 D o c k e r Docker duì 对 wǒ 我 de 的 xiàng mù 项目 yǒu 有 shén me 什么 hǎo chù 好处 ？ 」
AI AI huì 会 jiě shì 解释 gài niàn 概念 、 gěi 给 jù tǐ bù zhòu 具体步骤 、 yù dào 遇到 wèn tí 问题 shí 时 bāng zhù 帮助 diào shì 调试 ， suǒ yǐ 所以 wǒ 我 xiàn zài 现在 jiù 就 néng 能 zhí jiē 直接 cóng 从 shǒu jī 手机 p u s h push dài mǎ 代码 dào 到 G i t H u b GitHub ， yòng 用 Claude Claude C o d e Code zài 在 yuǎn chéng 远程 fú wù qì 服务器 shàng 上 gōng zuò 工作 。 wǒ 我 cóng wèi 从未 shàng 上 guò 过 yī táng 一堂 L i n u x Linux kè 课 ， dàn 但 wǒ 我 xué huì 学会 le 了 「 zuò shì 做事 」 。
zhè 这 yě 也 shì 是 wǒ 我 rèn wèi 认为 de 的 vibe vibe coding coding de 的 jīng suǐ 精髓 zhī yī 之一 ： bú shì 不是 「 xiān xué 先学 jì shù 技术 ， zài 再 shǐ yòng 使用 tā 它 」 ， ér shì 而是 「 ràng 让 wèn tí 问题 qū dòng 驱动 xué xí 学习 」 ， zhè yàng 这样 měi gè 每个 tí wèn 提问 dōu 都 shì 是 yí gè 一个 jiào xué 教学 shí kè 时刻 ， yě 也 suàn shì 算是 gàn 干 zhōng xué 中学 ba 吧 。
jì qiǎo 技巧 3 3 ： jiàn jìn shì 渐进式 kāi fā 开发 — — lǐ qīng 理清 shùn xù 顺序 hé 和 yī lài 依赖 guān xì 关系
gòu jiàn 构建 AI AI B o t Bot shí 时 ， wǒ 我 zuì chū 最初 de 的 jì huà 计划 shì 是 ： xiān 先 zuò 做 xiāo xī 消息 chù lǐ qì 处理器 、 zài 再 zuò 做 yòng hù 用户 guǎn lǐ 管理 、 zài 再 zuò 做 huì 会 huà 话 guǎn lǐ 管理 、 zài 再 zuò 做 A g e n t Agent jí chéng 集成 、 zuì hòu 最后 ān quán 安全 fāng miàn 方面 …
dàn shì 但是 dào 到 le 了 dì sān bù 第三步 de 的 shí hòu 时候 ， wǒ 我 fā xiàn 发现 ān quán 安全 xū yào 需要 tí qián 提前 shè jì 设计 ， bǐ rú shuō 比如说 yī xiē 一些 quán xiàn 权限 gé lí 隔离 。 rán hòu 然后 xiàng 像 xiāo xī 消息 chù lǐ qì 处理器 ， tā 它 jiù 就 yī lài 依赖 hòu huà 后话 guǎn lǐ 管理 de 的 jiē kǒu dìng yì 接口定义 ， nà 那 yòng hù 用户 guǎn lǐ 管理 yòu 又 xū yào 需要 qù 去 yù liú 预留 pèi é 配额 de 的 kōng jiān 空间 ， suǒ yǐ 所以 wǒ 我 jiù 就 gēn 跟 AI AI yī qǐ 一起 qù 去 zhòng xīn 重新 pái xù 排序 。
wǒ 我 shǒu xiān 首先 jiù shì 就是 qù 去 dìng yì 定义 zhè gè 这个 shù jù mó xíng 数据模型 ， bǐ rú shuō 比如说 u s e r user 、 s e s s i o n session 、 t a s k task jié gòu 结构 。 rán hòu 然后 dì èr bù 第二步 jiù 就 qù 去 shí xiàn 实现 zhè gè 这个 hé xīn 核心 de 的 luó jí 逻辑 ， xiàng 像 agent agent hé 和 m c p mcp s e r v e r server 。 rán hòu 然后 dì sān bù 第三步 jiù shì 就是 tiān jiā 添加 yuē shù 约束 céng 层 ， jiù shì 就是 měi gè 每个 yòng hù 用户 tā 它 yǒu 有 duō shǎo 多少 de 的 cún chǔ kōng jiān 存储空间 。
yīn wèi 因为 wǒ 我 zhè gè 这个 xiàng mù 项目 bù jǐn 不仅 gěi 给 wǒ 我 zì jǐ 自己 yòng 用 ， tā huì 它会 gěi 给 wǒ 我 jiā lǐ rén 家里人 yī qǐ 一起 yòng 用 ， bāng 帮 tā men 他们 bǎ 把 yī xiē 一些 shēng huó 生活 shàng 上 de 的 yī xiē 一些 xū yào 需要 yòng dào 用到 AI AI de 的 dōng xī 东西 quán bù 全部 dǎ bāo 打包 fàng zài 放在 zhè gè 这个 b o t bot lǐ miàn 里面 。 suǒ yǐ 所以 wǒ huì 我会 gěi 给 měi gè 每个 rén 人 dōu 都 huì pèi 会配 yí dìng 一定 de 的 pèi é 配额 ， bì jìng 毕竟 V P S VPS tā 它 de 的 cún chǔ 存储 shì 是 yǒu xiàn 有限 de 的 。
rán hòu 然后 quán xiàn 权限 hé 和 ān quán 安全 fāng miàn 方面 ， yīn wèi 因为 wǒ 我 gěi 给 tā men 他们 zhí jiē 直接 yòng 用 de 的 shì 是 Claude Claude agent agent ， rú guǒ 如果 bù yǒu 不有 yī xiē 一些 quán xiàn 权限 de 的 xiàn zhì 限制 de huà 的话 ， nà yǒu 那有 kě néng 可能 tā men 他们 de 的 tí shì 提示 bù 不 xiǎo xīn 小心 chù fā 触发 le 了 Claude Claude agent agent de 的 yī xiē 一些 cāo zuò 操作 ， jiù 就 huì 会 bǎ 把 wǒ 我 zhěng gè 整个 xiàng mù 项目 gěi 给 sǔn huǐ 损毁 。 suǒ yǐ 所以 wǒ 我 jiù 就 tiān jiā 添加 le 了 yī xiē 一些 ān quán 安全 de 的 yī xiē 一些 quán xiàn 权限 。
zuì hòu 最后 jiù shì 就是 jí chéng 集成 jiāo fù 交付 céng 层 ， jiù 就 bǐ rú 比如 hé 和 liáo tiān 聊天 ruǎn jiàn 软件 qù 去 jí chéng 集成 。
zhè gè 这个 shùn xù 顺序 de 的 hǎo chù 好处 jiù shì 就是 wǒ 我 hòu miàn 后面 de 的 mó kuài 模块 ， jiù 就 bù yòng 不用 hòu miàn 后面 mó kuài 模块 de 的 tiān jiā 添加 jiù 就 bù yòng 不用 qù 去 gǎi biàn 改变 qián miàn 前面 mó kuài 模块 de 的 yí gè 一个 jiē kǒu 接口 。 suǒ yǐ 所以 wǒ jiā 我加 xīn 新 gōng néng 功能 de 的 shí hòu 时候 ， AI AI de 的 shàng xià wén 上下文 jiù 就 huì 会 gèng jiā 更加 qīng xī 清晰 。 ér qiě 而且 wǒ 我 yī dàn 一旦 chū xiàn 出现 le 了 b u g bug ， wǒ 我 jiù 就 zhī dào 知道 wǒ 我 jù tǐ 具体 shì 是 nǎ 哪 yí gè 一个 céng miàn 层面 chū xiàn 出现 de 的 wèn tí 问题 ， wǒ 我 jiù 就 zhí jiē 直接 qù 去 zhēn duì xìng 针对性 dì 地 xiū gǎi 修改 zhè 这 yí gè 一个 céng miàn 层面 jiù 就 hǎo 好 le 了 。
zhè 这 qí shí 其实 jiù shì 就是 yí gè 一个 jī chǔ 基础 de 的 xì tǒng 系统 shè jì 设计 ， wǒ 我 gè rén 个人 rèn wèi 认为 suī rán 虽然 wǒ 我 bù 不 dǒng 懂 dài mǎ 代码 zěn me 怎么 qù 去 shí xiàn 实现 ， dàn shì 但是 hěn duō 很多 jià gòu 架构 fāng miàn 方面 de 的 dōng xī 东西 nǐ 你 yào 要 xiǎng 想 qīng chǔ 清楚 。
jiù 就 xiàng 像 wǒ men 我们 qù 去 zuò 做 shì qíng 事情 yī yàng 一样 ， zhěng gè 整个 yí gè 一个 xiān hòu shùn xù 先后顺序 ， nǐ 你 qù 去 qū shǐ 驱使 AI AI qù 去 zuò 做 shì qíng 事情 yě 也 shì 是 yǒu 有 yí gè 一个 xiān hòu shùn xù 先后顺序 ， suǒ yǐ 所以 AI AI néng gòu 能够 bāng 帮 nǐ 你 qù 去 shí xiàn 实现 tā 它 ， dàn shì 但是 nǐ 你 zì jǐ 自己 bì xū 必须 yào 要 sī kǎo 思考 qīng chǔ 清楚 。
jì qiǎo 技巧 4 4 ： yí gè 一个 wén jiàn 文件 ， yí gè 一个 gōng zuò 工作 — — xiě 写 mó kuài huà 模块化 dài mǎ 代码
rú guǒ 如果 yí gè 一个 wén jiàn 文件 yǒu 有 2 0 0 0 2000 xíng 行 ， AI AI chū cuò 出错 de 的 gài lǜ 概率 chéng bèi zēng jiā 成倍增加 。 rú guǒ 如果 yí gè 一个 wén jiàn 文件 1 0 0 100 xíng 行 ， zhǐ 只 zuò 做 yī jiàn 一件 shì 事 ：
├ ─ ─ h a n d l e r s handlers . p y py # jǐn 仅 chǔ lǐ 处理 lái zì 来自 liáo tiān 聊天 ruǎn jiàn 软件 de 的 mìng lìng 命令
│ ├ ─ ─ c l i e n t client . p y py # jǐn 仅 lián jiē 连接 Claude Claude A g e n t Agent
│ ├ ─ ─ t o o l s tools . p y py # jǐn 仅 dìng yì 定义 zì dìng yì 自定义 gōng jù 工具
│ ├ ─ ─ t a s k task _ m a n a g e r manager . p y py # jǐn 仅 guǎn lǐ 管理 hòu tái rèn wù 后台任务
│ ├ ─ ─ m a n a g e r manager . p y py # jǐn 仅 guǎn lǐ 管理 yòng hù 用户 shù jù 数据
│ ├ ─ ─ s t o r a g e storage . p y py # jǐn 仅 chǔ lǐ 处理 pèi é 配额
│ └ ─ ─ m a n a g e r manager . p y py # jǐn 仅 guǎn lǐ 管理 huì huà 会话
L L M LLM zài 在 xiǎo 小 de 的 、 jù jiāo 聚焦 de 的 rèn wù 任务 shàng 上 biǎo xiàn 表现 kěn dìng 肯定 shì 是 gèng hǎo 更好 ， dāng 当 nǐ 你 yào qiú 要求 tā 它 「 xiě 写 wán zhěng 完整 xì tǒng 系统 」 shí 时 ， jiù 就 xiàng 像 1 0 10 gè 个 kāi fā zhě 开发者 tóng shí 同时 biān mǎ 编码 dàn 但 bù 不 gōu tōng 沟通 、 fēi cháng 非常 hùn luàn 混乱 。
suǒ yǐ 所以 wǒ 我 yī bān 一般 jiù shì 就是 yí gè 一个 wén jiàn 文件 shí xiàn 实现 yí gè 一个 mù biāo 目标 ， rán hòu 然后 bù tóng 不同 de 的 gōng néng 功能 jiù 就 fàng 放 bù tóng 不同 de 的 wén jiàn jiā 文件夹 lǐ miàn 里面 。
dāng 当 wǒ 我 xiǎng yào 想要 qù 去 gǎi 改 mǒu gè 某个 gōng néng 功能 de 的 shí hòu 时候 ， wǒ 我 jiù 就 gào sù 告诉 tā 他 zài 在 nǎ gè 哪个 wén jiàn 文件 lǐ miàn 里面 qù 去 tiān jiā 添加 yí gè 一个 shén me yàng 什么样 de 的 hán shù 函数 ， huò zhě shuō 或者说 tā 他 zì jǐ 自己 jiù 就 néng gòu 能够 gēn jù 根据 wén jiàn 文件 jié gòu 结构 zì jǐ 自己 qù 去 fēi cháng 非常 què dìng 确定 dì 地 zhī dào 知道 zài 在 nǎ lǐ 哪里 ， ér 而 bú shì 不是 shuō 说 yī lèi 一类 gōng néng 功能 nǐ 你 bǎ 把 tā 它 chāi dào 拆到 le 了 bù tóng 不同 de 的 wén jiàn 文件 lǐ miàn 里面 qù 去 fàng 放 。 nà 那 zhè 这 yàng zi 样子 jiù 就 huì 会 fēi cháng 非常 hùn luàn 混乱 ， tā 他 jiù 就 hěn 很 róng yì 容易 gǎo cuò 搞错 。
jì qiǎo 技巧 5 5 ： jià gòu 架构 sī kǎo 思考 （ 5 5 fēn zhōng 分钟 tóu nǎo 头脑 fēng bào 风暴 ）
zài 在 měi cì 每次 kāi shǐ 开始 xiě 写 dài mǎ 代码 ， wǒ huì 我会 xiān 先 bǎ 把 wǒ 我 de 的 xiǎng fǎ 想法 gěi 给 AI AI ， xiān qù 先去 shuō 说 wǒ huì 我会 xiān 先 gēn 跟 tā 他 shuō 说 ， wǒ men 我们 xiān 先 tǎo lùn yī xià 讨论一下 ， nǐ 你 kě yǐ 可以 xiān bù jí 先不急 zhe 着 qù 去 wǎng hòu 往后 shí xiàn 实现 chū lái 出来 ， rán hòu 然后 kàn 看 yǒu 有 shén me yàng 什么样 de 的 yí gè 一个 fāng shì 方式 ， néng 能 bù néng 不能 shí xiàn 实现 。
shǒu xiān 首先 wǒ 我 xiān yào 先要 wèn 问 tā 他 néng 能 bù néng 不能 shí xiàn 实现 ， yào 要 shí xiàn 实现 de 的 fāng àn 方案 yǒu 有 shén me 什么 yàng zi 样子 de 的 ， rán hòu 然后 tā huì 他会 gěi 给 wǒ 我 yī xiē 一些 jià gòu 架构 de 的 jiàn yì 建议 ， yǐ jí 以及 yī xiē 一些 qián zài 潜在 de 的 wèn tí 问题 ， hái yǒu 还有 yī xiē 一些 nà zhǒng 那种 fāng àn 方案 de 的 xuǎn zé 选择 ， jiù ràng 就让 wǒ néng 我能 gèng 更 yǒu 有 zhǎng kòng 掌控 gǎn 感 。
zhè yàng 这样 wǒ 我 yě 也 néng gòu 能够 què dìng 确定 wǒ 我 de 的 xiǎng fǎ 想法 bù huì 不会 tè bié 特别 lí pǔ 离谱 ， huò zhě shuō 或者说 tā 他 xū yào 需要 、 tā 他 wú fǎ 无法 shí xiàn 实现 shén me 什么 dōng xī 东西 ， rán hòu 然后 tā 他 yòu 又 xū yào 需要 shén me 什么 ， bǐ rú shuō 比如说 yī xiē 一些 A P I API k e y key a 啊 ， huò zhě shuō 或者说 yī xiē 一些 wài bù 外部 fú wù 服务 de 的 shí hòu 时候 ， tā 他 néng gòu 能够 qù 去 zhǐ dǎo 指导 wǒ 我 ， qù 去 bāng 帮 tā 他 qù 去 huò qǔ 获取 。
wǒ 我 gǎn jué 感觉 hǎo 好 de 的 jià gòu 架构 tā 它 néng gòu 能够 yù fáng 预防 nǐ 你 8 0 % 80% de 的 hòu xù 后续 wèn tí 问题 ， bìng qiě 并且 「 xiān gǎi 先改 jià gòu 架构 」 shì 是 bǐ 比 nǐ 你 「 kāi shǐ 开始 jià gòu 架构 hǎo 好 le 了 hòu miàn 后面 qù 去 gǎi 改 dài mǎ 代码 」 zhè yàng 这样 shì 是 gèng 更 róng yì 容易 yī xiē 一些 。
bìng qiě 并且 duì yú 对于 wǒ 我 zhè yàng 这样 méi yǒu 没有 shén me 什么 kāi fā 开发 jīng yàn 经验 yě 也 méi yǒu 没有 xì tǒng 系统 xué xí 学习 guò 过 de 的 rén 人 ， wǒ 我 jué dé 觉得 AI AI de 的 jiàn yì 建议 wǎng wǎng 往往 shì 是 huì 会 chāo guò 超过 wǒ 我 de 的 zhī shí 知识 。 suǒ yǐ 所以 nǐ 你 zài 在 gàn shén me 干什么 shì qíng 事情 zhī qián 之前 dōu 都 qù 去 wèn 问 qīng chǔ 清楚 ， gēn 跟 tā 他 tǎo lùn 讨论 qīng chǔ 清楚 。 rú guǒ 如果 nǐ 你 zì jǐ 自己 bù 不 fàng xīn 放心 ， měi gè 每个 rén 人 zài 再 qù 去 zuò 做 yī xiē 一些 shì shí 事实 hé chá 核查 ， yòng 用 qí tā 其他 de 的 AI AI zuò 做 hé chá 核查 yě 也 shì 是 yī yàng 一样 de 的 。
jì qiǎo 技巧 6 6 ： lì yòng 利用 Claude Claude C o d e Code hé 和 A g e n t Agent S D K SDK
zhè 这 zhēn de 真的 shì 是 vibe vibe C o d i n g Coding de 的 zuì gāo 最高 gāng gān 杠杆 gōng jù 工具 。 wǒ 我 zhēn 真 gǎn jué 感觉 zhè gè 这个 hǎo 好 dōng xī 东西 jiù shì 就是 bèi 被 code code zhè gè 这个 zì yǎn 字眼 gěi 给 dān wù 耽误 le 了 ， Claude Claude code code hé bì 何必 zhǐ néng 只能 xiě 写 dài mǎ 代码 …
2 0 2 5 2025 nián 年 9 9 yuè 月 ， dāng 当 A n t h r o p i c Anthropic xuān bù 宣布 jiāng 将 Claude Claude C o d e Code S D K SDK zhèng shì 正式 gèng míng 更名 wèi 为 Claude Claude A g e n t Agent S D K SDK shí 时 ， zhè 这 bù jǐn 不仅 shì 是 yī cì 一次 mìng míng 命名 biàn huà 变化 ， gèng jiā 更加 biǎo dá 表达 le 了 tā 他 bù jǐn jǐn 不仅仅 shì 是 xiě 写 code code yě 也 néng gòu 能够 shèng rèn 胜任 tōng yòng 通用 rèn wù 任务 。
guān fāng 官方 gōng chéng 工程 bó kè 博客 míng què 明确 biǎo shì 表示 ： 「 T h e The k e y key d e s i g n design p r i n c i p l e principle b e h i n d behind t h e the Claude Claude A g e n t Agent S D K SDK i s is t o to g i v e give y o u r your a g e n t s agents a a c o m p u t e r computer , a l l o w i n g allowing t h e m them t o to w o r k work l i k e like h u m a n s humans d o do . 」
Claude Claude A g e n t Agent S D K SDK de 的 hé xīn 核心 yōu shì 优势 ：
M C P MCP S e r v e r Server ： ràng 让 AI AI shǐ yòng 使用 zì dìng yì 自定义 gōng jù 工具
shàng xià wén 上下文 guǎn lǐ 管理 ： zì dòng 自动 guǎn lǐ 管理 shàng xià wén 上下文 hé 和 huì 会 huà 话
gōng jù 工具 diào yòng 调用 ： AI AI kě yǐ 可以 zhǔ dòng 主动 diào yòng 调用 nǐ 你 de 的 hán shù 函数
bǐ rú 比如 nǐ 你 jiù 就 qù 去 gēn 跟 Claude Claude C o d e Code shuō 说 ， shǐ yòng 使用 Claude Claude A g e n t Agent S D K SDK gòu jiàn 构建 yí gè 一个 huā fèi 花费 fēn xī qì 分析器 ， yòng hù 用户 shàng chuán 上传 shōu jù 收据 tú piàn 图片 ， A g e n t Agent tí gōng 提供 tǒng jì 统计 、 fēn lèi 分类 、 zhī chū 支出 。 nà 那 tā 他 jiù 就 néng gòu 能够 zhí jiē 直接 qù 去 yòng 用 zhè gè 这个 S D K SDK qù 去 xiě 写 yí gè 一个 zhěng tǐ 整体 de 的 kuàng jià 框架 ， qù 去 chǔ lǐ 处理 nǐ 你 de 的 wén jiàn 文件 shàng chuán 上传 ， guǎn lǐ 管理 duì huà 对话 zhuàng tài 状态 ， diào yòng 调用 nǐ 你 de 的 zì dìng yì 自定义 gōng jī 攻击 。
bìng qiě 并且 Claude Claude C o d e Code zài 在 tā 他 de 的 p l u g i n plugin M a r k e t p l a c e Marketplace lǐ miàn 里面 jiù 就 yǒu 有 néng 能 bāng 帮 nǐ 你 qù 去 xiě 写 jī yú 基于 Claude Claude agent agent sdk sdk chéng xù 程序 de 的 chā jiàn 插件 ， yě jiù shì shuō 也就是说 tā 他 zì jǐ 自己 jiù 就 néng gòu 能够 qù 去 chá kàn 查看 zhè gè 这个 S D K SDK qù 去 bāng 帮 nǐ 你 xiě 写 ， bù 不 xū yào 需要 nǐ 你 zì jǐ 自己 qù chá 去查 yī xiē 一些 shǐ yòng 使用 wén dàng 文档 ， qù 去 gào sù 告诉 tā 他 gāi 该 zěn me 怎么 xiě 写 。
suǒ yǐ 所以 tā 他 duì 对 yòng 用 tā 他 lái 来 xiě 写 Claude Claude A g e n t Agent S D K SDK xiāng guān 相关 de 的 yī xiē 一些 ruǎn jiàn 软件 huò zhě 或者 gōng néng 功能 shì 是 fēi cháng 非常 yǒu hǎo 友好 de 的 ， fēi cháng 非常 shùn huá 顺滑 de 的 。 rú 如
guǒ 果 nǐ 你 yòng 用 chuán tǒng 传统 de 的 fāng shì 方式 ， nǐ 你 qù 去 bǎ 把 yī xiē 一些 wén dàng 文档 、 shǐ yòng 使用 wén dàng 文档 qù 去 fù zhì zhān tiē 复制粘贴 gěi 给 tā 他 ， huò zhě shuō 或者说 gào sù 告诉 tā 他 zěn me 怎么 qù 去 zuò 做 ， tā 他 jiù 就 hěn 很 róng yì 容易 huì 会 yù dào 遇到 yī xiē 一些 cuò wù 错误 qíng kuàng 情况 。 yīn wèi 因为 tā 他 zì jǐ 自己 běn shēn 本身 jiù 就 bù 不 le jiě 了解 ， rán hòu 然后 tā 他 zài 在 qù 去 diào yòng 调用 yī xiē 一些 fú wù 服务 de 的 shí hòu 时候 ， tā 他 jiù 就 hěn 很 róng yì 容易 bǎ 把 jiē kǒu 接口 xiě cuò 写错 ， jiù 就 huì 会 chū 出 wèn tí 问题 。
cóng 从 xiǎng fǎ 想法 dào 到 chǎn pǐn 产品 de 的 wán zhěng 完整 gōng zuò 工作 liú 流
bù zhòu 步骤 1 1 ： wèn tí 问题 dìng yì 定义 ， bú shì 不是 jiě jué fāng àn 解决方案
wǒ 我 rèn wèi 认为 cuò wù 错误 de 的 fāng shì 方式 shì 是 nǐ 你 jiào 教 tā 他 yòng 用 P y t h o n Python xiě 写 yí gè 一个 xiàng mù 项目 ， yòng 用 F l a s k Flask A P I API jí chéng 集成 Claude Claude A P I API děng děng 等等 。 wǒ 我 jué dé 觉得 zhèng què 正确 de 的 fāng shì 方式 ： wǒ 我 xiǎng 想 zài 在 zì jǐ 自己 de 的 fú wù qì 服务器 shàng 上 yǒu 有 yí gè 一个 dōng xī 东西 ， rán hòu 然后 néng gòu 能够 suí shí 随时 tōng guò 通过 zhǐ lìng 指令 ， chū 出 le 了 wèn tí 问题 ràng 让 tā 他 chǔ lǐ 处理 wén jiàn 文件 。
zhè 这 liǎng gè 两个 yǒu 有 shén me 什么 qū bié 区别 ne 呢 ？
shǒu xiān 首先 ， wèi shén me 为什么 wǒ huì 我会 shǐ yòng 使用 dì èr gè 第二个 fāng shì 方式 ？ yě 也 shì yīn wèi 是因为 wǒ 我 duì yú 对于 jì shù 技术 de 的 le jiě 了解 bú shì 不是 nà me 那么 duō 多 ， suǒ yǐ 所以 wǒ 我 yě 也 bù huì 不会 qù 去 wèn 问 tā 他 xiàng 像 dì yī gè 第一个 wèn tí 问题 nà 那 yàng zi 样子 nà me 那么 jù tǐ 具体 ， ràng 让 tā 他 qù 去 yòng 用 shén me 什么 jì shù 技术 de 的 yí gè 一个 wèn tí 问题 。
rán hòu 然后 dì èr gè 第二个 jiù shì 就是 ， wǒ 我 jué dé 觉得 dì yī zhǒng 第一种 fāng shì 方式 xiàn zhì 限制 le 了 AI AI de 的 sī kǎo 思考 ， yīn wèi 因为 nǐ 你 zěn me 怎么 néng gòu 能够 què dìng 确定 nǐ 你 yòng 用 P y t h o n Python fāng xiàng 方向 jiù 就 yí dìng 一定 shì 是 yòng 用 P y t h o n Python zhè gè 这个 yǔ yán 语言 qù 去 xiě 写 ， yí dìng 一定 jiù shì 就是 duì 对 nǐ 你 zhè gè 这个 chéng xù 程序 shì 是 zuì 最 yǒu hǎo 友好 de 的 ne 呢 ？ rán hòu 然后 shuō 说 F l a s k Flask A P I API nán dào 难道 jiù 就 yí dìng 一定 shì 是 zuì yōu 最优 de 的 ma 吗 ？
suǒ yǐ 所以 wǒ 我 dì èr zhǒng 第二种 jiù shì 就是 zhí jiē 直接 ràng 让 AI AI zì jǐ 自己 qù 去 pàn duàn 判断 、 qù 去 xuǎn zé 选择 zuì jiā 最佳 de 的 kuàng jià 框架 。 nà 那 wǒ men 我们 zhǐ yòng 只用 qù 去 dìng yì 定义 w h a t what hé 和 w h y why ， nà 那 AI AI tā 他 zì jǐ 自己 qù 去 tuī jiàn 推荐 h o w how 。
bù zhòu 步骤 2 2 ： jià gòu 架构 sī kǎo 思考 — — 5 5 fēn zhōng 分钟 tóu nǎo 头脑 fēng bào 风暴 bǐ 比 5 5 xiǎo shí 小时 fǎn gōng 返工 gèng zhí 更值
zài 在 kāi shǐ 开始 xiě 写 dài mǎ 代码 zhī qián 之前 ， wǒ huì 我会 xiān 先 hé 和 AI AI jìn xíng 进行 yī cì 一次 jià gòu 架构 duì huà 对话 。 zhè gè 这个 bù zhòu 步骤 hěn duō 很多 rén huì 人会 tiào 跳 guò 过 ， yīn wèi 因为 tā men 他们 jué dé 觉得 「 fǎn zhèng 反正 AI AI huì 会 bāng 帮 wǒ 我 xiě 写 」 ， dàn 但 zhè 这 qià qià 恰恰 shì 是 zuì 最 róng yì 容易 cǎi 踩 kēng 坑 de 的 dì fāng 地方 。
wǒ huì 我会 zhè yàng 这样 hé 和 AI AI duì huà 对话 ： 「 wǒ 我 xiǎng 想 zuò 做 yí gè 一个 liáo tiān 聊天 ruǎn jiàn 软件 B o t Bot ， yòng hù 用户 kě yǐ 可以 tōng guò 通过 tā 它 hé 和 Claude Claude A g e n t Agent jiāo hù 交互 。 zhè gè 这个 B o t Bot xū yào 需要 zhī chí 支持 duō yòng hù 多用户 ， měi gè 每个 yòng hù 用户 yǒu 有 dú lì 独立 de 的 gōng zuò 工作 mù lù 目录 hé 和 cún chǔ 存储 pèi é 配额 。 nǐ 你 jué dé 觉得 yīng gāi 应该 zěn me 怎么 shè jì 设计 mó kuài 模块 ？ yǒu 有 shén me 什么 qián zài 潜在 de 的 wèn tí 问题 ？ 」
rán hòu 然后 AI AI huì 会 gěi 给 wǒ 我 yí gè 一个 chū bù 初步 de 的 jià gòu 架构 jiàn yì 建议 。 dàn 但 zhè lǐ 这里 de 的 guān jiàn 关键 bú shì 不是 AI AI gěi 给 le 了 shén me 什么 dá àn 答案 ， ér shì 而是 wǒ 我 zěn me 怎么 píng gū 评估 zhè gè 这个 dá àn 答案 。
wǒ huì 我会 wèn 问 zì jǐ 自己 sān gè 三个 wèn tí 问题 ：
wǒ néng 我能 lǐ jiě 理解 zhè gè 这个 jià gòu 架构 ma 吗 ？
rú guǒ 如果 AI AI gěi 给 wǒ 我 de 的 jià gòu 架构 wǒ 我 zì jǐ 自己 dōu 都 kàn bù dǒng 看不懂 ， nà 那 hòu miàn 后面 chū 出 le 了 wèn tí 问题 wǒ 我 gēn běn 根本 méi fǎ 没法 diào shì 调试 。 bǐ rú 比如 dì yī cì 第一次 AI AI gěi 给 wǒ 我 de 的 fāng àn 方案 lǐ 里 ， tā 它 jiàn yì 建议 yòng 用 yí gè 一个 fù zá 复杂 de 的 shì jiàn qū dòng 事件驱动 jià gòu 架构 ， yǒu 有 M e s s a g e Message Q u e u e Queue 、 E v e n t Event B u s Bus shén me 什么 de 的 。 tīng 听 qǐ lái 起来 hěn 很 zhuān yè 专业 ， dàn 但 wǒ 我 gēn běn 根本 bù 不 lǐ jiě 理解 zhè xiē 这些 dōng xī 东西 shì 是 gàn shén me 干什么 de 的 。
suǒ yǐ 所以 wǒ 我 zhí jiē 直接 gào sù 告诉 AI AI ： 「 zhè gè 这个 tài 太 fù zá 复杂 le 了 ， nǐ 你 néng 能 gěi 给 wǒ 我 jiǎng 讲 yī xià 一下 bù 不 ， tōng sú yì dǒng 通俗易懂 yī diǎn 一点 」 。 zǒng zhī 总之 bù huì 不会 jiù yào 就要 wèn 问 ， AI AI yòu 又 bù huì 不会 mà 骂 nǐ 你 ， tā huì 他会 xì xīn 细心 de 的 jiào 教 nǐ 你 。
AI AI de 的 chū shǐ 初始 fāng àn 方案 hěn 很 jiǎn dān 简单 ， tā 它 bǎ 把 zhěng gè 整个 xì tǒng 系统 fēn chéng 分成 sì céng 四层 ： liáo tiān 聊天 jiāo hù 交互 céng 层 、 A g e n t Agent kè hù duān 客户端 céng 层 、 yòng hù 用户 guǎn lǐ céng 管理层 、 shù jù 数据 cún chǔ 存储 céng 层 。 tīng 听 qǐ lái 起来 hěn 很 qīng xī 清晰 ， dàn 但 wǒ 我 yì shí 意识 dào 到 yí gè 一个 wèn tí 问题 ： ān quán 安全 。
wǒ 我 de 的 B o t Bot kě yǐ 可以 dú xiě 读写 fú wù qì 服务器 shàng 上 de 的 wén jiàn 文件 ， rú guǒ 如果 yòng hù 用户 A A kě yǐ 可以 fǎng wèn 访问 yòng hù 用户 B B de 的 wén jiàn 文件 zěn me bàn 怎么办 ？ rú guǒ 如果 AI AI chū cuò 出错 ， bǎ 把 wǒ 我 de 的 zhěng gè 整个 fú wù qì 服务器 wén jiàn 文件 dōu 都 shān 删 le 了 zěn me bàn 怎么办 ？ zhè xiē 这些 AI AI zài 在 chū bǎn 初版 jià gòu 架构 lǐ 里 dōu 都 méi 没 kǎo lǜ 考虑 dào 到 。
suǒ yǐ 所以 wǒ 我 yòu 又 wèn 问 AI AI ： 「 rú guǒ 如果 yí gè 一个 yòng hù 用户 è yì 恶意 cāo zuò 操作 ， huò zhě 或者 AI AI chū xiàn 出现 b u g bug ， zěn me 怎么 bǎo zhèng xì tǒng 保证系统 de 的 ān quán 安全 ？ 」
AI AI gěi 给 le 了 wǒ 我 jǐ gè 几个 jiàn yì 建议 ： lù jìng 路径 gé lí 隔离 、 D o c k e r Docker róng qì 容器 、 quán xiàn 权限 bái míng dān 白名单 。 zhè shí hòu 这时候 wǒ 我 cái 才 yì shí 意识 dào 到 ， jià gòu shè jì 架构设计 de 的 shí hòu 时候 jiù yào 就要 bǎ 把 ān quán 安全 kǎo lǜ 考虑 jìn qù 进去 ， ér 而 bú shì 不是 děng dào 等到 dài mǎ 代码 xiě 写 wán 完 le 了 zài 再 bǔ 补 。
zhè 这 5 5 fēn zhōng 分钟 de 的 duì huà 对话 ， shěng 省 le 了 wǒ 我 hòu miàn 后面 zhì shǎo 至少 5 5 gè 个 xiǎo shí 小时 de 的 fǎn gōng 返工 shí jiān 时间 。
yīn wèi 因为 rú guǒ 如果 wǒ 我 zhí jiē 直接 ràng 让 AI AI kāi shǐ 开始 xiě 写 dài mǎ 代码 ， tā huì 它会 àn zhào 按照 zuì 最 zhí jiē 直接 de 的 fāng shì 方式 qù 去 shí xiàn 实现 gōng néng 功能 — — méi yǒu 没有 ān quán jiǎn chá 安全检查 、 méi yǒu 没有 lù jìng 路径 gé lí 隔离 、 méi yǒu 没有 cuò wù chù lǐ 错误处理 。 děng 等 wǒ 我 fā xiàn 发现 wèn tí 问题 de 的 shí hòu 时候 ， dài mǎ 代码 yǐ jīng 已经 xiě 写 le 了 jǐ bǎi 几百 xíng 行 le 了 ， gǎi 改 qǐ lái 起来 yòu 又 yào 要 zhòng xīn 重新 lǐ 理 qīng chǔ 清楚 luó jí 逻辑 。
jià gòu 架构 sī kǎo 思考 de 的 běn zhì 本质 ， bú shì 不是 ràng 让 AI AI gào sù 告诉 nǐ 你 gāi 该 zěn me 怎么 zuò 做 ， ér shì 而是 bī 逼 zì jǐ 自己 xiǎng 想 qīng chǔ 清楚 ： zhè gè 这个 xì tǒng 系统 de 的 biān jiè 边界 zài 在 nǎ lǐ 哪里 ？ zuì 最 róng yì 容易 chū 出 wèn tí 问题 de 的 dì fāng 地方 shì 是 nǎ lǐ 哪里 ？ rú guǒ 如果 wǒ 我 zhǐ néng 只能 yōu huà 优化 yí gè 一个 mó kuài 模块 ， wǒ huì 我会 xuǎn 选 nǎ gè 哪个 ？
bù zhòu 步骤 3 3 ： zhú 逐 mó kuài 模块 shí xiàn 实现 — — yī cì 一次 zhǐ 只 zuò 做 yī jiàn 一件 shì 事
què dìng 确定 hǎo 好 jià gòu 架构 zhī hòu 之后 ， hěn duō 很多 rén huì 人会 zhí jiē 直接 ràng 让 AI AI 「 bǎ 把 zhěng gè 整个 xiàng mù 项目 xiě 写 chū lái 出来 」 。 wǒ 我 yī 一 kāi shǐ 开始 yě 也 shì 是 zhè me 这么 gàn 干 de 的 ， jié guǒ 结果 jiù shì 就是 AI AI xiě 写 le 了 yī duī 一堆 dài mǎ 代码 ， wǒ 我 wán quán 完全 kàn bù dǒng 看不懂 ， chū 出 le 了 wèn tí 问题 yě 也 bù 不 zhī dào 知道 cóng 从 nǎ lǐ 哪里 kāi shǐ 开始 chá 查 。
jiù 就 xiàng 像 rén 人 yī yàng 一样 ， měi gè 每个 rén 人 de 的 jīng lì 精力 ， gōng zuò 工作 dōu 都 shì 是 yī diǎn yī diǎn 一点一点 zuò 做 de 的 。 AI AI yě 也 shì 是 yī yàng 一样 de 的 ， nǐ 你 ràng 让 tā 他 bǎ 把 suǒ yǒu 所有 de 的 jīng lì 精力 dōu 都 yòng lái 用来 zuò 做 yí gè 一个 dōng xī 东西 ， tā 他 jiù 就 néng 能 zuò dé hǎo 做得好 。 dàn 但 rú guǒ 如果 nǐ 你 ràng 让 tā 他 fēn sàn 分散 jīng lì 精力 qù 去 xiǎng 想 nà me 那么 duō 多 shì qíng 事情 ， tā 他 kě néng 可能 jiù 就 méi yǒu 没有 nà me 那么 duō 多 jīng lì 精力 ， jiù 就 huì 会 róng yì 容易 chū cuò 出错 。 suǒ yǐ 所以 wǒ 我 hòu miàn 后面 yě 也 shì 是 yī cì 一次 jiù ràng 就让 AI AI zuò 做 yī jiàn 一件 shì 事 。
bǐ rú shuō 比如说 wǒ yào 我要 qù 去 zuò 做 yí gè 一个 yòng hù 用户 guǎn lǐ 管理 mó kuài 模块 ， wǒ 我 bù huì 不会 shuō 说 ràng 让 tā 他 zhí jiē 直接 qù 去 bāng 帮 wǒ 我 xiě 写 yí gè 一个 yòng hù 用户 guǎn lǐ xì tǒng 管理系统 ， yīn wèi 因为 tài 太 mó hu 模糊 le 了 ， tā 他 zì jǐ 自己 kě néng 可能 huì nǎo 会脑 bǔ 补 hěn duō 很多 nǐ 你 gēn běn 根本 bù 不 zhī dào 知道 de 的 gōng néng 功能 。
dé 得 jù tǐ 具体 yī diǎn 一点 ， shí xiàn 实现 yí gè 一个 u s e r user m a n a g e r manager ， yǒu 有 shén me 什么 gōng néng 功能 ， bǐ rú 比如 chuàng jiàn 创建 yòng hù 用户 、 huò qǔ 获取 yòng hù 用户 de 的 pèi zhì 配置 、 jiǎn chá 检查 cún chǔ 存储 pèi é 配额 ， rán hòu 然后 gèng xīn 更新 cún chǔ 存储 de 的 pèi é 配额 shǐ yòng liàng 使用量 ， rán hòu 然后 měi gè 每个 yòng hù 用户 tā 它 de 的 shù jù 数据 yòu 又 shì 是 zài 在 yí gè 一个 dān dú 单独 de 的 wén jiàn jiā 文件夹 shàng 上 。
zhè 这 yàng zi 样子 AI AI jiù 就 zhī dào 知道 biān jiè 边界 zài 在 nǎ lǐ 哪里 ， jiù 就 bù huì 不会 xiě 写 zhe 着 xiě 写 zhe 着 jiù 就 pǎo 跑 piān 偏 le 了 。
rú guǒ 如果 nǐ 你 zì jǐ 自己 dōu 都 xiǎng 想 bù 不 qīng chǔ 清楚 de 的 dōng xī 东西 ， nǐ 你 yě 也 kě yǐ 可以 bǎ 把 nǐ 你 de 的 xiǎng fǎ 想法 nǐ 你 jiù 就 gēn 跟 tā 他 shuō 说 ， wǒ yào 我要 xiě 写 yí gè 一个 yòng hù 用户 guǎn lǐ 管理 mó kuài 模块 ， rán hòu 然后 nǐ 你 jiù 就 wèn 问 tā 他 yòng hù 用户 guǎn lǐ 管理 mó kuài 模块 dà gài 大概 yǒu 有 shén me yàng 什么样 de 的 bù fēn 部分 。 bǎ 把 yí gè 一个 dà 大 xū qiú 需求 nǐ 你 gēn zhe 跟着 tā 他 yī qǐ 一起 bǎ 把 tā 它 gěi 给 chāi fēn 拆分 xià lái 下来 ， rán hòu 然后 yí gè 一个 yí gè 一个 de 的 lái 来 zuò 做 ， xiāng duì lái shuō 相对来说 xiě 写 qǐ lái 起来 yě 也 bù huì 不会 nà me 那么 róng yì 容易 chū cuò 出错 。
bù zhòu 步骤 4 4 ： chù lǐ cuò wù 处理错误 hé 和 xì jié 细节 — — ràng 让 AI AI zì jǐ 自己 cè shì 测试 ， gěi 给 AI AI zú gòu 足够 de 的 shàng xià wén 上下文
dài mǎ 代码 xiě 写 wán 完 bù 不 dài biǎo 代表 jiù 就 néng 能 yòng 用 le 了 。 wǒ 我 gǎn jué 感觉 huā 花 zài 在 diào shì 调试 shàng 上 de 的 shí jiān 时间 bǐ xiě 比写 xīn 新 gōng néng 功能 de 的 shí jiān 时间 hái 还 duō 多 。 màn màn 慢慢 de 的 yě 也 jiù 就 yǎng chéng 养成 le 了 liǎng gè 两个 jì qiǎo 技巧 ， ràng 让 diào shì 调试 xiào lǜ 效率 tí gāo 提高 le 了 hěn duō 很多 。
shǒu xiān 首先 jiù shì 就是 ràng 让 AI AI zì jǐ 自己 xiān 先 cè shì dài mǎ 测试代码 。
yǐ qián 以前 wǒ huì 我会 ràng 让 AI AI xiě 写 wán 完 dài mǎ 代码 jiù 就 zhí jiē 直接 jí chéng 集成 dào 到 xiàng mù 项目 lǐ 里 ， rán hòu 然后 yùn xíng 运行 zhěng gè 整个 xiàng mù 项目 kàn 看 yǒu méi yǒu 有没有 wèn tí 问题 。 jié guǒ 结果 jīng cháng 经常 shì 是 ： xiàng mù 项目 pǎo 跑 bù 不 qǐ lái 起来 ， dàn 但 wǒ 我 bù 不 zhī dào 知道 shì 是 nǎ gè 哪个 mó kuài 模块 chū 出 le 了 wèn tí 问题 。
suǒ yǐ 所以 xiàn zài 现在 wǒ huì 我会 zài 在 AI AI xiě 写 wán 完 yí gè 一个 mó kuài 模块 zhī hòu 之后 ， zhí jiē 直接 gào sù 告诉 tā 它 ： 「 xiě 写 jǐ gè 几个 cè shì yòng lì 测试用例 ， yàn zhèng 验证 yī xià 一下 zhè xiē 这些 hán shù 函数 shì bù shì 是不是 zhèng què 正确 de 的 。 」
AI AI zì jǐ 自己 xiě 写 cè shì 测试 、 zì jǐ 自己 pǎo 跑 cè shì 测试 ， dà bù fēn 大部分 dī jí 低级 cuò wù 错误 — — bǐ rú 比如 cān shù 参数 lèi xíng 类型 cuò 错 le 了 、 lù jìng 路径 pīn jiē 拼接 cuò 错 le 了 、 biān jiè tiáo jiàn 边界条件 méi 没 chǔ lǐ 处理 — — tā 它 zì jǐ 自己 jiù 就 néng 能 fā xiàn 发现 bìng 并 xiū fù 修复 。 děng 等 tā 它 gào sù 告诉 wǒ 我 「 cè shì tōng guò 测试通过 」 de 的 shí hòu 时候 ， wǒ 我 ná dào 拿到 de 的 dài mǎ 代码 zhì liàng 质量 bǐ 比 「 xiě 写 wán 完 zhí jiē 直接 jiāo fù 交付 」 gāo 高 hěn duō 很多 。
dì èr 第二 jiù shì 就是 bào cuò 报错 de 的 shí hòu 时候 ， gěi 给 AI AI zú gòu 足够 de 的 shàng xià wén 上下文 。
zhè 这 shì 是 wǒ 我 cǎi 踩 guò 过 zuì 最 duō 多 kēng 坑 de 的 dì fāng 地方 。 yī 一 kāi shǐ 开始 yù dào 遇到 wèn tí 问题 ， wǒ huì 我会 zhí jiē 直接 gào sù 告诉 AI AI ： 「 zhè gè 这个 gōng néng 功能 bù 不 gōng zuò 工作 。 」 rán hòu 然后 AI AI jiù 就 kāi shǐ 开始 cāi 猜 — — kě néng 可能 shì 是 zhè gè 这个 wèn tí 问题 、 kě néng 可能 shì 是 nà gè 那个 wèn tí 问题 — — cāi 猜 le 了 shí lún 十轮 hái 还 méi 没 cāi 猜 duì 对 。
AI AI bú shì 不是 shén 神 ， tā 它 xū yào 需要 nǐ 你 gào sù 告诉 tā 它 fā shēng 发生 le 了 shén me 什么 。
xiàn zài 现在 wǒ 我 bào cuò 报错 de 的 fāng shì 方式 shì 是 zhè yàng 这样 de 的 ： 「 wǒ 我 shàng chuán 上传 le 了 yí gè 一个 2 M B 2MB de 的 P D F PDF ， qī wàng 期望 dé dào 得到 M a r k d o w n Markdown shū chū 输出 ， dàn 但 xì tǒng 系统 fǎn huí 返回 le 了 &# 3 9 39 ; P e r m i s s i o n Permission d e n i e d denied &# 3 9 39 ; 。 wǒ 我 jué dé 觉得 kě néng 可能 shì 是 mù lù 目录 quán xiàn 权限 wèn tí 问题 ， yīn wèi 因为 zhè gè 这个 mù lù 目录 shì 是 dì yī cì 第一次 bèi 被 xiě rù 写入 。 」
zhè zhǒng 这种 miáo shù 描述 bāo hán 包含 le 了 sān gè 三个 guān jiàn 关键 xìn xī 信息 ： wǒ 我 zuò 做 le 了 shén me 什么 cāo zuò 操作 、 wǒ 我 qī wàng 期望 shén me 什么 jié guǒ 结果 、 wǒ 我 shí jì 实际 dé dào 得到 le 了 shén me 什么 。 yǒu 有 le 了 zhè xiē 这些 ， AI AI jī běn shàng 基本上 yī lún 一轮 jiù 就 néng 能 dìng wèi 定位 dào 到 wèn tí 问题 。
zhè xiē 这些 dōu 都 shì 是 lái yuán yú 来源于 wǒ 我 zhēn shí 真实 de 的 kēng 坑 ：
kēng 坑 1 1 ： U R L URL pīn jiē 拼接 cuò wù 错误
wǒ yòng 我用 de 的 bú shì 不是 guān fāng 官方 de 的 A n t h r o p i c Anthropic A P I API ， ér shì 而是 zì jǐ 自己 de 的 A P I API wǎng guān 网关 。 pèi zhì 配置 de 的 shí hòu 时候 ， wǒ 我 bǎ 把 b a s e base U R L URL xiě chéng 写成 le 了 h t t p s https : / / m y my - g a t e w a y gateway . c o m com / v 1 v1 。 jié guǒ 结果 yì zhí 一直 bào cuò 报错 ， zhǎo 找 bù dào 不到 jiē kǒu 接口 。
chá 查 le 了 bàn tiān 半天 cái 才 fā xiàn 发现 ， Claude Claude S D K SDK huì 会 zì dòng 自动 zài 在 U R L URL hòu miàn 后面 jiā 加 / v 1 v1 ， suǒ yǐ 所以 shí jì 实际 qǐng qiú 请求 de 的 dì zhǐ 地址 biàn chéng 变成 le 了 h t t p s https : / / m y my - g a t e w a y gateway . c o m com / v 1 v1 / v 1 v1 。
zhè zhǒng 这种 wèn tí 问题 AI AI bāng bù le 帮不了 nǐ 你 ， yīn wèi 因为 tā 它 bù 不 zhī dào 知道 nǐ 你 de 的 pèi zhì 配置 shì 是 shén me 什么 。 wǒ 我 de 的 jiě jué 解决 fāng fǎ 方法 shì 是 ： zài 在 jí chéng 集成 dào 到 xiàng mù 项目 zhī qián 之前 ， xiān yòng 先用 zuì 最 jiǎn dān 简单 de 的 fāng shì 方式 cè shì 测试 。 bǐ rú 比如 zhí jiē 直接 yòng 用 c u r l curl fā 发 yí gè 一个 qǐng qiú 请求 ， kàn néng 看能 bù néng 不能 tōng 通 。 rú guǒ 如果 c u r l curl dōu 都 bù tōng 不通 ， nà 那 wèn tí 问题 kěn dìng 肯定 zài 在 pèi zhì 配置 shàng 上 ， bú shì 不是 dài mǎ 代码 de 的 wèn tí 问题 。
bǐ rú shuō 比如说 wǒ 我 zhè lǐ 这里 ， wǒ 我 zhí jiē 直接 wèn 问 tā 他 「 nǐ 你 néng 能 zuò 做 shén me 什么 」 ， jié guǒ 结果 ne 呢 ， tā 他 fǎn huí 返回 le 了 yí gè 一个 AI AI A P I API de 的 bào cuò 报错 。 zhè gè 这个 shì 是 zài 在 wǒ 我 gāng 刚 jí chéng 集成 le 了 A P I API zhī hòu 之后 ， rán hòu 然后 jiù 就 zhí jiē 直接 qù 去 cè shì 测试 ， rán hòu 然后 tā 他 jiù 就 gěi 给 wǒ 我 bào 报 le 了 cuò wù 错误 。
suǒ yǐ 所以 wǒ 我 jiù 就 yì zhí 一直 ràng 让 tā 他 qù 去 jiǎn chá 检查 dào dǐ 到底 shì 是 nǎ lǐ 哪里 cuò 错 de 的 。 tā 他 jiù 就 bì xū 必须 shì 是 yòng 用 xiě 写 wán 完 le 了 de 的 zhěng tǐ 整体 dài mǎ 代码 qù cè 去测 。
rú guǒ 如果 shì 是 wǒ 我 zài 在 ràng 让 tā 他 jí chéng 集成 zhī qián 之前 ， jiù 就 xiān 先 qù 去 bǎ 把 zhè gè 这个 shén me 什么 wǎng guān 网关 pèi zhì 配置 、 mó xíng 模型 de 的 míng chēng 名称 shén me 什么 de 的 dōu 都 zì jǐ 自己 qù cè 去测 、 qù 去 tián xiě 填写 hǎo 好 ， zài 再 bǎ 把 tā 它 jí chéng 集成 jìn qù 进去 ， jiù 就 bù huì 不会 nà me 那么 má fán 麻烦 。
yīn wèi 因为 tā 他 xiàn zài 现在 shì 是 gēn zhe 跟着 zhěng gè 整个 dài mǎ 代码 yī qǐ 一起 qù 去 cè shì 测试 ， rán hòu 然后 zhěng gè 整个 dài mǎ 代码 yòu 又 shì 是 gēn 跟 zhěng gè 整个 dà 大 xiàng mù 项目 lián hé 联合 zài 在 yī qǐ 一起 de 的 ， suǒ yǐ 所以 shuō 说 nǐ 你 ràng 让 tā 他 qù 去 cè shì 测试 ， jiù 就 kě néng 可能 huì dòng 会动 dào 到 qí tā 其他 de 的 bù fēn 部分 。 zhè 这 yàng zi 样子 jiù 就 huì 会 yǒu 有 yī xiē 一些 bù bì yào 不必要 de 的 má fán 麻烦 。
suǒ yǐ 所以 nǐ 你 bǎ 把 zhè gè 这个 dān dú 单独 de 的 AI AI A P I API ràng 让 tā 他 dān dú 单独 dì qù 地去 cè shì 测试 ， jiù shì 就是 zài 在 zuì xiǎo 最小 chéng dù 程度 shàng qù 上去 jiǎn shǎo 减少 yǐng xiǎng 影响 dào 到 qí tā 其他 de 的 fāng miàn 方面 。 zhè 这 yàng zi 样子 shǒu xiān 首先 tā 他 zhuān mén 专门 diào 调 zhè gè 这个 dì fāng 地方 yě 也 huì 会 diào dé 调得 bǐ jiào 比较 zhuān zhù 专注 ， dì èr gè 第二个 yě 也 bù huì 不会 qiān chě 牵扯 dào 到 qí tā 其他 de 的 bù fēn 部分 ， jiù shì 就是 bù huì 不会 bǎ 把 nǐ 你 de 的 cè shì 测试 de 的 bù fēn 部分 gēn 跟 nǐ 你 de 的 shēng chǎn 生产 dài mǎ 代码 fàng zài 放在 yī qǐ 一起 qù 去 hùn xiáo 混淆 。
kēng 坑 2 2 ： M a r k d o w n Markdown gé shì 格式 wèn tí 问题
AI AI mò rèn 默认 huì 会 yòng 用 M a r k d o w n Markdown gé shì 格式 shū chū 输出 ， jiā cū 加粗 、 xié tǐ 斜体 、 dài mǎ 代码 kuài 块 shén me 什么 de 的 。 dàn 但 wǒ 我 fā xiàn 发现 wǒ 我 zài 在 yòng 用 de 的 liáo tiān 聊天 ruǎn jiàn 软件
yī 一 kāi shǐ 开始 wǒ 我 xiǎng 想 ràng 让 AI AI zài 在 fā sòng 发送 qián 前 zì dòng 自动 zhuǎn huàn 转换 gé shì 格式 ， dàn 但 zhè yàng 这样 tài 太 má fán 麻烦 le 了 ， ér qiě 而且 róng yì 容易 chū 出 b u g bug 。 hòu lái 后来 wǒ 我 zhí jiē 直接 zài 在 xì tǒng 系统 p r o m p t prompt lǐ 里 gào sù 告诉 AI AI ： 「 zài 在 zhè gè 这个 liáo tiān 聊天 ruǎn jiàn 软件 jiā cū 加粗 huò 或 xié tǐ 斜体 。 kě yǐ 可以 yòng 用 biān hào 编号 liè biǎo 列表 huò zhě 或者 huàn xíng 换行 lái 来 zǔ zhī 组织 nèi róng 内容 。 」
dāng rán 当然 ， qí shí 其实 nǐ 你 zhè me 这么 gēn 跟 tā 他 shuō 说 ， tā 他 yǒu shí hòu 有时候 hái shì 还是 bù huì 不会 qù 去 zūn shǒu 遵守 zhè gè 这个 p r o m p t prompt guī dìng 规定 。 suǒ yǐ 所以 wǒ 我 jiù 就 zhí jiē 直接 xiě 写 le 了 yí gè 一个 jiǎo běn 脚本 ， yòng 用 zhèng zé 正则 gōng shì 公式 zhí jiē 直接 bǎ 把 zhè xiē 这些 shén me 什么 「 jiā cū 加粗 」 「 xié tǐ 斜体 」 zhè zhǒng 这种 yuán shǐ 原始 de 的 gé shì 格式 zhí jiē 直接 gěi 给 qù diào 去掉 ， wèn tí 问题 zhí jiē 直接 cóng 从 yuán tóu 源头 jiě jué 解决 le 了 。
yǒu 有 yī cì 一次 wǒ 我 jiā lǐ rén 家里人 shàng chuán 上传 wén jiàn 文件 ， xì tǒng 系统 bào cuò 报错 「 mù lù 目录 bù 不 cún zài 存在 」 。 yuán yīn 原因 shì 是 dài mǎ 代码 lǐ 里 jiǎ shè 假设 mù lù 目录 yǐ jīng 已经 cún zài 存在 ， dàn 但 duì yú 对于 xīn 新 yòng hù 用户 lái shuō 来说 ， tā 他 de 的 zhuān shǔ 专属 mù lù 目录 hái 还 méi yǒu 没有 bèi 被 chuàng jiàn 创建 guò 过 。
zhè zhǒng 这种 wèn tí 问题 zài 在 běn dì 本地 cè shì 测试 de 的 shí hòu 时候 bù 不 róng yì 容易 fā xiàn 发现 ， yīn wèi 因为 nǐ 你 zì jǐ 自己 cè shì 测试 de 的 shí hòu 时候 mù lù 目录 dōu 都 shì 是 xiàn chéng 现成 de 的 。 jiě jué 解决 fāng fǎ 方法 hěn 很 jiǎn dān 简单 ： ràng 让 AI AI zài 在 xiě rù 写入 wén jiàn 文件 zhī qián 之前 ， xiān 先 jiǎn chá 检查 mù lù 目录 shì fǒu 是否 cún zài 存在 ， bù 不 cún zài 存在 jiù 就 zì dòng 自动 chuàng jiàn 创建 。
dàn 但 gèng 更 zhòng yào 重要 de 的 shì 是 ， zhè 这 ràng 让 wǒ 我 yì shí 意识 dào 到 ： hěn duō 很多 b u g bug bú shì 不是 dài mǎ 代码 luó jí 逻辑 de 的 wèn tí 问题 ， ér shì 而是 huán jìng 环境 jiǎ shè 假设 de 的 wèn tí 问题 。 AI AI xiě 写 dài mǎ 代码 de 的 shí hòu 时候 ， tā 它 jiǎ shè 假设 de 的 huán jìng 环境 kě néng 可能 hé 和 zhēn shí 真实 yùn xíng 运行 de 的 huán jìng 环境 bù 不 yī yàng 一样 。 suǒ yǐ 所以 wǒ 我 xiàn zài 现在 huì 会 tè bié 特别 zhù yì 注意 wèn 问 AI AI ： 「 zhè 这 duàn 段 dài mǎ 代码 yǒu 有 shén me 什么 qián zhì tiáo jiàn 前置条件 ？ xū yào 需要 shén me 什么 mù lù 目录 、 shén me 什么 quán xiàn 权限 、 shén me 什么 yī lài 依赖 ？ 」
zǒng jié 总结 yī xià 一下 chù lǐ cuò wù 处理错误 de 的 xīn fǎ 心法 ：
xiān 先 ràng 让 AI AI zì jǐ 自己 cè 测 ， jiǎn shǎo 减少 dī jí 低级 cuò wù 错误
bào cuò 报错 shí 时 gěi 给 wán zhěng 完整 shàng xià wén 上下文 ： zuò 做 le 了 shén me 什么 、 qī wàng 期望 shén me 什么 、 dé dào 得到 shén me 什么
jí chéng 集成 qián xiān yòng 前先用 zuì xiǎo 最小 fāng shì 方式 yàn zhèng 验证 （ c u r l curl 、 jiǎn dān 简单 jiǎo běn 脚本 ）
wèn 问 qīng chǔ 清楚 dài mǎ 代码 de 的 qián zhì tiáo jiàn 前置条件 hé 和 huán jìng 环境 jiǎ shè 假设
guī gēn jié dǐ 归根结底 ， diào shì 调试 bú shì 不是 xuán xué 玄学 ， shì 是 xìn xī zhàn 信息战 。 nǐ 你 gěi 给 AI AI de 的 xìn xī 信息 yuè 越 wán zhěng 完整 ， tā 它 bāng 帮 nǐ 你 dìng wèi wèn tí 定位问题 jiù 就 yuè 越 kuài 快 。
chǎn pǐn 产品 sī wéi 思维 — — dài mǎ 代码 néng 能 xué huì 学会 ， zhè gè 这个 xué 学 bù huì 不会
dào 到 zhè lǐ 这里 ， yǒu rén 有人 kě néng 可能 huì 会 jué dé 觉得 ： yòng 用 AI AI xiě 写 dài mǎ 代码 yě 也 méi shén me 没什么 nán 难 de 的 ma 嘛 ， gēn zhe 跟着 bù zhòu 步骤 lái 来 jiù xíng le 就行了 。
dàn 但 wǒ 我 xiǎng 想 shuō 说 de 的 shì 是 ， dài mǎ 代码 zhǐ shì 只是 zuì 最 róng yì 容易 de 的 bù fēn 部分 。 zhēn zhèng 真正 jué dìng 决定 nǐ 你 zuò 做 chū lái 出来 de 的 dōng xī 东西 néng 能 bù néng 不能 yòng 用 、 hǎo bù hǎo 好不好 yòng 用 de 的 ， shì 是 nǐ 你 de 的 chǎn pǐn 产品 sī wéi 思维 。 ér 而 zhè gè 这个 dōng xī 东西 ， AI AI bāng bù le 帮不了 nǐ 你 。
wǒ jǔ 我举 jǐ gè 几个 wǒ 我 zài 在 zuò 做 AI AI A g e n t Agent B o t Bot shí 时 de 的 zhēn shí 真实 lì zi 例子 。
shè jì 设计 1 1 ： wèi shén me 为什么 yào 要 zuò 做 cún chǔ 存储 pèi é 配额 xì tǒng 系统 ？
yī 一 kāi shǐ 开始 wǒ 我 méi xiǎng 没想 guò 过 zhè gè 这个 wèn tí 问题 。 yòng hù 用户 shàng chuán 上传 wén jiàn 文件 ， wǒ 我 jiù 就 cún dào 存到 fú wù qì 服务器 shàng 上 ， hěn 很 jiǎn dān 简单 。
dàn 但 hòu lái 后来 wǒ 我 suàn le 算了 yī bǐ 一笔 zhàng 账 ： wǒ 我 de 的 V P S VPS zǒng gòng 总共 1 5 0 G B 150GB yìng pán kōng jiān 硬盘空间 。 rú guǒ 如果 wǒ 我 kāi fàng 开放 gěi 给 1 0 10 gè 个 péng yǒu 朋友 yòng 用 ， měi gè 每个 rén chuán 人传 2 0 G B 20GB de 的 wén jiàn 文件 ， yìng pán 硬盘 jiù 就 mǎn 满 le 了 。 gèng zāo 更糟 de 的 shì 是 ， rú guǒ 如果 yǒu 有 yí gè 一个 rén chuán 人传 le 了 1 0 0 G B 100GB ， qí tā rén 其他人 jiù 就 méi fǎ yòng 没法用 le 了 。
zhè shí hòu 这时候 wǒ 我 yì shí 意识 dào 到 ， wǒ 我 xū yào 需要 yí gè 一个 pèi é 配额 xì tǒng 系统 。
dàn 但 pèi é 配额 shè 设 chéng 成 duō shǎo 多少 hé shì 合适 ？ wǒ 我 xiǎng 想 le 了 xiǎng 想 zì jǐ 自己 de 的 shǐ yòng 使用 chǎng jǐng 场景 ： rì cháng 日常 chǔ lǐ 处理 de 的 wén jiàn 文件 ， P D F PDF 、 tú piàn 图片 、 wén dàng 文档 ， jiā 加 qǐ lái 起来 kě néng 可能 yě 也 jiù 就 jǐ bǎi 几百 M B MB 。 gěi 给 měi gè 每个 yòng hù 用户 5 G B 5GB ， zú gòu 足够 yòng 用 le 了 ， ér qiě 而且 1 5 0 G B 150GB kě yǐ 可以 zhī chí 支持 3 0 30 gè 个 yòng hù 用户 ， hái 还 liú yǒu 留有 yú liàng 余量 。
zhè gè 这个 jué cè 决策 AI AI néng 能 bāng 帮 wǒ 我 zuò 做 ma 吗 ？
zhè 这 yě 也 shì 是 kě yǐ 可以 de 的 ， nǐ 你 kě yǐ 可以 ràng 让 tā 他 zì jǐ 自己 qù chá 去查 zhěng gè 整个 xì tǒng 系统 de 的 yí gè 一个 pèi zhì 配置 ， rán hòu 然后 nǐ 你 zài 再 gēn 跟 tā 他 shuō 说 nǐ 你 dà gài 大概 yǒu 有 jǐ gè 几个 rén huì lái 人会来 shǐ yòng 使用 ， diào yán 调研 dà gài 大概 duō shǎo 多少 shì 是 hé shì 合适 de 的 。
rán hòu 然后 bāo kuò 包括 shuō 说 ， nǐ 你 kě yǐ 可以 ràng 让 tā 他 qù 去 shè jì 设计 nà zhǒng 那种 ： tā 他 de 的 měi 每 yī cì 一次 yòng hù 用户 shàng chuán 上传 de 的 wén jiàn 文件 huò zhě 或者 chǎn shēng 产生 xīn 新 wén jiàn 文件 ， tā 他 jiù yào 就要 zì jǐ 自己 qù 去 zhěng lǐ 整理 zhè zhǒng 这种 wén jiàn xì tǒng 文件系统 ， tā 他 yào 要 yǒu yì shí 有意识 dì qù 地去 tí shì 提示 yòng hù 用户 ， tí xǐng 提醒 wén jiàn 文件 「 nǐ 你 zhè gè 这个 wén jiàn 文件 xū yào 需要 zhěng lǐ 整理 le 了 ， nǐ 你 yào 要 zěn me 怎么 zěn me yàng 怎么样 」 。
AI AI hěn kuài 很快 jiù 就 bǎ 把 dài mǎ 代码 xiě 写 chū lái 出来 le 了 。 dàn 但 「 5 G B 5GB 」 zhè gè 这个 shù zì 数字 ， shì 是 wǒ men 我们 tǎo lùn 讨论 xiǎng 想 chū lái 出来 de 的 。
AI AI shì 是 zhí xíng zhě 执行者 ， nǐ 你 shì 是 jué cè zhě 决策者 。 nǐ 你 yào 要 xiǎng 想 qīng chǔ 清楚 「 zuò 做 shén me 什么 」 hé 和 「 wèi shén me 为什么 」 ， AI AI fù zé 负责 「 zěn me 怎么 zuò 做 」 。 rú guǒ 如果 nǐ 你 zì jǐ 自己 dōu 都 méi xiǎng 没想 qīng chǔ 清楚 ， AI AI xiě 写 chū lái 出来 de 的 dōng xī 东西 jiù suàn 就算 néng 能 pǎo 跑 ， yě 也 bù 不 yí dìng 一定 shì 是 nǐ 你 zhēn zhèng 真正 xū yào 需要 de 的 。
shè jì 设计 2 2 ： xiāo xī 消息 tài 太 zhǎng 长 zěn me bàn 怎么办 ？
zhè gè 这个 wèn tí 问题 shì 是 wǒ 我 zài 在 shí jì 实际 shǐ yòng 使用 zhōng 中 fā xiàn 发现 de 的 。
yǒu 有 yī cì 一次 wǒ 我 ràng 让 AI AI fēn xī 分析 yí gè 一个 zhǎng 长 wén dàng 文档 ， tā 它 fǎn huí 返回 le 了 yī dà 一大 duàn 段 fēn xī 分析 jié guǒ 结果 ， dà gài 大概 2 0 0 0 2000 duō zì 多字 。 jié guǒ 结果 zhè gè 这个 liáo tiān 聊天 ruǎn jiàn 软件 xiǎn shì 显示 chū lái 出来 yī tuán luàn má 一团乱麻 — — yīn wèi 因为 tā 它 duì zhǎng 对长 xiāo xī 消息 de 的 M a r k d o w n Markdown xuàn rǎn 渲染 hěn chà 很差 ， gé shì 格式 quán luàn 全乱 le 了 ， ér qiě 而且 gǔn dòng 滚动 qǐ lái 起来 yě 也 hěn 很 nán shòu 难受 。
wǒ 我 dì yī 第一 fǎn yīng 反应 shì 是 ràng 让 AI AI bǎ 把 xiāo xī 消息 chāi chéng 拆成 jǐ duàn 几段 fā 发 。 dàn shì 但试 le 了 zhī hòu 之后 fā xiàn 发现 tǐ yàn 体验 yě 也 bù hǎo 不好 ， jǐ tiáo 几条 xiāo xī 消息 shuā píng 刷屏 ， ér qiě 而且 shàng xià wén 上下文 bèi 被 dǎ duàn 打断 le 了 。
hòu lái 后来 wǒ 我 xiǎng dào 想到 yí gè 一个 bàn fǎ 办法 ： rú guǒ 如果 huí fù 回复 chāo guò 超过 1 0 0 0 1000 zì 字 ， jiù 就 zì dòng 自动 dǎ bāo 打包 chéng 成 . t x t txt wén jiàn 文件 fā sòng 发送 。
zhè yàng 这样 yòng hù 用户 shōu dào 收到 de 的 shì 是 yí gè 一个 wén jiàn 文件 ， diǎn kāi 点开 jiù 就 néng 能 kàn 看 wán zhěng 完整 nèi róng 内容 ， pái bǎn 排版 yě 也 bù huì 不会 luàn 乱 。 ér qiě 而且 wén jiàn 文件 kě yǐ 可以 bǎo cún 保存 、 kě yǐ 可以 zhuǎn fā 转发 ， bǐ 比 yī duī 一堆 xiāo xī 消息 shí yòng 实用 duō 多 le 了 。
zhè gè 这个 gǎi dòng 改动 cóng jì shù shàng 从技术上 kàn 看 hěn 很 jiǎn dān 简单 ， jiù shì 就是 jiā 加 yí gè 一个 zì shù 字数 pàn duàn 判断 hé 和 wén jiàn 文件 shēng chéng 生成 de 的 luó jí 逻辑 。 dàn 但 zhè 这 shì 是 yí gè 一个 chǎn pǐn 产品 jué cè 决策 ， bú shì 不是 jì shù 技术 jué cè 决策 。 AI AI bù huì 不会 zhǔ dòng 主动 gào sù 告诉 nǐ 你 「 xiāo xī 消息 tài 太 zhǎng 长 tǐ yàn 体验 bù hǎo 不好 」 ， yīn wèi 因为 tā 它 bù 不 zhī dào 知道 zhè gè 这个 liáo tiān 聊天 ruǎn jiàn 软件
zhè zhǒng 这种 xì jié 细节 ， zhǐ yǒu 只有 nǐ 你 zì jǐ 自己 yòng guò 用过 、 cǎi 踩 guò 过 kēng 坑 ， cái 才 huì 会 xiǎng dào 想到 yào 要 yōu huà 优化 。 yòng hù 用户 tǐ yàn 体验 de 的 tí shēng 提升 ， wǎng wǎng 往往 jiù 就 cáng 藏 zài 在 zhè xiē 这些 「 xiǎo 小 」 jué cè 决策 lǐ 里 。
shè jì 设计 3 3 ： ān quán 安全 wèn tí 问题 zěn me 怎么 xiǎng 想 ？
zhè shì 这是 wǒ huā 我花 shí jiān 时间 zuì duō 最多 de 的 yí gè 一个 shè jì 设计 。
wǒ 我 de 的 B o t Bot yǒu 有 yí gè 一个 hé xīn 核心 néng lì 能力 ： tā 它 kě yǐ 可以 dú xiě 读写 fú wù qì 服务器 shàng 上 de 的 wén jiàn 文件 。 zhè 这 shì 是 tā 它 de 的 jià zhí 价值 suǒ zài 所在 ， dàn 但 yě 也 shì 是 zuì dà 最大 de 的 fēng xiǎn 风险 。
rú guǒ 如果 AI AI chū 出 b u g bug ， huì 会 bù huì 不会 bǎ 把 wǒ 我 fú wù qì 服务器 shàng 上 de 的 zhòng yào wén jiàn 重要文件 shān 删 le 了 ？
rú guǒ 如果 yòng hù 用户 A A néng 能 fǎng wèn 访问 yòng hù 用户 B B de 的 wén jiàn 文件 zěn me bàn 怎么办 ？
rú guǒ 如果 yǒu rén 有人 tōng guò 通过 B o t Bot zhí xíng 执行 è yì 恶意 mìng lìng 命令 zěn me bàn 怎么办 ？
zhè xiē 这些 wèn tí 问题 AI AI bù huì 不会 zhǔ dòng 主动 bāng 帮 nǐ 你 xiǎng 想 ， yīn wèi 因为 tā 它 zhǐ 只 fù zé 负责 shí xiàn 实现 nǐ 你 tí chū 提出 de 的 gōng néng 功能 。 ān quán 安全 shì 是 nǐ 你 zì jǐ 自己 de 的 zé rèn 责任 。
xiǎng 想 qīng chǔ 清楚 fēng xiǎn 风险 zhī hòu 之后 ， wǒ 我 zuò 做 le 了 jǐ gè 几个 jué cè 决策 ：
jìn yòng 禁用 b a s h bash zhí xíng 执行 ： Claude Claude A g e n t Agent S D K SDK mò rèn 默认 kě yǐ 可以 zhí xíng 执行 rèn hé 任何 xì tǒng mìng lìng 系统命令 ， zhè tài wēi 这太危
[ C o n t e n t Content t r u n c a t e d truncated — f i r s t first 1 0 10 , 0 0 0 000 c h a r a c t e r s characters s h o w n shown ]