适用于 Claude Code 的 Aktar
从 Claude Code 上传文件到你自己的存储桶
有了 Aktar 插件,Claude Code 可以把截图、构建产物或 PDF 上传到你自己的 S3、Cloudflare R2 或 Backblaze B2 存储桶,并把链接或 Markdown 交给你。它在你电脑上的 Aktar 应用旁边运行,所以你的存储密钥始终不会离开 Aktar。
上传 docs/images/settings.png,并把它加到 README 的 Settings 部分下面。
upload_file{ "path": "docs/images/settings.png" }已上传,并把图片加到了 README 中:
https://files.example.com/2026/11/settings.png你可以这样说
-
用于 README 或 PR 的图片
“把 docs/images 里的新截图加到 PR 描述里。”
Claude 上传图片并写好 Markdown。WebP 转换和位置信息移除由 Aktar 按上传目标的设置完成。
工具:
upload_file -
分享构建产物
“把 dist 文件夹打成 zip,给我一个可以发给测试同事的链接。”
它在你的项目里生成文件并上传。如果没有指定上传目标,Aktar 会按文件类型选择,就像把文件拖到菜单栏一样。
工具:
upload_file -
找回以前的链接
“我上周上传的那个 logo 的链接是什么?”
它按名称和日期搜索 Aktar 的上传历史,包括你在应用里上传的文件。
工具:
search_uploads
设置步骤
安装 Mac 或 Windows 版 Aktar,并添加一个上传目标(你的存储桶)。在 Aktar 中打开设置 → 集成,开启允许本地连接并复制令牌,然后把它粘贴到这条命令中。需要 Node.js 18 或更高版本。
npx @getaktar/cli login在 Claude Code 中添加 Aktar 插件市场并安装插件。之后它在每个项目中都会启用。
在 Claude Code 中/plugin marketplace add getaktar/agent-plugins /plugin install aktar@aktar在你的项目文件夹中启动 Claude Code 并运行
/mcp:aktar应显示为已连接。让它给个链接,Claude 就会从这个文件夹上传文件。
它能碰什么
文件只来自服务器可以使用的文件夹,SSH 密钥、.env 文件和云服务凭据等机密永远不会被上传。替换和删除上传的文件默认关闭,除非你自己开启。你的存储密钥留在 Aktar 中:智能体拿到的只是文件名和链接,任何内容都不会发给我们。上传的文件对任何拿到链接的人都是公开的,所以只让它上传你想分享的内容。
常见问题
插件会拿到我的存储密钥吗?
不会。你的密钥留在 Aktar 应用中。插件只使用 npx @getaktar/cli login 保存在只有你能读取的文件中的本地令牌,并在 127.0.0.1 上与 Aktar 通信。
Claude 上传前会先询问吗?
会。除非你允许了某个插件工具,否则 Claude Code 在调用它之前会先询问。搜索和列出只是查看,上传会修改你的存储桶。
它会上传到哪个存储桶?
和拖到 Aktar 菜单栏时一样:用于与文件类型匹配的上传目标,或当前选中的那个。在请求中指明上传目标,Claude 就会使用它。
支持 Windows 吗?
支持,需要 Windows 版 Aktar 0.11.0 或更高版本。在 Mac 上需要 Mac 版 Aktar 0.18.0 或更高版本。