安装 CLI

Almirant CLI 可让你通过几个命令将任何仓库连接到项目。它会自动创建 .mcp.json 文件、复制 Skill 模板并配置身份验证，无需手动复制粘贴 keys。

要求

• 已安装 Node.js 18+
• Almirant 账户：创建账户
• 已创建项目：第一个项目

第 1 步：安装 CLI

全局安装 CLI：

npm i -g almirant

确认安装成功：

almirant --version

第 2 步：登录

通过浏览器验证账户：

almirant login

该命令会打开浏览器以完成 OAuth 流程。完成后，你的 API key 将安全地存储在 ~/.almirant/config.json 中。

信息

只需登录一次。凭据会在所有项目中自动复用。

第 3 步：关联仓库

前往仓库根目录并运行：

almirant link

CLI 将：

1. 使用上一步中存储的凭据
2. 显示你的项目供你选择
3. 生成具有正确配置的 .mcp.json 文件
4. 将 Skill 模板复制到 .agents/skills/
5. 可选地配置 shell（PATH）

信息

如果希望使用完整流程，而没有先运行 almirant login，请改用 almirant init。该命令会在一个流程中逐步引导你完成身份验证和配置。

第 4 步：验证连接

在项目目录中打开 Claude Code 并输入：

> Lista mis work items de Almirant

如果一切配置正确，Claude 将返回项目中的工作项。

下一步

仓库现已连接。继续阅读第一个 AI 工作流，了解如何通过 IDE 中的 AI 实现完整任务。

---

有关每个命令的更多细节，请参阅 CLI 参考。