360 AI 云盘 CLI

@aicloud360/360-ai-cloud-disk-cli 是 360 AI 云盘的官方命令行工具（命令名：360disk），支持文件上传下载、目录管理、搜索分享、自动备份等核心云盘操作，输出结构化 JSON，适合终端用户与 AI Agent 直接调用。

安装

npm install -g @aicloud360/360-ai-cloud-disk-cli

或通过 npx 零安装直接运行：

npx -y -p @aicloud360/360-ai-cloud-disk-cli@latest 360disk --help

快速开始

1. 登录

API Key 登录

360disk auth login --api-key <YOUR_API_KEY>

微信扫码登录

360disk auth login-wechat

扫码成功后，凭证自动保存至 ~/.360disk/config.json，后续命令无需重复传入 Key。

2. 常用示例

# 查看当前用户信息
360disk user info

# 浏览云盘目录
360disk dir ls /

# 搜索文件
360disk file search "季度报告"

# 上传本地文件
360disk file upload ./report.pdf --dest /文档/

# 下载文件到本地
360disk file download <nid> --dir ./downloads/

# 生成分享链接
360disk file share /文档/report.pdf

# 将命令行输出直接保存到云盘
date | 360disk file save --stdin --dest /日志/ --filename "timestamp.txt"

# 备份本地目录到云盘（增量）
360disk claw-backup --source ~/projects --dest /backup/projects/

# 启用目录自动备份监听
360disk claw-auto-backup enable --source-dir ~/projects --claw-name my-backup

命令组概览

| 命令组 | 子命令 | 说明 | |---|---|---| | auth | login / login-wechat / whoami / logout | 鉴权管理 | | user | info | 用户信息与容量 | | dir | ls / mkdir | 目录操作 | | file | mv / rename / rm / search / share / url / upload / download / save / append / exists 等 | 文件管理 | | claw-backup | --source / --dest | 本地目录备份到云盘 | | claw-restore | --remote / --target | 云盘目录恢复到本地 | | claw-auto-backup | enable / disable / status | 自动备份监听 | | completion | install / uninstall / script | Shell 自动补全 |

主要特性

• 结构化输出：所有命令默认返回 JSON（含 success / result / meta），支持 --format text 与 --quiet 模式
• 管道支持：支持 stdin 输入与批量操作，可与 jq 等工具组合
• 增量备份：claw-backup 内置本地数据库，默认只上传变更文件
• 超时重试：全局 --timeout / --retries 选项，适合网络不稳定环境

AI Agent 集成

搭配 360-ai-cloud-disk-cli-skill 使用，可让 Claude Code、Cursor、OpenCode 等 AI 编码工具直接具备云盘读写能力。

相关链接

• 360 AI 云盘开放平台
• CLI Skill（AI Agent 集成）
• 问题反馈

许可证

Apache-2.0