Vercel CLI スキル

Vercel CLI (vercel または vc) は、コマンドラインから Vercel プラットフォーム上のプロジェクトをデプロイ、管理、開発します。任意のコマンドの全フラグ詳細については vercel <command> --help を使用してください。

インストール済みの CLI ヘルプは、不明瞭なフラグや新しく追加されたフラグの正確な情報源です。ここのコマンド例で十分でない場合は、推測する代わりに vercel <command> --help を確認してから実行してください。

重要: プロジェクトリンク

コマンドは .vercel フォルダを含むディレクトリ (またはそのサブディレクトリ) から実行する必要があります。.vercel がどのようにセットアップされるかは、プロジェクト構造によって異なります:

• .vercel/project.json: vercel link によって作成されます。単一のプロジェクトをリンクします。単一プロジェクトリポジトリに適切で、複数プロジェクトがある場合でもモノレポで機能します (ただしプロジェクトが 1 つだけの場合)。
• .vercel/repo.json: vercel link --repo によって作成されます。複数のプロジェクトを含む可能性のあるリポジトリをリンクします。プロジェクトがルート以外のディレクトリにある場合 (例: apps/web) は常に良い選択肢です。

プロジェクトのサブディレクトリから実行する場合 (例: apps/web/)、それが曖昧でないため「どのプロジェクト?」プロンプトがスキップされます。

何か問題が発生した場合は、まずリンク方法をチェックしてください — .vercel/ の内容を確認し、project.json であるか repo.json であるかを確認します。また vercel whoami で正しいチームにいることを確認してください — 誤ったチームでリンクすることは一般的な間違いです。

クイックスタート

npm i -g vercel
vercel login
vercel link              # single project
# OR
vercel link --repo       # monorepo
vercel pull
vercel dev        # local development
vercel deploy     # preview deployment
vercel --prod     # production deployment

デシジョンツリー

正しいリファレンスファイルにルーティングするには以下を使用してください:

• デプロイ → references/deployment.md
• ローリングリリース、デプロイフック、cron ジョブ、キャッシュ、git 接続、Edge Config、リダイレクト、カスタム環境 → references/project-infra.md
• ローカル開発 → references/local-development.md
• 環境変数 → references/environment-variables.md
• CI/CD 自動化 → references/ci-automation.md
• ドメイン または DNS → references/domains-and-dns.md
• プロジェクト または チーム → references/projects-and-teams.md
• ログ、メトリクス、アクティビティ、パフォーマンス、プレビューアクセス、またはプロダクションデバッグ → references/monitoring-and-debugging.md
• アラート、使用状況、契約、課金購入、トークン、テレメトリ、または CLI アップグレード → references/platform-ops.md
• Blob ストレージ → references/storage.md
• 統合 (データベース、ストレージなど) → references/integrations.md
• コネクタ (vercel connect) → references/connectors.md
• ルーティングルール → references/routing.md
• ファイアウォール (WAF ルール、IP ブロック、レート制限) → references/firewall.md
• プレビューデプロイメントにアクセス → vercel curl を使用 (references/monitoring-and-debugging.md を参照)
• CLI コマンドが利用できないまたは出力に必要なフィールドがない → 一流の CLI パスが利用できない、または不十分な場合は vercel api を使用 (references/advanced.md を参照)
• Node.js バックエンド (Express、Hono など) → references/node-backends.md
• モノレポ (Turborepo、Nx、ワークスペース) → references/monorepos.md
• Bun ランタイム → references/bun.md
• フィーチャーフラグ → references/flags.md
• マイクロフロントエンド → references/microfrontends.md
• Sandbox → references/sandbox.md
• エージェント、MCP、スキル検出、または AI Gateway → references/agent-and-ai.md
• 高度な機能 (API、ウェブフック、oauth アプリ) → references/advanced.md
• グローバルフラグ → references/global-options.md
• 初回セットアップ → references/getting-started.md

アンチパターン

• 複数プロジェクトがあるモノレポでのリンク方法の誤り: vercel link は project.json を作成し、1 つのプロジェクトのみ追跡します。代わりに vercel link --repo を使用してください。問題が発生した場合は、.vercel/ を最初にチェックしてください。
• モノレポで自動リンクをコマンドに任せる: 多くのコマンドは .vercel/ が存在しない場合、暗黙的に vercel link を実行します。これは project.json を作成し、誤っている可能性があります。明示的に最初に vercel link (または --repo) を実行してください。
• 間違ったチームでリンク: vercel whoami でチェック、vercel teams switch で変更してください。
• CI/エージェント実行でプロンプトなしフラグを忘れる: プロンプトなしの動作が必要な場合は --non-interactive を使用し、確認が必要なコマンドには --yes のみを追加してください。
• vercel build の後に vercel deploy を実行する場合、--prebuilt なし: ビルド出力は無視されます。
• トークンをフラグにハードコード: 代わりに VERCEL_TOKEN 環境変数を使用してください。
• デプロイメント保護を無効化: プレビュー展開にアクセスするには代わりに vercel curl を使用してください。
• vercel api を早すぎるタイミングで使用: 必要なデータまたは操作を公開する一流の CLI コマンドを優先してください。