用途:本技能是使用 Modal 云平台的基础指导,Modal 面向 AI 工作负载,提供高度可扩展的无服务器计算(含 GPU),配置极少。
主要能力与用法:使用 CLI 或运行依赖 modal 库的代码需要联网和授权令牌,Modal 没有本地开发模式。CLI 可运行或部署代码、管理资源、观察运行中的 App,运行 modal --help 查看全部命令,modal [command] --help 查看单命令详情,许多命令支持 --json 便于解析。CLI 属于 Python SDK,在 Python 运行时执行,可按需用 uv run 前缀,或在 Python 项目外通过 uvx 独立使用。不要以 TTY/PTY 运行 CLI 命令。
文档:官方文档见 https://modal.com/llms.txt,含全部公开文档标题与 URL,用 .md 扩展名获取纯文本;https://modal.com/llms-full.txt 聚合全部文档但体积很大,不要整体读入上下文。通过 CLI 安装本技能时会在 references/ 下安装本地文档(除非传 --no-docs),包括 api/ 与 guide/、examples/。
版本与更新:用 modal changelog --since [DATE]、--since [VERSION]、--newer 了解变更,输出可能很长,不要整体载入。用 modal --version 查看 SDK 版本;若技能元数据版本与之一致性不符,运行 modal skills update 更新,位于 .claude/ 目录时加 --claude,位于主目录时加 --global。
异步与其他语言:异步 Python 使用 .aio() 接口(如 await modal.Sandbox.create.aio(...)、await modal.Function.remote.aio(...))。Python 是目前唯一的 Modal Functions 运行时语言,另有 JavaScript(TypeScript)和 Go SDK,成熟度较低,主要覆盖创建和交互 Sandbox 以及调用已部署的 Modal Functions,主要通过 GitHub 示例文档化。
限制:无本地开发模式;CLI 与库需联网和授权令牌;Go/JS SDK 功能可能缺失。