---

name: setup-vercel description: "Vercel CLIのインストール・認証・設定を行う。「Vercel設定」「vercel設定」「Vercelセットアップ」を依頼されたときに使用する。"

Setup Vercel Workflow

Vercel CLIのインストールから認証までを対話的にサポートする。

Instructions

1. 前提条件チェック

Node.jsがインストールされているか確認:

Copynode --version  # v18以上推奨
npm --version

Node.jsがない場合は先にインストールが必要。

2. 環境チェック

Copy# Vercel CLIがインストールされているか
vercel --version

# 認証状態の確認
vercel whoami

3. インストール（未インストールの場合）

Copy# npm（グローバル）
npm install -g vercel

# pnpm
pnpm install -g vercel

# yarn
yarn global add vercel

4. 認証

Copy# ブラウザ認証（推奨）
vercel login

認証フロー:

1. コマンド実行後、ブラウザが開く（または URLが表示される）
2. 表示されたURLにアクセス
3. 画面に表示されるコードを確認
4. Vercelアカウントでログイン（GitHubアカウント連携推奨）
5. 「Authorize」をクリック

5. 認証確認

Copy# ログイン状態を確認
vercel whoami

# 期待される出力:
# > username

6. アカウント作成（未登録の場合）

1. https://vercel.com/signup にアクセス
2. 「Continue with GitHub」を選択（推奨）
3. GitHubアカウントで認証
4. Hobby（無料）プランを選択
5. 完了後、vercel login を再実行

Hobbyプラン（無料）の制限

※ 商用利用はProプラン（$20/月）が必要

トラブルシューティング

トークンが無効

Copy# 再ログイン
vercel logout
vercel login

権限エラー（npm グローバルインストール）

Copy# sudoを使う（非推奨）
sudo npm install -g vercel

# または npxで実行（インストール不要）
npx vercel
npx vercel login

GitHubリポジトリ連携エラー

VercelダッシュボードでGitHub Appの権限を確認:

1. https://vercel.com/account/integrations にアクセス
2. GitHubの「Configure」をクリック
3. 必要なリポジトリへのアクセスを許可

確認コマンド

Copy# 状態確認
vercel whoami
vercel teams ls  # チーム一覧（あれば）

# プロジェクト一覧
vercel projects ls

成功条件

• vercel whoami でユーザー名が表示される
• vercel --prod でデプロイが実行できる