---
title: CLI
description: 安裝並使用官方命令列工具 @recur-tw/cli
---

# Recur CLI

官方 CLI 發佈在 npm，套件名稱是 **`@recur-tw/cli`**（不是 `recur`）。人類與 AI agent 都可以用它列出產品、建立結帳、檢查訂閱，不必從零組 REST 呼叫。

## 安裝

```bash
npm install -g @recur-tw/cli
```

或不安裝、直接執行：

```bash
npx @recur-tw/cli --help
npx @recur-tw/cli login
# or: export RECUR_SECRET_KEY=sk_test_xxx
npx @recur-tw/cli products list
```

npm 頁面：https://www.npmjs.com/package/@recur-tw/cli

## 登入

到 [Dashboard](https://app.recur.tw) 複製 Secret Key（`sk_test_*` 或 `sk_live_*`），然後：

```bash
recur login
```

金鑰存在 `~/.recur/credentials.json`（權限 `0600`）。也可以設環境變數：

```bash
export RECUR_SECRET_KEY=sk_test_xxx
```

沙盒金鑰以 `sk_test_` 開頭，不會對真實卡片扣款。

## 常用指令

```bash
recur products list
recur customers list
recur subscriptions list
```

完整指令見套件 README。SDK 請改用 npm 套件 [`recur-tw`](/getting-started/sdk)。