Обзор CLI-инструментов
CLI — это инструмент командной строки, а не какая-то одна программа. Claude Code, Codex CLI, Gemini CLI, OpenClaw и OpenCode относятся именно к этой категории: вы вводите запросы на естественном языке в терминале, а они могут читать проекты, анализировать код, создавать файлы, выполнять команды или помогать решать задачи разработки.
Официальная информация Актуальные файлы для загрузки и документация доступны на официальных сайтах.
Что такое CLI и для чего он нужен
Инструменты CLI мощнее обычных чат-ботов, но и вероятность ошибок при их использовании выше. Новичкам при первой настройке рекомендуется запускать их только в тестовых проектах и разрешать им «только анализировать, но не изменять код и не выполнять команды».
Что подготовить в первую очередь
| Элемент подготовки | Описание | Почему это важно |
|---|---|---|
| Терминал | В Windows используется PowerShell, в macOS / Linux — Terminal | CLI полностью работает в терминале |
| Сам инструмент | Сначала установите Claude Code, Codex CLI, Gemini CLI, OpenClaw или OpenCode | Файл конфигурации действует только для уже установленных инструментов |
| Ключ / Способ входа | Это может быть официальная авторизация, API-ключ, OAuth или ключ стороннего провайдера | У разных CLI способы аутентификации отличаются |
| Base URL | Требуется только при работе через провайдера или прокси | Суффикс адреса может различаться для разных протоколов, поэтому нельзя просто заменить доменное имя. |
| Тестовый проект | Создайте новую пустую папку или сделайте копию проекта. | Чтобы не испортить реальный рабочий проект при первой настройке |
URL-адреса в документации провайдеров обычно приведены для примера. При реальной настройке вам необходимо заменить их на адрес API и ключ, предоставленные вашим провайдером. Если провайдер предоставляет отдельные интерфейсы для OpenAI, Claude и Gemini, не смешивайте эти три адреса между собой.
Разделы по отдельным инструментам
Настройка Claude Code Ключ, Base URL, модель и файл settings.json для Claude Code.
Настройка Codex CLI Файл config.toml, кастомные провайдеры и способы тестирования терминального инструмента Codex.
Настройка Gemini CLI Нюансы входа через Google, API-ключей и использования сторонних провайдеров для Gemini CLI.
Настройка OpenClaw Поля baseUrl и api в OpenClaw настраиваются парами.
Настройка OpenCode Мастер подключения OpenCode, расположение файла конфигурации и тонкости ручной настройки.
Как выбрать нужную страницу
| Что вы хотите сделать | Рекомендуемый раздел | Почему |
|---|---|---|
| Централизованно переключать провайдеров для нескольких CLI | Общие шаги по CC-Switch | CC-Switch лучше всего подходит для централизованного управления провайдерами с последующей раздачей в такие инструменты, как Claude, Codex, Gemini и др. |
| Настроить только Claude Code | Настройка Claude Code | Для Claude Code обратите внимание на ключ, Base URL, название модели и settings.json для Anthropic / Claude |
| Настроить только Codex CLI | Настройка Codex | Для Codex обратите внимание на config.toml, OpenAI-совместимых провайдеров, название модели и переменные окружения |
| Настроить только Gemini CLI | Настройка Gemini | Способ входа, ключ и интерфейсы Vertex / Gemini отличаются от OpenAI-совместимых интерфейсов |
| Использовать OpenClaw / OpenCode | OpenClaw / OpenCode | Поля провайдеров в этих двух инструментах могут меняться от версии к версии, ориентируйтесь на соответствующую страницу и официальную документацию |
Риски, на которые стоит обратить внимание перед настройкой
| Риск | Где чаще всего возникает | Рекомендации |
|---|---|---|
| Инструменты могут читать файлы проекта | Claude Code, Codex, Gemini, OpenClaw, OpenCode | При первом запуске используйте тестовую директорию, не открывайте сразу реальные рабочие проекты |
| Модели могут выполнять или предлагать команды | Все CLI для работы с кодом | Сначала включите режим подтверждения действий и внимательно проверяйте операции удаления, перемещения, установки, выгрузки и т. д. |
| Параметры конфигурации переопределяют друг друга | Системные переменные окружения, конфигурация проекта, пользовательская конфигурация, CC-Switch | Если настройки не применяются, сначала проверьте приоритеты и не меняйте параметры сразу в нескольких местах одновременно |
| Смешивание разных протоколов | OpenAI, Claude, Gemini, Vertex, совместимые интерфейсы провайдеров | Заполняйте параметры инструмента строго в соответствии с тем протоколом, который предоставляет панель вашего провайдера |
| Копирование чужих примеров без изменений | Сторонние руководства, скриншоты, устаревшая документация | URL, ключ и название модели из примеров обязательно нужно заменить на данные из личного кабинета вашего провайдера |
Как провести первую проверку безопасности
После завершения настройки не разрешайте CLI сразу менять файлы реального проекта. Сначала создайте пустую папку, положите туда простой тестовый файл и поручите инструменту только прочитать и проанализировать его, без внесения изменений.
Тестовый запрос на проверку безопасности для CLI
Read only the current directory first. Tell me which files are here. Do not modify any files, run any commands, or install any dependencies.Если на этом этапе возникли ошибки, перейдите на страницу устранения неполадок. Не позволяйте CLI автоматически обрабатывать реальный проект, пока не убедитесь в успешной настройке.