All tutorials/3 min/Beginner

Aider tutorial

كيفية تثبيت Aider AI Coding CLI على Mac و Windows

دليل خطوة بخطوة لتثبيت Aider AI pair programming CLI على macOS و Windows. تعلم كيفية تكوين مفاتيح API لـ Claude 3.7 و GPT-4o.

AI ToolsCLIBeginner
Interactive tutorial

Quick command sequence

$ pip install aider-chat

/ar/tutorials/install-aider-ai-coding-cli-mac-windows

Interactive command lab

1/4

Step 1

Verify Python and pip

Aider is a Python package. If you get 'command not found', download Python from python.org before continuing.

Checkpoint

python3 --version

zsh — tutorial-lab

Command tray

$ python3 --version
pip --version

➜ Python 3.12.2

➜ pip 24.0 from /usr/local/lib/python3.12/site-packages/pip (python 3.12)

تعليمات خطوة بخطوة

  1. 1

    Step

    Verify Python and pip

    Aider is a Python package. If you get 'command not found', download Python from python.org before continuing.

    python3 --version pip --version
  2. 2

    Step

    Install Aider via pip

    If you get an 'externally-managed-environment' error on macOS, run `pipx install aider-chat` instead.

    pip install aider-chat
  3. 3

    Step

    Set your API Key

    To use GPT-4o instead, use `export OPENAI_API_KEY=your-key`.

    export ANTHROPIC_API_KEY=your_key_here
  4. 4

    Step

    Launch Aider

    Aider requires your project to be a Git repository. If it's not, run `git init` first.

    cd your-project-folder aider

لماذا هذا مهم

Aider هي أداة CLI رائدة للبرمجة الزوجية بالذكاء الاصطناعي تتيح لك تحرير ملفات متعددة في وقت واحد مباشرة من الطرفية الخاصة بك.

استكشاف الأخطاء وإصلاحها

  • 'externally-managed-environment' on macOS: Modern macOS versions block global pip installs. Instead of using pip, install pipx using Homebrew (brew install pipx), run pipx ensurepath, and then install Aider via pipx install aider-chat.
  • 'aider is not recognized' on Windows: If you installed Aider but Windows can't find it, your Python Scripts folder isn't in your PATH. Search for 'Environment Variables', edit PATH, and add %USERPROFILE%\AppData\Local\Programs\Python\Python312\Scripts (adjusting for your version).
  • No Git repository error: Aider is designed to track its own changes using Git. If you run aider in an empty folder, it will prompt you. Simply run git init to initialize the repository before starting your coding session.

FAQ

Why do I get 'command not found: aider' after installing?

This usually means the directory where pip installed the executable is not in your system's PATH variable. You either need to add the Python Scripts directory to your PATH or use pipx to manage the installation.

Can I use OpenAI GPT-4o instead of Claude?

Yes. While Claude 3.7 Sonnet is currently the top performer for Aider's benchmarks, you can easily use GPT-4o. Just run export OPENAI_API_KEY=your-key and launch the CLI with aider --model gpt-4o.

Does Aider work in PowerShell?

Absolutely. Once installed via pip, the aider command works in PowerShell, Command Prompt, Windows Terminal, and WSL.

How do I update Aider to the latest version?

If you used pip, run pip install --upgrade aider-chat. If you used pipx, run pipx upgrade aider-chat.

Does Aider send my entire codebase to the API?

No. Aider uses a repository map to understand the architecture, but it only sends the specific files you have "added" to the chat session.

Related

Microsoft Copilot Studio

بناء وكيل استقبال عملاء في Microsoft Copilot Studio لشركات الخدمات

أنشئ وكيلاً يؤهل العملاء، يجمع تفاصيل الخدمة، يحفظ بيانات الطلب، ويوجه الحالات العاجلة إلى فريقك.

Copilot

How to Install GitHub Copilot CLI on Mac and Windows

Step-by-step guide to installing the GitHub Copilot CLI extension. Learn how to authenticate and run gh copilot suggest and explain in your terminal.