skill

Vercel CLI بالرموز

نشر المشاريع وإدارتها على Vercel باستخدام المصادقة القائمة على الرمز المميز. تستخدم عند العمل مع Vercel CLI باستخدام رموز الوصول بدلا من تسجيل الدخول التفاعلي، مثل "deploy to vercel" و "set up vercel" و "add environment variables to vercel".

vercel-labs110,344+ تثبيتموثوق

نبذة

# Vercel CLI مع الرموز (Tokens)

نشر وإدارة المشاريع على Vercel باستخدام واجهة سطر الأوامر (CLI) مع المصادقة القائمة على الرموز، دون الاعتماد على `vercel login`.

## الخطوة 1: تحديد موقع رمز Vercel

قبل تشغيل أي أوامر Vercel CLI، حدد مصدر الرمز. اتبع هذه السيناريوهات بالترتيب:

### أ) `VERCEL_TOKEN` مضبوط بالفعل في البيئة

```bash printenv VERCEL_TOKEN ```

إذا أعاد هذا قيمة، فأنت جاهز. انتقل إلى الخطوة 2.

### ب) الرمز موجود في ملف `.env` تحت `VERCEL_TOKEN`

```bash grep '^VERCEL_TOKEN=' .env 2>/dev/null ```

إذا وجد، قم بتصديره:

```bash export VERCEL_TOKEN=$(grep '^VERCEL_TOKEN=' .env | cut -d= -f2-) ```

### ج) الرمز موجود في ملف `.env` تحت اسم مختلف

ابحث عن أي متغير يبدو وكأنه رمز Vercel (تبدأ رموز Vercel عادة ب `vca_`):

```bash grep -i 'vercel' .env 2>/dev/null ```

افحص المخرجات لتحديد المتغير الذي يحمل الرمز، ثم قم بتصديره ك `VERCEL_TOKEN`:

```bash export VERCEL_TOKEN=$(grep '^<VARIABLE_NAME>=' .env | cut -d= -f2-) ```

### د) لم يتم العثور على رمز — اطلب من المستخدم

إذا لم تسفر أي من الطرق المذكورة أعلاه عن رمز، اطلب من المستخدم توفيره. يمكنهم إنشاء رمز وصول Vercel على vercel.com/account/tokens.

---

**هام:** بمجرد تصدير `VERCEL_TOKEN` كمتغير بيئة، تقرأه Vercel CLI بشكل طبيعي — **لا تمرره كعلامة `--token`**. وضع الأسرار في وسائط سطر الأوامر يعرضها في سجل الأوامر وقوائم العمليات.

```bash # خطأ — الرمز مرئي في سجل الأوامر وقوائم العمليات vercel deploy --token "vca_abc123"

# صحيح — CLI تقرأ VERCEL_TOKEN من البيئة export VERCEL_TOKEN="vca_abc123" vercel deploy ```

## الخطوة 2: تحديد موقع المشروع والفريق

وبالمثل، تحقق من معرف المشروع ونطاق الفريق. يسمح هذا ل CLI باستهداف المشروع الصحيح دون الحاجة إلى `vercel link`.

```bash # التحقق من البيئة printenv VERCEL_PROJECT_ID printenv VERCEL_ORG_ID

# أو التحقق من .env grep -i 'vercel' .env 2>/dev/null ```

**إذا كان لديك عنوان URL للمشروع** (مثل `https://vercel.com/my-team/my-project`)، استخرج اسم الفريق (slug):

```bash # على سبيل المثال "my-team" من "https://vercel.com/my-team/my-project" echo "$PROJECT_URL" | sed 's|https://vercel.com/||' | cut -d/ -f1 ```

**إذا كان لديك كل من `VERCEL_ORG_ID` و `VERCEL_PROJECT_ID` في بيئتك**، قم بتصديرهما — ستستخدمهما CLI تلقائيا وتتخطى أي دليل `.vercel/`:

```bash export VERCEL_ORG_ID="<org-id>" export VERCEL_PROJECT_ID="<project-id>" ```

ملاحظة: يجب تعيين `VERCEL_ORG_ID` و `VERCEL_PROJECT_ID` معا — تعيين أحدهما فقط يسبب خطأ.

## إعداد CLI

تأكد من تثبيت Vercel CLI وتحديثها:

```bash npm install -g vercel vercel --version ```

## نشر مشروع

انشر دائما ك **معاينة** ما لم يطلب المستخدم الإنتاج صراحة. اختر طريقة بناء على ما هو متاح لديك.

### نشر سريع (لديك معرف المشروع — لا حاجة للربط)

عندما يتم تعيين `VERCEL_TOKEN` و `VERCEL_PROJECT_ID` في البيئة، انشر مباشرة:

```bash vercel deploy -y --no-wait ```

مع نطاق فريق (إما عبر `VERCEL_ORG_ID` أو `--scope`):

```bash vercel deploy --scope <team-slug> -y --no-wait ```

الإنتاج (فقط عند الطلب الصريح):

```bash vercel deploy --prod --scope <team-slug> -y --no-wait ```

التحقق من الحالة:

```bash vercel inspect <deployment-url> ```

### تدفق النشر الكامل (لا يوجد معرف مشروع — تحتاج إلى ربط)

استخدم هذا عندما يكون لديك رمز وفريق ولكن لا يوجد معرف مشروع موجود مسبقا.

#### تحقق من حالة المشروع أولا

```bash # هل للمشروع git remote؟ git remote get-url origin 2>/dev/null

# هل هو مرتبط بالفعل بمشروع Vercel؟ cat .vercel/project.json 2>/dev/null || cat .vercel/repo.json 2>/dev/null ```

#### ربط المشروع

**مع git remote (مفضل):**

```bash vercel link --repo --scope <team-slug> -y ```

يقرأ git remote ويتصل بمشروع Vercel المطابق. ينشئ `.vercel/repo.json`. أكثر موثوقية من `vercel link` العادي، الذي يطابق حسب اسم الدليل.

**بدون git remote:**

```bash vercel link --scope <team-slug> -y ```

ينشئ `.vercel/project.json`.

**الربط بمشروع معين بالاسم:**

```bash vercel link --project <project-name> --scope <team-slug> -y ```

إذا كان المشروع مرتبطا بالفعل، تحقق من `orgId` في `.vercel/project.json` أو `.vercel/repo.json` للتحقق من مطابقته للفريق المقصود.

#### النشر بعد الربط

**أ) نشر Git Push — لديه git remote (مفضل)**

تؤدي عمليات دفع Git إلى عمليات نشر Vercel تلقائية.

1. **اسأل المستخدم قبل الدفع.** لا تدفع أبدا بدون موافقة صريحة. 2. الالتزام والدفع: ```bash git add . git commit -m "deploy: <description of changes>" git push ``` 3. يقوم Vercel بالبناء تلقائيا. تحصل الفروع غير الإنتاجية على عمليات نشر معاينة. 4. استرداد عنوان URL للنشر: ```bash sleep 5 vercel ls --format json --scope <team-slug> ``` ابحث عن أحدث إدخال في مصفوفة `deployments`.

**ب) نشر CLI — لا يوجد git remote**

```bash vercel deploy --scope <team-slug> -y --no-wait ```

التحقق من الحالة:

التثبيت

شغل هذا الأمر

npx skills add vercel-labs/agent-skills

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `npx skills add vercel-labs/agent-skills`، أو استنسخ المستودع وانسخ مجلد `skills/vercel-cli-with-tokens` إلى دليل مهارات Claude الخاص بك.

عرض المصدر

أسئلة شائعة

ما هي مهارة Vercel CLI بالرموز؟

نشر المشاريع وإدارتها على Vercel باستخدام المصادقة القائمة على الرمز المميز. تستخدم عند العمل مع Vercel CLI باستخدام رموز الوصول بدلا من تسجيل الدخول التفاعلي، مثل "deploy to vercel" و "set up vercel" و "add environment variables to vercel".

كيف أثبت Vercel CLI بالرموز؟

شغل هذا الأمر في الطرفية:

npx skills add vercel-labs/agent-skills
مع أي أدوات ذكاء اصطناعي تعمل Vercel CLI بالرموز؟

تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.

من طور Vercel CLI بالرموز؟

طورها vercel-labs.

هل Vercel CLI بالرموز مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في التطوير والبرمجة.

كل بدائل Vercel CLI بالرموز ←
skillclaude_appclaude_codeclaude_api
git clone https://github.com/anthropics/skills && cp -r skills/skills/claude-api ~/.claude/skills/
واجهة برمجة تطبيقات Claude
مرجع ل Claude API / Anthropic SDK — معرفات النماذج، التسعير، المعاملات (params)، البث (streaming)، استخدام الأدوات، MCP، الوكلاء (agents)، التخزين الم…★ 4.8 · 2,500+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
واجهة سطر الأوامر Hyperframes
واجهة سطر الأوامر (CLI) ل HyperFrames من job - لإنشاء الهياكل، والتحقق من الإطارات، وعرضها، وتعديل الجدول الزمني، والمعاينة، والتصيير محليا أو سحابيا،…1,214,920+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تطوير مدفوع بالاختبار
التطوير الموجه بالاختبار. يستخدم عندما يرغب المستخدم في بناء ميزات أو إصلاح أخطاء بأسلوب "الاختبار أولا"، أو يذكر "red-green-refactor"، أو يريد اختبار…1,046,962+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء
استجوب المستخدم بلا هوادة حول خطة أو قرار أو فكرة. استخدمها عندما يرغب المستخدم في اختبار مدى متانة تفكيره، أو يستخدم أي عبارات تحفيزية مثل "استجواب".869,010+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تشخيص الأخطاء
حلقة تشخيص للأخطاء الصعبة وتراجعات الأداء. تستخدم عندما يقول المستخدم "شخص/صحح هذا"، أو يبلغ عن شيء معطل/يصدر أخطاء/فاشل/بطيء.746,030+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
مراجعة الكود
راجع التغييرات منذ نقطة ثابتة (التزام، فرع، وسم، أو قاعدة دمج) على محورين: المعايير (هل يتبع الكود معايير الترميز الموثقة لهذا المستودع؟) والمواصفات (…696,572+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في التطوير والبرمجة