canonical_url: https://yycode.net/docs/ru/auto-config-tool lang: ru updated_at: 2026-07-04T13:33:48.616Z source_html: https://yycode.net/docs/ru/auto-config-tool # Инструмент автоматической настройки YYCode Эта статья решает одну задачу: одной командой установить `Claude Code` или `Codex` и подключить их к `YYCode`. Даже если на вашем компьютере еще нет Node.js, можно продолжать настройку. --- ## 1. Создайте API Key Во время выполнения скрипт попросит ввести API Key, поэтому заранее создайте его в консоли YYCode. Войдите в [консоль YYCode](https://yycode.net/console/token), откройте страницу **Управление токенами** и нажмите **Добавить токен**. ![](https://r2.yycode.net/yycode/i9bq1Ik.png) ![](https://r2.yycode.net/yycode/9KXR1Ik.png) Заполните имя ключа и выберите группу в зависимости от инструмента: - Настройка **Claude Code**: выберите группу, связанную с Claude - Настройка **Codex**: выберите группу `codex` - Настройка обоих инструментов: нужно создать два отдельных Key, каждый для соответствующей группы выше IP-белый список, лимит квоты, ограничение моделей и срок действия можно настроить по необходимости. Новичкам рекомендуется использовать настройки по умолчанию. После создания нажмите в списке кнопку **Копировать** рядом с ключом, чтобы получить полный API Key, и позже вставьте его в интерактивном вводе скрипта. > **Совет по безопасности**: API Key эквивалентен учетным данным аккаунта. Храните его бережно, не отправляйте в репозиторий кода и не публикуйте. --- ## 2. Рекомендуемое использование ### macOS / Linux Выполните напрямую: ```bash curl -fsSL https://yycode.net/auto-config/install.sh | bash ``` Скрипт автоматически выполнит следующие действия: - Проверит, есть ли в текущей системе доступный Node.js - Если нет, установит локальный runtime Node.js в каталог текущего пользователя - Переключит зеркало npm на китайский источник, чтобы снизить вероятность сбоя загрузки без прокси - Установит `Claude Code` и `Codex` - Запишет соответствующие конфигурационные файлы - В конце выполнит проверку версий, чтобы убедиться, что команды запускаются ### Windows PowerShell Выполните напрямую: ```powershell irm https://yycode.net/auto-config/install.ps1 | iex ``` --- ## 3. Часто используемые параметры Если нужен полностью неинтерактивный запуск, можно сразу указать параметры в команде. > **Внимание:** Claude Code и Codex используют разные API Key. При настройке `all` нужно отдельно предоставить два Key. ### Настроить только Claude Code macOS / Linux: ```bash curl -fsSL https://yycode.net/auto-config/install.sh | bash -s -- --api-key YOUR_CLAUDE_KEY --tools claude ``` Windows PowerShell (передача параметров в режиме pipeline через переменные окружения): ```powershell $env:YYCODE_CLAUDE_API_KEY='YOUR_CLAUDE_KEY'; $env:YYCODE_TOOLS='claude'; irm https://yycode.net/auto-config/install.ps1 | iex ``` Windows PowerShell (скачать и выполнить напрямую): ```powershell .\install.ps1 --api-key YOUR_CLAUDE_KEY --tools claude ``` ### Настроить только Codex macOS / Linux: ```bash curl -fsSL https://yycode.net/auto-config/install.sh | bash -s -- --codex-api-key YOUR_CODEX_KEY --tools codex ``` Windows PowerShell (pipeline-режим): ```powershell $env:YYCODE_CODEX_API_KEY='YOUR_CODEX_KEY'; $env:YYCODE_TOOLS='codex'; irm https://yycode.net/auto-config/install.ps1 | iex ``` Windows PowerShell (скачать и выполнить напрямую): ```powershell .\install.ps1 --codex-api-key YOUR_CODEX_KEY --tools codex ``` ### Настроить Claude Code и Codex одновременно macOS / Linux: ```bash curl -fsSL https://yycode.net/auto-config/install.sh | bash -s -- --api-key YOUR_CLAUDE_KEY --codex-api-key YOUR_CODEX_KEY ``` Windows PowerShell (pipeline-режим): ```powershell $env:YYCODE_CLAUDE_API_KEY='YOUR_CLAUDE_KEY'; $env:YYCODE_CODEX_API_KEY='YOUR_CODEX_KEY'; irm https://yycode.net/auto-config/install.ps1 | iex ``` Windows PowerShell (скачать и выполнить напрямую): ```powershell .\install.ps1 --api-key YOUR_CLAUDE_KEY --codex-api-key YOUR_CODEX_KEY ``` ### Пользовательский API-адрес Если вы развернули собственный домен, можно переопределить адрес по умолчанию: ```bash curl -fsSL https://yycode.net/auto-config/install.sh | bash -s -- --api-key YOUR_CLAUDE_KEY --base-url https://your-domain.example.com ``` --- ## 4. Какие файлы записывает скрипт ### Claude Code Скрипт запишет: ```text ~/.claude/settings.json ``` Ключевые поля: ```json { "env": { "ANTHROPIC_BASE_URL": "https://yycode.net", "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY" } } ``` ### Codex Скрипт запишет: ```text ~/.codex/auth.json ~/.codex/config.toml ``` `auth.json`: ```json { "auth_mode": "apikey", "OPENAI_API_KEY": "YOUR_API_KEY" } ``` `config.toml`: ```toml model_provider = "yycode" model = "gpt-5.5" network_access = "enabled" [model_providers.yycode] name = "yycode" base_url = "https://yycode.net/v1" wire_api = "responses" requires_openai_auth = true ``` --- ## 5. Нужны ли права администратора? По умолчанию не нужны. Скрипт в первую очередь использует уже установленный системный Node.js; если его нет, он устанавливает Node.js в каталог текущего пользователя: - macOS / Linux: `~/.yycode/node` - Windows: `%USERPROFILE%\.yycode\node` Клиентские пакеты также устанавливаются в каталог текущего пользователя, а не глобально в систему. --- ## 6. Что сделать после первого запуска ### macOS / Linux После завершения скрипта рекомендуется выполнить: ```bash source ~/.zshrc ``` Если вы используете не `zsh`, выполните `source` для фактического profile-файла, который скрипт вывел в конце. ### Windows Достаточно заново открыть окно PowerShell. --- ## 7. Как убедиться, что все успешно ### Claude Code ```bash claude --version ``` ### Codex ```bash codex --version ``` Если команда выводит номер версии, обычно это означает, что цепочка установки уже работает. --- ## 8. Резервные копии и откат Если на вашем компьютере уже есть старая конфигурация, скрипт перед первым перезаписыванием автоматически создаст резервную копию `.bak`, например: - `~/.claude/settings.json.bak` - `~/.codex/auth.json.bak` - `~/.codex/config.toml.bak` Если нужен откат, просто восстановите соответствующий файл `.bak`. --- ## 9. Частые вопросы ### В Windows появляется сообщение, что нужен git-bash Claude Code в Windows зависит от git-bash. Скрипт автоматически проверит и установит Git for Windows (с приоритетной загрузкой с китайского зеркала npmmirror), вручную ничего делать не нужно. ### Как передавать параметры в pipeline-режиме Windows (`irm | iex`) После `irm ... | iex` **нельзя напрямую добавлять параметры**. Их нужно передавать через переменные окружения: ```powershell $env:YYCODE_TOOLS='claude'; $env:YYCODE_CLAUDE_API_KEY='YOUR_KEY'; irm https://yycode.net/auto-config/install.ps1 | iex ``` Если переменные окружения не переданы, скрипт интерактивно попросит ввести API Key. ### Если нет прокси, скрипт сможет работать? По умолчанию скрипт сначала использует китайские зеркала: - Node.js сначала скачивается с `npmmirror` - npm registry по умолчанию переключается на `https://registry.npmmirror.com` Если зеркало не сработает, скрипт попробует официальный источник. ### Я хочу только записать конфигурацию, без установки клиента Можно добавить: ```bash --skip-client-install ``` Подходит, если у вас уже установлен `claude` или `codex`, и нужно только заново записать конфигурационные файлы. ### API-адрес не `https://yycode.net` Используйте `--base-url`, чтобы переопределить адрес. ### Что делать, если старая конфигурация была перезаписана? Сначала проверьте файлы резервных копий `.bak` в том же каталоге. Первая версия скрипта уже оставляет путь отката для перезаписи конфигурации. --- ## 10. Следующий шаг - Хотите ручную установку и пошаговое объяснение: продолжайте читать [Руководство быстрого старта Claude Code](claude-code-quickstart) и [Руководство быстрого старта Codex](codex-quickstart) - Локальное окружение еще не готово: смотрите [Руководство по установке окружения Node.js](nodejs-setup) - Столкнулись с другими частыми проблемами: смотрите [Частые вопросы](faq)