تثبيت free-code، وكيل الترميز الذكاء الاصطناعي الحر لطرفيتك
يقوم برنامج free-code بقراءة مشروعك، وتحرير الملفات مع مقارنة الموافقة عليها، وتشغيل اختباراتك وإصلاح ما يفشل. سطر واحد يقوم بتركيب على macOS، Linux أو Windows.
curl -fsSL https://free.ai/install.sh | sh
irm https://free.ai/install.ps1 | iex
لا يحتاج إلى حقوق Python أو pip أو admin أولاً. أطلق نفس السطر مرة أخرى للارتقاء.
مجاني للبدء: 6,000 tokens يوميا بدون حساب، 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
تحتاج حزمة npm إلى بيثون 3.9 أو أحدث على الجهاز.
تثبيت نسخة محددة
# 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
يمكنك أيضاً إنشاء مفتاح بنفسك في حسابك وتحديده، وهو أمر مفيد للخواديم و IC:
free-code config set token sk-free-...
# or, for one shell or a CI job
export FREE_CODE_TOKEN=sk-free-...
استخدم مفتاح مقدم الخدمة الخاص بك
يعمل free-code أيضاً مع مفتاح OpenAI الخاص بك، أو Anthropic، أو Google أو OpenRouter. ثم تذهب الطلبات إلى ذلك المزود مع مفتاحك.
free-code config set provider anthropic
free-code config set api_key sk-ant-...
اختار نموذجاً
free-code يعرض كل نموذج 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 "..." | طباعة الإجابة والخروج، للنصوص والاتصالات المتبادلة |
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 | أظهر إعداداتك |
بالإضافة إلى تحرير الملفات وتشغيل الأوامر، يمكن للوكيل توليد الصور، والكلمات، والموسيقى والفيديو في مشروعك، وتحرير الصوت، وقراءة النص من لقطات الشاشة وملفات PDF، والبحث على شبكة الإنترنت مع الاقتباسات وترجمة ملفات اللغة المحلية.
تحديث وإزالة
تحديثات التطوير من خلال أي شيء تم تركيبه. لإزالته، استخدم نفس الأداة:
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.
حل المشاكل
لم يتم العثور على الأمر
مجلد التثبيت ليس في PATH الخاص بك بعد. على ويندوز، افتح محطة طرفية جديدة. على macOS أو Linux، أضفها إلى ملف بيانات قشرة وفتح محطة طرفية جديدة:
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc # or ~/.zshrc
الحد المجاني المجهول اليوم قد استُهلك
تشغيل رمز الدخول المجاني للدخول والحصول على الإعانة اليومية الأكبر لحساب مجاني، أو إضافة الرموز لاستخدام نماذج مدفوعة. انظر التسعير
لا يستطيع برنامج التثبيت تنزيل uv
بعض الشبكات تمنع astral.sh. تثبيت مع pipx أو pip بدلا من ذلك، أو وضع FREE_CODE_INSTALLER=venv لاستخدام الخاص بك Python 3.9 أو أحدث.
فشلت عملية python3 -m venv على نظام Debian أو Ubuntu
ضع حزمة python3-venv مع apt، ثم أطلق سطر التثبيت مرة أخرى.
ما زلت عالقاً؟ أكتب /feedback داخل free-code، أو افتح قضية على GitHub. GitHub issues
الأسئلة المتكررة
ابدأ بالترميز مع الذكاء الاصطناعي في المحطة الطرفية
curl -fsSL https://free.ai/install.sh | sh