用 Claude Code 桌面版以 vibe coding 在 30 分钟内做出资料催收工具
Claude Codeを使ったバイブコーディングで30分で業務アプリを作ってみよう | gihyo.jp
作者用 Claude Code 桌面版以 vibe coding 方式,在约 30 分钟内做出一个资料催收工具:读取顾客名单和提交情况两份 Excel,先列出未提交清单等人工确认,再输出催收邮件草稿,并注册到 Windows 任务计划程序每周一 8 点自动运行。文中把需求写进 CLAUDE.md,全程使用手动批准模式,并说明涉及真实客户个人数据前应先咨询工程师和法务。
正文 · AI 翻译
第1回中,我们看到了Claude的新功能扩大了“自己能做的范围”,同时也看到了仍然需要交给工程师处理的领域。
这次更进一步,直接制作业务应用本身。使用的是Claude Code。它是用于编写程序的AI代理,但不使用终端。打开桌面版,用日语写下需求,让它制作,再用测试数据运行起来,整个过程在30分钟内完成。
这次采用名为vibe coding的方法来创建应用。不是自己一行一行地写代码,而是用日语传达目的和条件,让AI实现,同时进行确认和修正的制作方式。
另外,这次的题材并不是随意选定的。而是从“什么是能在现场长期使用的业务应用”这一角度选出的。其原因将在后半部分说明,请务必读到最后。
1|用30分钟试着制作资料回收的催收工具
本回制作的东西・前提・所需时间
制作的东西:根据客户名单(Excel)和资料的提交情况,筛选出未提交的资料,并按客户生成催收邮件草稿的工具。执行前先显示“向谁・催收什么”的列表,经人批准后再输出草稿
前提:Claude的桌面应用(Windows版。Mac请参照注释)以及安装了Python的PC(如果未安装,请参照文末的“附录”)。不使用终端。笔者使用Max套餐进行了尝试,但只要是可以使用Claude Code的套餐,结果相同。画面为2026年10月时点的内容
所需时间:约30分钟(在笔者的环境中,从准备工作文件夹到写出草稿用了25分钟,加上注册定期执行共约30分钟。其中等待Claude生成的时间约10分钟。由于要求批准的次数较多,请留出余量)
使用的数据:全部为虚构。将表1、表2粘贴到Excel中使用
在进入步骤之前,先用下图把握完成后的整体情况。
上面一段是“制作时”。人用日语将需求写入CLAUDE.md,Claude Code读取它,展示计划,获得批准,制作催收工具.py。
下面一段是“运行时”,运行的只有Python程序。读取客户名单和提交情况两个Excel,首先显示“向谁・催收什么”的列表并停止。人批准后,写出未提交列表和催收邮件草稿。每周的自动执行(步骤4)由任务计划程序启动到这一“确认”为止。发送邮件始终由人完成。
右下角的“将来的扩展”将在之后的“打磨”中提及。
图1 本次制作的东西的整体情况。上段为“制作时”(人 → CLAUDE.md → Claude Code → 催收工具.py),下段为“运行时”(2个Excel → 确认 → 人批准 → 写出 → 人阅读后发送)。任务计划程序只启动确认,右下角显示将来的扩展(通过API连接到电子表格・聊天工具)
步骤1 打开Claude Code的桌面版,决定工作文件夹
打开Claude的桌面应用,按下侧边栏上方的“ ”图标,就会切换到Claude Code的画面。从“选择环境”中选择“新环境”,指定名称(这里为“催收工具”)和工作文件夹,然后按下“创建环境”。事先创建一个空文件夹。这里将成为该工具的存放位置。首次使用的文件夹会询问“是否信任此工作区?”,请按下“信任工作区”。
图2 在“新环境”中输入名称和工作文件夹的状态
决定文件夹后,确认批准模式。如果画面下方显示“自动”,请按下那里并切换为“手动(更改前始终确认)”。“自动”是Claude自行判断权限的模式,“手动”是在创建・改写文件・执行命令之前,每次都等待我们批准的模式。
另外,最初请设为“手动”。在能够读懂会被做什么之前,不放宽是诀窍。
图3 批准模式的菜单“权限・此会话”
步骤2 在CLAUDE.md中写需求
在工作文件夹中创建一个名为CLAUDE.md的文件。这是Claude Code最先读取的“此文件夹的规则”。在这里写明做什么、何时、对谁、自动做到什么程度、在哪里由人确认。
在Claude Code的输入栏中输入“请创建CLAUDE.md。内容如下。”,接着粘贴以下内容并发送。
# 资料回收催收工具 ## 目的 查看每位客户的资料提交情况,找出未提交的资料,制作催收邮件的草稿。 ## 输入 - 客户名单.xlsx(列:客户ID、公司名、负责人姓名、邮箱地址、顾问开始年份) - 提交情况.xlsx(列:客户ID、资料名、期限、提交日。提交日为空则视为未提交) ## 输出 - 未提交列表.xlsx(按客户列出未提交的资料名和期限) - 在催收邮件/ 文件夹中,为每位客户生成邮件草稿(文本文件) ## 规则 - 执行前,显示“向谁・催收什么”的列表,等待批准 - 不发送邮件。只制作草稿 - 超过期限的和未到期限的,改变文面(超过的用礼貌措辞,未到的用轻松措辞) - 客户名单和提交情况只读取。不改写 - 最后报告原文件的行数和处理的行数
发送后,会出现“是否允许Claude写入CLAUDE.md?”的批准卡片,可以看到即将写入的内容。这里有一点需要注意。黑色的大按钮是“始终允许”。按下它,同类操作以后将不再确认直接进行(范围・期限因操作类型而异)。在习惯之前,请按按钮右端的“∨”并选择“仅允许一次”。
图4 请求写入CLAUDE.md的批准卡片。可以看到即将写入的内容
这个CLAUDE.md是贯穿整个连载最重要的东西。用日语写好需求后,Claude Code每次打开会话都会读取它,并在之后的交流中参照这一前提。
做好的程序不读取CLAUDE.md也能运行,但在向Claude Code请求在此文件夹中做某事时(修改文面、增加列、查看故障),即使在新会话中也一定会先共享CLAUDE.md中写好的前提再进行作业。“不发送邮件”“不改写原文件”这样的禁止事项,在这里用日语写明。
不过,写下来并不一定就会被遵守。让程序也把“仅确认”和“写出”分开制作,通过执行前的列表和批准(步骤3),形成人可以阻止的形式。
步骤3 让它制作,并用测试数据运行
准备测试用数据。将表1和表2粘贴到Excel中,分别保存为“客户名单.xlsx”“提交情况.xlsx”到工作文件夹。
表1 客户名单(虚构)
客户ID 公司名 负责人姓名 邮箱地址 顾问开始年份
C001 青叶工务店 负责人A a@example.com 2021
C002 港食品 负责人B b@example.com 2023
C003 樱花美容室 负责人C c@example.com 2024
C001 工资台账 2026/11/05 2026/10/30
C002 10月考勤簿 2026/11/05
C002 雇佣合同(新员工2名) 2026/10/31
C003 10月考勤簿 2026/11/05 2026/11/02
(提交日为空表示未提交)
向Claude Code如下指示。
请按照CLAUDE.md制作工具。制作前,请展示要创建哪些文件的计划。
Claude Code首先会确认工作文件夹中的内容以及是否安装了Python。此时,即使是只读命令也会请求批准(如果只是读取文件夹中的文件则不会被询问),因此查看内容后点击“仅允许一次”。随后它会给出计划。“催促工具.py(本体)”“未提交列表.xlsx(运行后生成)”“催促邮件/ 下的草稿”这些要创建的内容会以表格形式呈现,并说明运行方式分为“先仅确认,获得批准后再写出”两个阶段。最后它会问“可以按这个计划开始制作吗?”,此时点击“按此计划制作”。
图5 Claude Code给出的计划。要创建的文件表格
在笔者的环境中,Claude Code在这里指出了一点:“表2中的期限都在今天之后,因此以今天为基准不会出现任何过期项。”
在此基础上,它做成了可以指定判定基准日的形式。后面出现的未提交列表和催促邮件草稿的画面,都是以本文发布日11月3日为基准日运行的结果。
批准后,程序就会被创建。写入本体时会弹出批准卡片,此外Claude Code为了不弄脏正式文件夹,会在临时文件夹的副本中试运行文面和异常数据的处理。此时也会持续请求命令批准,因此要一边查看内容一边点击“仅允许一次”。在查看其他窗口时,也可以通过Windows通知进行批准。至此批准次数约为10次。
测试结束后,会按照CLAUDE.md中写好的规则推进。在正式文件夹中只运行确认,显示“向谁・催促什么”的列表,并等待批准“是否按此内容进行正式写出?”。
图6 执行前显示的催促列表。列出客户・收件人・文面类型・催促的资料
查看列表后,如果有异常行就让它修正。例如,明明未到期却变成了“已过期”的文面,就告诉它“C001的考勤簿还未到期,请改成语气较轻的文面”。点击“写出”,批准写出命令后,就会生成未提交列表.xlsx和每个客户的草稿。
图7 用Excel打开做好的未提交列表.xlsx。在“状态”列中显示已过期和未到期
图8 催促邮件草稿之一。将已过期的资料和即将到期的资料汇总在一封邮件中的礼貌文面
草稿末尾是“(请在此处插入签名)”的占位符。如果有固定的签名,只要写在CLAUDE.md中它就会填入。
最后,Claude Code会报告件数。在笔者的环境中是“客户名单3条、提交情况5条。明细为已提交2条、未提交并列入列表的3条、排除0条,合计与5条一致”“需要催促的是2家公司,草稿2封”。同时,它还通过根据文件内容计算出的值,确认了原来的两个Excel在写出前后没有发生变化。
图9 件数报告
步骤4 改为定期执行
让它每周一早上自动运行。这也向Claude Code发出指示。
请将此工具注册到Windows任务计划程序中,使其每周一早上8点自动执行。注册之前,请展示要注册的内容。
Claude Code会以表格形式展示任务名称・执行的命令・工作文件夹・日期时间・执行用户・PC关闭时的处理方式。
然后,这里出现了让笔者佩服的指出:“CLAUDE.md中‘等待批准’的规则与无人自动执行相冲突。”选项有“仅确认自动化”和“连写出也自动化”两种,这次选择前者。
也就是只把周一早上生成列表的部分自动化,写出则要等人批准后再进行。每周运行的是生成列表的Python程序。并不是Claude Code本身每周运行。
批准注册命令后,任务就会被注册。注册后,请打开任务计划程序,亲眼确认已注册的任务。
图10 Claude Code显示的注册内容表,以及“自动执行要选哪一种形式?”的提问
图11 注册到任务计划程序中的任务。触发器为“每周一8:00启动”
到这里大约30分钟。
与聊天工具和电子表格连接起来,进一步打磨吧
跑通之后,试着扩展数据的入口和出口。例如,把未提交列表写出到Google电子表格,再把催促进的草稿投到聊天工具里。Claude有一套叫MCP(Model Context Protocol)的机制,可以让Claude直接操作电子表格和聊天工具。在本书第10章中,介绍了用MCP连接的手顺。
不过,如果把它当作每周运行的业务应用来考虑,笔者建议不要用MCP,而是用API直接连接。理由如下。
注意事项 从这里开始属于工程师的领域
这次的ツール,落在连载第1回划线表的左列范围内。由自己一个人使用,用虚构数据运行,即使坏了也能回到手工操作,只要读CLAUDE.md就能说明它在做什么。
在用真实客户数据运行之前,请确认是否踏入了右列。客户名单中包含个人信息(负责人姓名、邮箱地址)。只能使用组织规则允许发送给Claude的数据。仅仅把负责人姓名和邮箱地址替换成客户ID之类的符号,只要还能与其他信息对照,就仍然是个人信息。
如果在这3点中的任何一点上犹豫,就到了该咨询工程师(公司内的开发部门,或合作方的系统公司)的阶段。涉及个人信息时,也要咨询信息系统和法务负责人。咨询时,请直接出示CLAUDE.md。因为需求是用日语写的,沟通会进展得很快。
跨行业反复出现的5种类型
资料回收的催促,并不是随手选来的题材。笔者把日本国内主要的200个行业・业态,按照“什么业务最耗时”“其中AI能减少的部分在哪里”“人保留的判断是什么”这3个轴进行了整理。即使行业不同,也会反复出现相同形态的业务,可以归纳为以下5种类型。
表3 跨行业反复出现的业务应用的5种类型
类型 内容 示例
催促・回收型 找出未提交的人・未付款的人,制作催促进的草稿 社劳士和税理士的资料回收、建筑业的发票回收
跟进型 对曾经有过接触的对象,以适当的间隔给出下一步行动 汽车销售店的检修通知、房地产看房后的跟进
草稿型 根据材料起草定型文档・报告 护理记录、日报、会议纪要
一次应对型 对咨询进行分类,定型的直接回复,例外的转交给人 牙科的预约变更、邮购的配送咨询
检查型 机械地检查文件和数据中的遗漏・矛盾 社劳士的申报文件、餐饮店的订货表
5种类型的共同点是“AI不做最终决定”。例如,催促邮件只做到草稿,发送由人来做。咨询只做到分类和定型回复,例外由人处理。这个分界线,与第1回划线中所说的“即使坏了也能回到手工操作”的范围重合。
在选择自己工作中接下来要做什么时,这5种类型也会成为基准。反过来,做了却不会被使用的应用,有着只有本人能用(无法交接)、例外一来就停住、数据的入口仍然是手工操作(结果还是留下转录)这些共同点。
这次制作的ツール之所以把需求留在CLAUDE.md中、把例外转交给人、做成直接读取Excel的形式,就是为了避免这些问题。
非工程师也能做应用之后,发生了什么变化
明白了这些类型,工作的推进方式也会改变。
以前是先听取客户的业务,然后再考虑要做什么。现在则是只要知道行业就能建立假设,先用测试数据把应用做出来,给对方看正在运行的东西之后再问。“贵公司的这个催促基准是怎样的?”这样在运行中的东西面前提问,答案会更具体。
我认为,这也是工程师一侧正在发生的变化。AI让理解业务变得更快,因此“业务侧的人靠近开发”的同时,“工程师靠近业务”也在发生。
结语
这次,我们用Claude Code通过vibe coding在30分钟内制作了一个实际可用的业务应用。同时也解说了可以输入的数据的划分方法。
下次是关于让做好的ツール持续使用下去的“记忆”和“守护”机制。Claude Code在新会话中不会继承上一次的对话。我们将一边实际制作,一边介绍把规则和判断理由留在文件夹中的文件里、并可靠地传递给下一次会话的方法。
注意:没有安装Python时
步骤3的程序用Python运行。如果你的PC上没有安装Python,请拜托Claude Code:“我想安装Python。请展示安装方法。”在Windows上,如果环境可以使用winget,它会引导你用winget安装的方法;如果不能使用,则会引导你使用Python官方安装程序的方法(winget可在Windows 11和较新的Windows 10上使用,但在公司管理的终端等设备上有时无法使用)。查看内容并批准后,Claude Code就会继续推进。如果没有读写Excel的组件(openpyxl),Claude Code也会在制作前察觉到,并引导安装方法。在公司PC上,软件安装请遵循信息系统的流程。