Скрипт установки в один клик
Одна команда для полной настройки 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
Interface language / Язык интерфейса¶
# macOS / Linux
curl -fsSL https://qcode.cc/install/claude-code.sh | bash -s -- --lang en
# Windows PowerShell
$env:QCODE_LANG='en'; irm https://qcode.cc/install/claude-code.ps1 | iex
--lang zh / --lang en. Same for codex.
Конфигурация записывается в файл настроек 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
No irm / blocked by execution policy¶
In CMD (Command Prompt):
powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://qcode.cc/install/claude-code.ps1 | iex"
Double-click, or iex blocked by policy:
curl -fsSL https://qcode.cc/install/claude-code.cmd -o "%TEMP%\qcode.cmd" && "%TEMP%\qcode.cmd"
For future PowerShell sessions (no admin rights needed):
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned
Особенности версии для 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) Задаёт модель по умолчанию, пропуская меню выбора |
--lang <zh\|en> |
Interface language (default: system locale) |
--target <app\|cli> |
(codex only) Config only / also install the CLI |
--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 / прав администратора и не пишет ни в какие системные каталоги
- "The API key contains invalid characters" — quotes / spaces / smart punctuation were pasted with the key. Copy it again from the dashboard
- "You are running this script with sudo" — sudo is not needed; it writes the config into root's home. Re-run without sudo
- "Config was written, but verification did not pass" — config files are in place, only the final connectivity check failed. Fix per the status code and re-run
Codex: desktop App or CLI¶
The script asks which client you use:
- Codex desktop App (default) — config files only, no Node.js / CLI install
- Codex CLI — also applies to the App; installs Node.js and the CLI as needed
Non-interactive: --target app / --target cli (Windows: -Target app / -Target cli).
⚠️
~/.codex/config.tomlis overwritten as a whole. Existing MCP servers / profiles are not preserved; restore them from the.bak.<timestamp>backup in the same directory.