入门一条命令接入

一条命令接入

在项目目录中运行一条命令即可：它会接收您的 API 密钥或签发沙盒密钥并进行校验，为 AI 智能体安装技能包，把密钥写入 .env，最后跑一遍测试订单。无需 sudo，也无需安装任何软件。

更新于 2026年10月8日 · 阅读约需 3 分钟

curl -fsSL https://astrum.shop/connect | sh

irm https://astrum.shop/connect.ps1 | iex

它会做什么

密钥提示您以隐藏方式输入密钥：密钥不会进入命令历史，也不会显示在输出中。没有密钥时直接按 Enter，命令会为您签发沙盒密钥（同一 IP 地址每天最多 3 个）。
校验调用 GET /v1/account 并读取商品目录，不产生任何费用：确认是沙盒还是正式环境、合作伙伴信息和限额；正式环境密钥还会显示余额。
AI 智能体 Claude Code 会在 .claude/skills/ 中获得技能包 astrum-partner-api，Codex 和 Cursor 会在 AGENTS.md 中获得一段关于 Astrum 的说明。未找到任何智能体时，技能包会保存到 ./astrum-skill/。
.env 把 ASTRUM_KEY 和 ASTRUM_BASE_URL 写入项目的 .env（权限 600），并把 .env 追加到 .gitignore。
试运行 astrum_check.py sandbox：测试 USDT、订单、客户信息、开通、当日订单和余额流水。使用正式环境密钥时不会试运行：下单会消耗余额。

终端会显示什么

~/projects/my-bot $ curl -fsSL https://astrum.shop/connect | sh

  Astrum Shop · подключение к API   connect 2.0.0

  Папка проекта  ~/projects/my-bot

  Ключ API — ask_test_… или ask_live_…
  Нет ключа? Нажмите Enter — выдадим ключ песочницы.
  › Enter

  ✓ Ключ песочницы выдан  ask_test_7f3a9c21_… · целиком — в .env, здесь не показываем
  ✓ Ключ работает         песочница · 7 тарифов в каталоге · 30 запросов в минуту · цены розничные

  ИИ-агенты на этой машине
  ✓ Claude Code           скилл astrum-partner-api 2.1.7 → .claude/skills/
  ✓ Codex                 абзац про Astrum → AGENTS.md
  – Cursor                не найден
  ✓ .env                  ASTRUM_KEY (права 600) и ASTRUM_BASE_URL · .env добавлен в .gitignore

  Прогон песочницы — astrum_check.py sandbox
    ok    GET /account — партнёр 'Гость песочницы'
    ok    тестовые 50 USDT на баланс — 201
    ok    каталог — товар с активацией за 26.00 USDT
    ok    заказ — 8c41…d07e · waiting · ждём chatgpt_session
    ok    данные клиента — 200
    ok    заказ — completed
    ok    заказы за сегодня — заказ в списке
    ok    история баланса — оплата заказа −26.00 USDT

  всё ok

  Готово. Скажите своему ИИ-агенту:
  › Подключи заказ подписок Astrum к моему боту
  Руками — https://astrum.shop/docs/start

终端输出为俄文

接入命令目前只输出俄文提示，各行依次对应上文「它会做什么」中的步骤：领取或校验密钥、安装技能包、写入 .env、在沙盒中跑一遍测试订单。出现 всё ok 即表示全部通过。出错时的俄文提示及其含义见下表。

何时会失败

在签发密钥之前，命令会先检查所有可能导致新密钥不得不作废的问题：目录和 .env。

看到的提示	处理方法
`Ключ не принят — 401`（密钥未被接受）	请完整复制密钥。沙盒密钥丢失时，重新运行命令并按 Enter
`С вашего адреса уже выдали … за сутки`（您的 IP 地址 24 小时内已领取 … 个密钥）	之前的密钥仍然有效，保存在您各个项目的 `.env` 中；新密钥需等待 `Retry-After` 指定的时间
`Ключи песочницы на сегодня закончились`（今天的沙盒密钥已发完）	莫斯科时间 00:00 起可再次领取；如有急需，请联系客服
`.env отслеживается git`（.env 已被 git 跟踪）	执行 `git rm --cached .env` 和 `echo .env >> .gitignore`，然后重新运行
`Это домашняя папка`（这是主目录）	请在项目目录中运行：`.env` 会写入运行命令时所在的目录
`ИИ-агентов на этой машине нет`（本机未发现 AI 智能体）	技能包已保存到 `./astrum-skill/`；任何 AI 都可以使用 `https://api.astrum.shop/llms-full.txt`

没有交互式终端时（如 CI），密钥从环境变量 ASTRUM_KEY 读取。

运行前查看脚本

脚本是公开的：https://astrum.shop/connect（Windows 版：https://astrum.shop/connect.ps1）。两者的 sha256 校验和见 https://astrum.shop/connect.sha256。下载、校验并运行：

curl -fsSL https://astrum.shop/connect -o connect.sh
curl -fsSL https://astrum.shop/connect.sha256 | grep connect.sh | shasum -a 256 -c -
sh connect.sh

来自同一主机的校验和只能验证下载内容的完整性，不能证明其真实性：脚本和校验和来自同一台服务器。

不使用终端

「沙盒」一节中的按钮同样可以签发沙盒密钥；如需在浏览器中把整份指南交给 ChatGPT 或 Claude，可使用单文件版本 https://api.astrum.shop/llms-full.txt。

本页内容是否有帮助？

发现错误？在 Telegram 联系我们