نصب free-code ، عامل کدگذاری هوش مصنوعی رایگان برای پایانه شما
free-code پروژه شما را میخواند، پروندهها را با یک تفاوت که شما تأیید کردهاید ویرایش میکند، آزمونهای شما را اجرا میکند و هر اشتباهی را برطرف میکند. یک خط آن را در macOS ، Linux یا Windows نصب میکند.
curl -fsSL https://free.ai/install.sh | sh
irm https://free.ai/install.ps1 | iex
هیچ حق پایتون ، پیپ یا مدیر نیازی نیست. برای ارتقا ، همان خط را دوباره اجرا کنید.
برای شروع رایگان: 6,000 توکنهای یک روز بدون حساب، 30,000 یک روز با حساب رایگان تأیید شده.
روشهای دیگر نصب
The one-line installer uses uv, then pipx, then a private Python environment, whichever works first. If you already use one of these tools, install the freeai-code package directly:
uv tool install freeai-code
pipx install freeai-code
pip install freeai-code
npm install -g freeai-code
The npm package needs Python 3.9 or newer on the machine.
نصب یک نسخه خاص
# macOS / Linux
curl -fsSL https://free.ai/install.sh | FREE_CODE_VERSION=<version> sh
# Windows (PowerShell)
$env:FREE_CODE_VERSION = "<version>"; irm https://free.ai/install.ps1 | iex
برای اجبار یک روش نصب، FREE_CODE_INSTALLER را به uv، pipx یا venv به همان روش تنظیم کنید.
چک کن که کار کرد
free-code --version
اولین اجرا
باز کردن یک پایانه در پوشهی پروژه و آغاز یک نشست. بدون حساب، بلافاصله کار میکند.
cd your-project
free-code
# Or one task at a time
free-code ask "How does the auth system work?"
free-code run "Add unit tests for the User model"
حالت ایمن به صورت پیشفرض فعال است: شما یک تفاوت را میبینید و هر ویرایش پرونده و فرمان را قبل از اجرا تأیید میکنید. اولین بار، free-code یک بار میپرسد که آیا گزارشهای شکست ناشناس ارسال شود. پاسخ پیشفرض نه است.
ورود و کلیدهای API
ورود به سیستم میزان روزانه رایگان شما را افزایش میدهد و اجازه میدهد از مدلهای پرداختی از حساب نشانه خود استفاده کنید. مرورگر شما در Free.ai باز میشود، شما موافقت را فشار میدهید و CLI بهطور خودکار کلیدی دریافت میکند.
free-code login # opens your browser
free-code login --no-browser # over SSH: approve from any device with a short code
free-code login --manual # paste a key or choose your own provider
free-code logout # forget the key on this machine
همچنین میتوانید خودتان یک کلید را در حساب خود ایجاد کنید و تنظیم کنید ، که برای کارسازها و CI مفید است:
free-code config set token sk-free-...
# or, for one shell or a CI job
export FREE_CODE_TOKEN=sk-free-...
استفاده از کلید ارائهدهندۀ شخصی
کد آزاد همچنین با کلید OpenAI، Anthropic، Google یا OpenRouter خودتان کار میکند. درخواستها سپس با کلید شما به آن ارائهدهنده میروند.
free-code config set provider anthropic
free-code config set api_key sk-ant-...
انتخاب مدل
کد آزاد هر مدلی را که Free.ai ارائه میدهد فهرست میکند، مدلهای سطح آزاد اول. مدلهای سطح آزاد هیچ هزینهای در مبلغ روزانه شما ندارند؛ مدلهای پرداختی به صورت توکنها محاسبه میشوند.
free-code models # chat models, free tier first
free-code models --free # only models that cost no tokens
free-code models --type image # image, video, tts, stt, ocr, music ...
free-code config set model <id> # default model for new sessions
در داخل یک جلسه، برای تغییر، /model را تایپ کنید. مرور همۀ مدلها
فرمانهای مشترک
| فرمان | چيکار ميکنه؟ |
|---|---|
free-code | آغاز یک نشست تعاملی در این پوشه |
free-code -c | ادامه آخرین نشست برای این پروژه |
free-code ask "..." | یک سوال در مورد کدپایگاه بپرسید |
free-code run "..." | اجرای یک کار کدنویسی |
free-code -p "..." | چاپ پاسخ و خروج ، برای دستنوشتهها و CI |
free-code sessions | فهرست نشستهای ذخیرهشده که میتوانید ادامه دهید |
free-code tools | نمایش ابزارهایی که عامل میتواند استفاده کند و نیاز به تأیید دارند |
free-code cloud "..." --repo URL | یک کار را در ابر Free.ai اجرا کنید و یک گزارش دریافت کنید |
free-code tasks | فهرست وظایف ابری اخیر شما |
free-code rc | نشست را از برنامه Free.ai تماشا و هدایت کنید |
free-code mcp add | اتصال به کارگزار MCP |
free-code update | ارتقا به آخرین نسخه |
free-code config | نمایش تنظیمات شما |
علاوه بر ویرایش فایلها و اجرای دستورات، عامل میتواند تصاویر، گفتار، موسیقی و ویدئوها را در پروژه شما تولید کند، صدا را رونوشت کند، متن را از اسکرینشاتها و پیدیافها بخواند، وب را با نقل قولها جستجو کند و فایلهای محلی را ترجمه کند.
بهروزرسانی و حذف نصب
به روزرسانی کد آزاد از طریق هر چیزی که نصبش کرده ارتقاء مییابد. برای حذف آن، از همان ابزار استفاده کنید:
free-code update
uv tool uninstall freeai-code
pipx uninstall freeai-code
pip uninstall freeai-code
npm uninstall -g freeai-code
اگر نصبکننده محیط خود را ایجاد کردهاست، پوشه.free-code را در دایرکتوری اصلی خود و پرونده.free-code را در.local/bin حذف کنید. تنظیمات و نشستهای ذخیرهشده شما نیز در.free-code قرار دارند.
حل مشکل
free-code: فرمان پیدا نشد
پوشۀ نصب هنوز در PATH شما نیست. در ویندوز ، یک پایانه جدید باز کنید. در macOS یا لینوکس ، آن را به پروفایل پوسته خود اضافه کنید و پایانه جدیدی باز کنید:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc # or ~/.zshrc
محدوديت ناشناس آزاد امروز به اتمام رسيده
برای ورود به حساب و دریافت مبلغ روزانه بیشتر از حساب رایگان، یا اضافه کردن توکن برای استفاده از مدلهای پرداختی، ورودی کد آزاد را اجرا کنید. قیمت را ببینید
نصبکننده نمیتواند uv را بارگیری کند
Some networks block astral.sh. Install with pipx or pip instead, or set FREE_CODE_INSTALLER=venv to use your own Python 3.9 or newer.
python3 -m venv در دبیان یا اوبونتو شکست خورد
بسته python3-venv را با apt نصب کنید، سپس خط نصب را دوباره اجرا کنید.
هنوز گیر افتادید؟ /feedback را در کد آزاد تایپ کنید، یا یک مشکل در GitHub باز کنید. GitHub issues
پرسش و پاسخ
شروع کدنویسی با هوش مصنوعی در پایانه شما
curl -fsSL https://free.ai/install.sh | sh