Claude Code 自定义工具:创建专属工作小工具
让 Claude Code 帮你写一个专属小工具,自动完成某个固定的工作任务。本文用具体例子教你如何让 AI 为你创造工具,而不是使用现成工具。
到目前为止,我们都是在用 Claude Code 对话来完成任务。但 Claude Code 还有一个更强大的能力:帮你创建一个小工具,让这个工具自动完成你指定的工作。
这意味着你不需要每次都告诉 AI 该怎么做,工具会按照固定的规则自动执行。
什么是”自定义工具”?
简单说,就是一个小程序,专门用来完成某个固定的任务。
示例:
- 一个工具:每次收到销售数据的 Excel,自动生成分析报告
- 一个工具:自动整理文件夹里的文件,按日期重命名
- 一个工具:把一个文本文件拆分成多个小文件
这些工具都是 Claude Code 帮你写的,你不需要懂编程,只需要告诉 AI 你想要这个工具做什么。
第一步:想清楚你的工具要做什么
在请 AI 帮你写工具之前,先回答这些问题:
- 输入是什么?(工具处理什么数据?文件?表格?文本?)
- 输出是什么?(工具产生什么结果?新文件?报告?修改后的文件?)
- 处理规则是什么?(工具按什么规则工作?)
- 有什么限制条件?(只处理特定格式的文件?按特定条件筛选?)
示例:月度报告自动生成工具
输入:一个包含销售数据的 CSV 文件
输出:一份 Markdown 格式的月度报告文件
处理规则:
- 计算总销售额、各区域销售额、环比变化
- 找出前三名和后三名区域
- 生成一段分析文字
限制条件:CSV 文件的列名是固定的(区域、月份、销售额、目标)
第二步:请 Claude Code 创建工具
用这个提示词格式:
请帮我创建一个 Python 脚本(工具),功能如下:
工具名称:月度销售报告生成器
输入:一个 CSV 文件,包含以下列:
- 区域(字符串)
- 月份(格式:YYYY-MM)
- 销售额(数字,单位:万元)
- 目标额(数字,单位:万元)
输出:一个 Markdown 文件,内容包括:
1. 报告标题(根据月份自动生成)
2. 总体概况(总销售额、目标完成率)
3. 各区域数据表格(排名 + 完成率)
4. 前三名和后三名区域
5. 一段 200 字的分析摘要
运行方式:命令行运行,例如:
python report.py --input data.csv --output report.md
请同时告诉我如何安装运行环境(我没有编程基础)
第三步:安装并运行工具
AI 会给你代码和安装说明,通常步骤是:
安装 Python(如果还没有):
- 访问 python.org,下载 Python 3.x
- 安装时勾选”Add to PATH”选项
- 安装完成
安装依赖包: AI 会告诉你需要运行什么命令,比如:
pip install pandas openpyxl
在命令行(终端)里输入这个命令,按 Enter。
运行工具: 按 AI 给的说明运行,比如:
python report.py --input 三月数据.csv --output 三月报告.md
几个实用的工具创建示例
示例一:文件批量重命名工具
帮我写一个文件批量重命名的 Python 脚本:
功能:把一个文件夹里所有的文件按规则重命名
重命名规则:
- 找出文件名中的日期(格式:可能是 20250101 或 2025-01-01 或 25.1.1)
- 统一改成 2025-01-01 格式
- 如果文件名中没有日期,保持原名不变
使用方法:把脚本放在要处理的文件夹里,双击运行
(不需要命令行参数,我不熟悉命令行)
示例二:邮件模板填充工具
帮我写一个 Python 脚本,功能是:
读取两个文件:
1. template.txt:邮件模板(其中有 {姓名}、{日期}、{金额} 等占位符)
2. data.csv:客户数据(包含姓名、日期、金额列)
根据每行数据,把模板中的占位符替换成实际值,
生成多个邮件文件(每个客户一个),
文件名格式:邮件_{姓名}_{日期}.txt
运行方式:python fill_emails.py
示例三:内容统计分析工具
帮我写一个工具,分析一个文件夹里所有 .txt 文件的内容:
统计内容:
- 每个文件的字数
- 出现频率最高的 20 个词(过滤掉"的、了、是"等虚词)
- 所有文件的总字数
- 最长和最短的文件
输出:生成一个汇总报告(result.txt)
让工具更易用:图形界面
如果你觉得命令行不习惯,可以让 AI 给你的工具加一个简单的图形界面:
在你刚才写的脚本基础上,加一个简单的图形界面,
让我可以:
1. 用按钮选择输入文件
2. 用按钮选择输出位置
3. 点击"开始处理"按钮执行
4. 看到处理进度和结果
我不会命令行,希望双击就能打开一个窗口操作
工具出错了怎么办?
遇到错误时,把错误信息完整复制给 AI:
我运行了你写的脚本,遇到了以下错误,请帮我修复:
错误信息:
[完整复制错误信息]
我的文件结构是:
[描述你的文件在哪里]
AI 会告诉你是什么问题,怎么修复。
常见问题
Q:我不会编程,这些工具我真的能用吗? A:可以。你不需要理解代码,只需要会运行它。就像你不需要懂汽车原理,但能开车。如果遇到问题,把错误信息给 AI,它会帮你解决。
Q:AI 写的工具安全吗?会不会删我的文件? A:建议:让 AI 写工具时,要求它”不要删除任何原始文件,如果需要修改,先复制一份”。另外,第一次运行时用少量测试文件先试试。
Q:工具只能用一次吗? A:不是,工具可以反复使用。以后每次有新的数据,运行一次工具就能得到结果。这就是工具的价值。
创建了自定义工具之后,下一节我们来学习如何打造一个专属的 AI 助手,让它记住你的工作背景和偏好。
标记本节教程为已读
记录您的学习进度,方便后续查看。