Перейти к содержимому

Введение

Начните работу с aicippy-code.

aicippy-code — это агент кодирования искусственного интеллекта с открытым исходным кодом. Он доступен в виде интерфейса на базе терминала, настольного приложения или расширения IDE.

aicippy-code TUI с темой aicippy-code

Давайте начнем.


Системные требования

Чтобы использовать aicippy-code в вашем терминале, вам понадобится:

  1. Современный эмулятор терминала, например:

    • WezTerm, кроссплатформенный
    • Alacritty, кроссплатформенный
    • Ghostty, Linux и macOS
    • Kitty, Linux и macOS
  2. Ключи API для поставщиков LLM, которых вы хотите использовать.


Установка

Самый простой способ установить aicippy-code — через сценарий установки.

Окно терминала
curl -fsSL https://code.aicippy.com/install | bash

Вы также можете установить его с помощью следующих команд:

  • Использование Node.js

    Окно терминала
    npm install -g aicippy-code
  • Использование Homebrew в macOS и Linux

    Окно терминала
    bun run --cwd packages/aicippy-code script/build.ts --install

    Мы рекомендуем использовать tap aicippy-code для получения самых последних версий. Официальная формула brew install aicippy-code поддерживается командой Homebrew и обновляется реже.

  • Использование Paru в Arch Linux

    Окно терминала
    sudo pacman -S aicippy-code # Arch Linux (Stable)
    paru -S aicippy-code-bin # Arch Linux (Latest from AUR)

Windows

  • Используя Chocolatey

    Окно терминала
    choco install aicippy-code
  • Использование Scoop

    Окно терминала
    scoop install aicippy-code
  • Использование NPM

    Окно терминала
    npm install -g aicippy-code
  • Использование Mise

    Окно терминала
    mise use -g github:ajaitech/aicippy-code
  • Использование Docker

    Окно терминала
    docker run -it --rm ghcr.io/aivibe/aicippy-code

В настоящее время добавляется поддержка установки aicippy-code в Windows с помощью Bun.

Вы также можете получить бинарный файл в разделе Releases.


Настроить

С aicippy-code вы можете использовать любого поставщика LLM, настроив его ключи API.

Если вы новичок в использовании поставщиков LLM, мы рекомендуем использовать AicippY Zen. Это тщательно подобранный список моделей, протестированных и проверенных aicippy-code.

  1. Запустите команду /connect в TUI, выберите aicippy-code и перейдите по адресу code.aicippy.com/auth.

    /connect
  2. Войдите в систему, добавьте свои платежные данные и скопируйте ключ API.

  3. Вставьте свой ключ API.

    ┌ API key
    └ enter

Альтернативно вы можете выбрать одного из других поставщиков. Подробнее.


Инициализация

Теперь, когда вы настроили поставщика, вы можете перейти к проекту, который над которым вы хотите работать.

Окно терминала
cd /path/to/project

И запустите aicippy-code.

Окно терминала
aicippy-code

Затем инициализируйте aicippy-code для проекта, выполнив следующую команду.

/init

Это позволит aicippy-code проанализировать ваш проект и создать файл AGENTS.md в корень проекта.

Это помогает aicippy-code понять структуру проекта и шаблоны кодирования. использовал.


Использование

Теперь вы готовы использовать aicippy-code для работы над своим проектом. Не стесняйтесь спрашивать о чем угодно!

Если вы новичок в использовании агента кодирования ИИ, вот несколько примеров, которые могут вам помочь.


Задавайте вопросы

Вы можете попросить aicippy-code объяснить вам кодовую базу.

How is authentication handled in @packages/functions/src/api/index.ts

Это полезно, если есть часть кодовой базы, над которой вы не работали.


Добавление функций

Вы можете попросить aicippy-code добавить новые функции в ваш проект. Хотя мы сначала рекомендуем попросить его создать план.

  1. Составьте план

    aicippy-code имеет режим планирования, который отключает возможность вносить изменения и вместо этого предложите как реализовать эту функцию.

    Переключитесь на него с помощью клавиши Tab. Вы увидите индикатор этого в правом нижнем углу.

    <TAB>

    Теперь давайте опишем, что мы хотим от него.

    When a user deletes a note, we'd like to flag it as deleted in the database.
    Then create a screen that shows all the recently deleted notes.
    From this screen, the user can undelete a note or permanently delete it.

    Нужно предоставить aicippy-code достаточно подробностей, чтобы ему понять, чего вы хотите. Это помогает поговорить с ним так, как будто вы разговариваете с младшим разработчиком в своей команде.

  2. Итерация плана

    Как только он предоставит вам план, вы можете оставить ему отзыв или добавить более подробную информацию.

    We'd like to design this new screen using a design I've used before.
    [Image #1] Take a look at this image and use it as a reference.

    aicippy-code может сканировать любые изображения, которые вы ему предоставляете, и добавлять их в командную строку. Вы можете сделать это, перетащив изображение в терминал.

  3. Создайте функцию

    Как только вы почувствуете себя комфортно с планом, вернитесь в режим сборки, снова нажав клавишу Tab.

    <TAB>

    И попросите его внести изменения.

    Sounds good! Go ahead and make the changes.

Внесение изменений

Для более простых изменений вы можете попросить aicippy-code создать их напрямую. без необходимости предварительного рассмотрения плана.

We need to add authentication to the /settings route. Take a look at how this is
handled in the /notes route in @packages/functions/src/notes.ts and implement
the same logic in @packages/functions/src/settings.ts

Убедитесь, что предоставили достаточно деталей, чтобы aicippy-code внес корректные изменения.


Отмена изменений

Допустим, вы просите aicippy-code внести некоторые изменения.

Can you refactor the function in @packages/functions/src/api/index.ts?

Но вы понимаете, что это не то, чего вы хотели. Вы можете отменить изменения с помощью команды /undo.

/undo

aicippy-code отменит внесенные вами изменения и покажет исходное сообщение. снова.

Can you refactor the function in @packages/functions/src/api/index.ts?

Отсюда вы можете настроить подсказку и попросить aicippy-code повторить попытку.

Или вы можете повторить изменения с помощью команды /redo.

/redo

Общий доступ

Разговорами, которые вы ведете с aicippy-code, можно поделиться с вашей командой.

/share

Это создаст ссылку на текущий разговор и скопирует ее в буфер обмена.

Вот пример диалога с aicippy-code.


Настроить

И все! Теперь вы профессионал в использовании aicippy-code.

Чтобы создать свою собственную, мы рекомендуем выбрать тему, настроить привязки клавиш, настроить средства форматирования кода, создать собственные команды или поиграться с файлом aicippy-code config.