安装配置
本文档介绍 360disk CLI 工具的安装方式和鉴权配置。
更新时间：2026-03-24
安装方式
npm 全局安装（推荐）
npm install -g @aicloud360/mcp-server-disk
安装后即可直接使用：
360disk --version
360disk --help
npx 免安装使用
无需安装，直接通过 npx 运行：
npx -y -p @aicloud360/mcp-server-disk@latest 360disk dir ls /
提示
npx 方式每次运行会检查包版本，首次使用会下载依赖。适合临时使用或 CI/CD 环境。
系统要求
| 要求 | 说明 |
|---|---|
| Node.js | >= 18.0.0 |
| npm | >= 8.0.0 |
| 操作系统 | macOS / Linux / Windows |
验证安装
# 查看版本号
360disk --version
# 查看帮助
360disk --help
# 查看子命令帮助
360disk file --help
360disk file search --help
鉴权配置
使用 360disk 需要 API Key 进行身份认证。
获取 API Key
访问 360 AI 云盘开放平台 按指引获取 API Key。
API Key 格式为 yunpan_ 开头的字符串。
配置方式
360disk 支持三种鉴权方式，按优先级从高到低：
方式一：命令行参数（最高优先级）
360disk --api-key yunpan_xxx dir ls /
适用于临时使用或需要切换不同账号的场景。
方式二：环境变量
# 单次使用
API_KEY=yunpan_xxx 360disk dir ls /
# 或导出为环境变量（当前终端会话有效）
export API_KEY=yunpan_xxx
360disk dir ls /
适用于 CI/CD 环境或脚本中使用。
方式三：本地配置文件（持久化）
# 登录并保存到 ~/.360disk/config.json
360disk auth login --api-key yunpan_xxx
登录后，后续所有命令自动使用已保存的 API Key，无需重复配置。
# 查看当前鉴权状态
360disk auth whoami
# 退出登录（清除本地配置）
360disk auth logout
注意
- 本地配置文件存储路径：
~/.360disk/config.json - 该文件仅在
auth login时创建，安装时不会自动生成 - 请勿将配置文件提交到版本控制系统
鉴权优先级
当多种方式同时存在时，按以下优先级使用：
1. --api-key 命令行参数 （最高优先级）
2. API_KEY 环境变量
3. ~/.360disk/config.json （最低优先级）
环境配置
除 API Key 外，还支持以下环境配置：
# 登录到测试环境
360disk auth login --api-key yunpan_xxx --env test
# 指定子渠道
360disk auth login --api-key yunpan_xxx --sub-channel custom
或通过环境变量：
export API_KEY=yunpan_xxx
export ECS_ENV=test # 环境：prod（默认）/ test
export SUB_CHANNEL=open # 子渠道（默认 open）
全局选项
所有命令均支持以下全局选项：
| 选项 | 说明 | 默认值 |
|---|---|---|
--api-key <key> | API 密钥（覆盖本地配置和环境变量） | — |
--env <env> | 环境：prod / test | prod |
--sub-channel <channel> | 子渠道标识 | open |
--format <type> | 输出格式：json / text | json |
--quiet | 静默模式，仅输出 result 数据 | false |
--timeout <ms> | 请求超时时间（毫秒） | 30000 |
--retries <n> | 失败重试次数（指数退避） | 0 |
--help | 显示帮助信息 | — |
--version | 显示版本号 | — |
全局选项位置
全局选项需放在子命令之前：
# ✅ 正确
360disk --format text dir ls /
360disk --quiet --timeout 60000 file search "报告"
# ❌ 错误（全局选项不能放在子命令之后）
360disk dir ls / --format text