• 简体中文

    • HolyCrab CLI 快速开始

    选择一种安装方式：复制提示词到 Codex 或 Claude Code，或在终端执行安装命令。安装完成后，配置 API Key并在 Agent 中使用。

    开始前的准备

    • 一台 Windows、macOS 或 Linux 电脑，可以安装 Python 3.10 或更高版本。
    • HolyCrab 账号，以及同一台电脑上的 Codex；Claude Code 也以相同方式支持。

    一键安装

    打开安装 HolyCrab CLI，选择 一键安装，点击 复制提示词，粘贴到需要安装 CLI 的电脑上的 Codex 或 Claude Code。

    • Agent 会识别系统、检查依赖和已有安装，按需执行对应安装命令，再检查 CLI 和 Agent 接入状态。缺少依赖、权限或需要重启时，按提示处理。
    • 需要配置账号时，在本地终端运行 holycrab setup，只将 API Key 粘贴到隐藏输入处，不要发到 Agent 对话中。
    安装提示词
    安装 HolyCrab CLI。检查当前操作系统、Shell、Python 3.10+ 和已有安装；需要安装时，仅执行匹配环境的官方命令：

macOS / Linux:
curl -fsSL https://holycrab.ai/cli/install.sh | sh && export PATH="$HOME/.local/bin:$PATH"

Windows PowerShell:
irm https://holycrab.ai/cli/install.ps1 | iex

读取已安装的 HolyCrab Skill（或下方原文），检查 PATH，运行 holycrab doctor --json，并检查当前 Agent 接入状态。缺少依赖、权限或需要重启时，说明具体操作。

运行 holycrab auth status。未配置 API Key 时，引导我打开 API Key 页面，在本地终端运行 holycrab setup；不要让我把 Key 发到对话中。

分别报告 CLI、Agent 接入和账号配置状态。本次只安装和检查，不提交生成任务。

SKILL.md: https://raw.githubusercontent.com/AstroxNetwork/skills/v0.4.4/holycrab/SKILL.md

API Key: https://generate.holycrab.ai/user-tokens

CLI 安装: https://holycrab.ai/cn/guide/cli/

    手动安装

    在同一个安装页面选择 手动安装，切换 macOS / Linux 或 Windows，将复制的命令粘贴到终端或 PowerShell。已通过一键安装完成的用户可跳过此步骤。

    WindowsPowerShell 安装命令、Python 准备和安装检查。macOS / Linux终端安装命令、Python 与 curl 准备和安装检查。

    安装后

    配置 API Key尚未配置 API Key 时，按指南完成本地设置；API Key 已配置并验证有效可直接继续使用。在 Codex 中使用先查询模型并估算积分，确认后再生成。Claude Code 的使用流程相同。

    SKILL.md 与 CLI 安装入口

    安装页的 SKILL.md 用于下载与安装器版本一致的 Skill 文件；仅下载文件不会安装 CLI。右侧 CLI 安装 ↗ 会在新标签页打开本指南。

    常用术语说明

    术语含义
    CLI安装在电脑上的 HolyCrab 命令行工具。
    终端 / PowerShell用于输入安装和 setup 命令的系统程序。
    Codex通过对话协助调用本机 HolyCrab 工具的 Agent。
    API Key用于验证这台电脑访问 HolyCrab 账号权限的私密凭据。
    任务 ID / 素材 ID用于后续查询特定生成任务或素材的唯一编号。

    未成功时

    • 需要补充依赖、权限或重启 Agent 时，按检查结果处理，或查看对应系统的安装教程。
    • 安装或API Key 配置失败时，根据错误信息查看故障排查。分享报错前请移除 API Key。