Скрипт установки в один клик
Одна команда для полной настройки Claude Code / Codex: выбор самого быстрого endpoint, запись конфигурации, установка CLI и проверка соединения — без sudo и прав администратора
Скрипт установки в один клик¶
Одна команда — и всё готово к работе: скрипт автоматически измеряет скорость и выбирает самый быстрый endpoint, запрашивает API-ключ, записывает конфигурацию, при необходимости устанавливает Node.js и CLI, а в конце отправляет минимальный запрос для проверки соединения. Сначала выберите свою операционную систему:
📖 Перед запуском подготовьте API-ключ с префиксом
cr_в консоли QCode.cc; во время работы скрипт попросит вставить его (ввод не отображается на экране).
🍎 macOS / 🐧 Linux¶
Откройте терминал и вставьте команду (sudo не требуется):
Claude Code¶
curl -fsSL https://qcode.cc/install/claude-code.sh | bash
Codex¶
curl -fsSL https://qcode.cc/install/codex.sh | bash
Конфигурация записывается в файл настроек shell (управляемый блок в ~/.zshrc / ~/.bashrc) или в ~/.codex/; если Node.js отсутствует, он устанавливается через nvm в каталог пользователя.
🪟 Windows¶
Достаточно обычного PowerShell — без WSL и без прав администратора. Откройте «Терминал Windows» или PowerShell и вставьте команду:
Claude Code¶
irm https://qcode.cc/install/claude-code.ps1 | iex
Codex¶
irm https://qcode.cc/install/codex.ps1 | iex
Особенности версии для Windows:
- Конфигурация записывается в переменные окружения уровня пользователя (Codex — в
%USERPROFILE%\.codex\), старые значения автоматически сохраняются в резервную копию в%USERPROFILE%\.qcode\ - Если Node.js отсутствует, LTS-версия устанавливается через winget; если winget недоступен, скрипт подскажет, как установить вручную с nodejs.org
- После настройки конфигурация автоматически действует в новых окнах PowerShell / терминала; редакторы вроде VS Code нужно перезапустить один раз
- Если скрипт блокируется политикой выполнения, сначала выполните
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUserи повторите попытку
Что делает скрипт¶
- Выбор самого быстрого endpoint — отправляет по одному лёгкому запросу на каждый из четырёх endpoint (api / asia / us / eu) и рекомендует самый быстрый (выбор можно изменить вручную)
- Запись конфигурации — Claude Code: на macOS/Linux — управляемый блок в конфигурации shell, на Windows — переменные окружения уровня пользователя; Codex:
~/.codex/config.toml+auth.json(модель по умолчанию выбирается на месте, рекомендуетсяgpt-5.6-terra) - Установка окружения (можно пропустить) — проверяет наличие Node.js ≥ 20, при отсутствии устанавливает LTS-версию через nvm (macOS/Linux) или winget (Windows), затем устанавливает CLI командой
npm install -g; всё выполняется в каталоге пользователя - Проверка соединения — отправляет минимальный запрос с вашим ключом; при неудаче выдаёт целевые подсказки по устранению проблемы в зависимости от HTTP-кода состояния
- Резервное копирование перед записью — все изменяемые файлы сначала копируются в
.bak.<метка времени>; на Windows старые переменные окружения сохраняются в%USERPROFILE%\.qcode\
Неинтерактивный режим (CI / без подтверждений)¶
macOS / Linux:
curl -fsSL https://qcode.cc/install/claude-code.sh | bash -s -- --key cr_xxx --yes
| Параметр | Описание |
|---|---|
--key <cr_...> |
API-ключ; если указан, интерактивный ввод пропускается |
--domain <api\|asia\|us\|eu> |
Явно задаёт endpoint, пропуская замер скорости |
--model <id> |
(только codex.sh) Задаёт модель по умолчанию, пропуская меню выбора |
--yes / -y |
Все подтверждения принимают значения по умолчанию |
--no-install |
Только записать конфигурацию, не устанавливать Node / CLI |
--no-verify |
Пропустить проверку соединения |
--help |
Показать все параметры |
Вызов с параметрами на Windows (параметры соответствуют таблице выше: -Key, -Domain, -Model, -Yes, -NoInstall, -NoVerify):
& ([scriptblock]::Create((irm https://qcode.cc/install/claude-code.ps1))) -Key cr_xxx -Yes
(для codex.ps1 — аналогично)
Какие файлы записываются / как выполнить откат¶
| Инструмент / платформа | Куда записывается | Способ отката |
|---|---|---|
| Claude Code (macOS/Linux) | Управляемый блок # >>> qcode.cc claude-code >>> в ~/.zshrc или ~/.bashrc |
Удалить весь управляемый блок или восстановить из резервной копии .bak.<метка времени> в том же каталоге |
| Claude Code (Windows) | Переменные окружения уровня пользователя ×3 | Восстановить старые значения из %USERPROFILE%\.qcode\backup-*.json |
| Codex (все платформы) | ~/.codex/config.toml + ~/.codex/auth.json |
Восстановить из резервной копии .bak.<метка времени> в том же каталоге |
Повторный запуск скрипта всегда безопасен: управляемый блок обновляется на месте, а файлы конфигурации сначала копируются в резервную копию и только потом перезаписываются.
Частые вопросы¶
- Проверка возвращает 401 — ключ недействителен или истёк: сверьте его в консоли (убедитесь, что префикс
cr_скопирован полностью) и запустите скрипт заново - Проверка возвращает 404 — неверный адрес подключения: BASE_URL для Claude Code должен быть
https://{домен}/api, для Codex —https://{домен}/openai, без слэша в конце - Сетевой таймаут — запустите скрипт заново с другим endpoint (например,
--domain asia); статус всех endpoint в реальном времени — на probe.qcode.cc - После установки на Windows не находится команда claude / codex — откройте новое окно PowerShell (PATH обновляется только в новой сессии)
- Не хотите, чтобы скрипт устанавливал Node — добавьте
--no-install(Windows:-NoInstall), будет записана только конфигурация - Хотите сначала посмотреть содержимое скрипта — просто откройте https://qcode.cc/install/claude-code.sh и прочитайте исходный код; скрипт не требует sudo / прав администратора и не пишет ни в какие системные каталоги