GH-REPO-CLONE(1) GitHub CLI manual GH-REPO-CLONE(1)

gh-repo-clone - کلون کردن یک مخزن در سیستم محلی

gh repo clone <repository> [<directory>] [-- <gitflags>...]

یک مخزن گیت‌هاب را در سیستم محلی کلون می‌کند. فلگ‌های اضافی git clone را با فهرست کردن آن‌ها پس از -- ارسال کنید.

اگر بخش OWNER/ از آرگومان مخزن OWNER/REPO حذف شود، به‌طور پیش‌فرض از نام کاربر احراز هویت شده استفاده خواهد شد.

هنگامی که طرح‌واره پروتکل در آرگومان مخزن مشخص نشده باشد، git_protocol از پیکربندی شما انتخاب می‌شود که با استفاده از gh config get git_protocol قابل بررسی است. اگر طرح‌واره پروتکل ارائه شده باشد، مخزن با استفاده از همان پروتکل مشخص‌شده کلون خواهد شد.

اگر مخزن یک فورک (انشعاب) باشد، مخزن والد آن به عنوان یک ریموت گیت اضافی به نام upstream افزوده می‌شود. نام ریموت را می‌توان با استفاده از --upstream-remote-name پیکربندی کرد. گزینه --upstream-remote-name از مقدار @owner پشتیبانی می‌کند که نام ریموت را مطابق با نام مالک مخزن والد تعیین می‌نماید.

اگر مخزن یک فورک باشد، مخزن والد آن به عنوان مخزن ریموت پیش‌فرض تنظیم خواهد شد. برای صرف‌نظر از این رفتار، از --no-upstream استفاده کنید.

عدم افزودن ریموت بالادست (upstream) هنگام کلون کردن یک فورک
نام ریموت بالادست هنگام کلون کردن یک فورک

0: اجرای موفقیت‌آمیز

1: خطا

2: دستور لغو شد

4: نیاز به احراز هویت است

نکته: دستورات خاص ممکن است کدهای خروج دیگری نیز داشته باشند. برای اطلاعات بیشتر به راهنمای همان دستور مراجعه کنید.

# کلون کردن یک مخزن از یک سازمان خاص
$ gh repo clone cli/cli
# کلون کردن یک مخزن از حساب کاربری خودتان
$ gh repo clone myrepo
# کلون کردن یک مخزن با بازنویسی پیکربندی پروتکل گیت
$ gh repo clone https://github.com/cli/cli
$ gh repo clone git@github.com:cli/cli.git
# کلون کردن یک مخزن در یک دایرکتوری سفارشی
$ gh repo clone cli/cli workspace/cli
# کلون کردن یک مخزن با فلگ‌های اضافی git clone
$ gh repo clone cli/cli -- --depth=1
# کلون کردن یک فورک بدون افزودن ریموت بالادست
$ gh repo clone myfork --no-upstream

gh-repo(1)

Sep 2026