CodePilotCodePilot

CLI 工具

管理系统 CLI 工具,让 Claude 自动识别并使用你电脑上的命令行能力。

CLI 工具

很多 AI 工作流需要配合命令行工具——用 FFmpeg 处理视频、用 jq 解析 JSON、用 ripgrep 搜索代码。CodePilot 的 CLI 工具功能帮你管理这些工具,并让 Claude 自动知道你的电脑上有什么可用。

为什么需要这个功能?

当你跟 Claude 说"帮我把这个视频转成 MP4",Claude 需要知道你的系统上是否安装了 FFmpeg。如果不知道,它只能给出通用建议;如果知道,它可以直接给你一条可以执行的命令。

CLI 工具功能做了三件事:

  1. 检测 — 自动扫描你系统上已安装的命令行工具
  2. 推荐 — 提供精选工具列表,一键安装
  3. 感知 — 在对话中自动告诉 Claude 你有哪些工具,让它给出更精准的回答

打开工具管理

点击左侧导航栏的 CLI Tools 图标(终端图标)进入管理页面。

页面分为两个区域:

  • 已安装 — 系统上检测到的工具,显示版本号和状态
  • 推荐 — 精选的常用 AI 工作流工具,可以直接安装

安装工具

在推荐区找到你需要的工具,点击 安装 按钮。

如果工具支持多种安装方式(如 Homebrew、npm),会先让你选择。安装过程中会实时显示终端日志,你可以看到完整的安装输出。

目前推荐的工具包括:

工具用途安装方式
FFmpeg音视频转码、剪辑、合并Homebrew
jqJSON 数据解析和转换Homebrew
ripgrep极速文本搜索(比 grep 快得多)Homebrew
yt-dlp视频下载Homebrew / pipx
pandoc文档格式转换(Markdown、Word、PDF 互转)Homebrew

查看工具详情

点击工具卡片上的 详情 按钮,可以看到:

  • 工具简介 — 这个工具能做什么
  • 适用场景 — 最常见的使用方式
  • 操作引导 — 从安装到上手的步骤
  • 示例提示词 — 可以直接复制到对话中使用的提示词

示例提示词是这个功能最实用的部分。比如 FFmpeg 的示例提示词:

"把 input.mov 转换成 MP4 格式,保持原始质量"

点击旁边的复制按钮或"发送到聊天"按钮,就可以直接用这个提示词开始对话。

AI 自动完善介绍

已安装的工具支持用 AI 生成更详细的介绍。点击工具卡片上的 自动完善 按钮,Claude 会根据工具的名称和用途生成一段中英双语的详细描述。

这个描述会保存在本地,下次打开时自动显示。

在对话中使用

自动感知(推荐)

安装好工具后,不需要做任何额外操作。CodePilot 会在每次对话时自动检测你的已安装工具,并在 system prompt 中告诉 Claude。

这意味着当你说:

"帮我把这个目录下所有的 .mov 文件转成 .mp4"

Claude 会知道你有 FFmpeg,直接给出可执行的命令,而不是先问你"是否安装了 FFmpeg"。

手动选择工具

如果你想明确告诉 Claude 使用某个特定工具,可以在聊天输入框的工具栏中点击 终端图标,打开 CLI 工具选择器。

选择一个工具后:

  • 如果输入框为空,会自动预填一段引导文字,比如"我想用 FFmpeg 工具完成:" — 你只需补充具体需求
  • 如果输入框已有内容,会在消息上附加一个工具标记,Claude 会优先使用这个工具来回答

最佳实践

描述需求而不是命令

不好的用法:

"运行 ffmpeg -i input.mov -c:v libx264 output.mp4"

好的用法:

"把 input.mov 转成 MP4,画质保持不变,文件尽量小"

让 Claude 来选择最优的参数组合。它比大多数人更了解 FFmpeg 的编码选项。

组合多个工具

CLI 工具之间可以组合使用。比如:

"从这个 YouTube 链接下载视频,然后裁剪前 30 秒,转成 GIF"

如果你安装了 yt-dlp 和 FFmpeg,Claude 会把它们串联起来,给你一个完整的工作流。

用示例提示词起步

不确定怎么用一个工具?打开它的详情页,从示例提示词开始。这些提示词覆盖了最常见的使用场景,是快速上手的好方法。