yycode × Codex: руководство быстрого старта
Предварительное условие: установка окружения Node.js
Codex зависит от среды выполнения Node.js. Сначала установите и проверьте ее по инструкции Руководство по установке окружения Node.js.
Более простой способ: автоматическая настройка
Если вы не хотите устанавливать вручную и по пунктам прописывать конфигурацию, рекомендуем сразу использовать инструмент автоматической настройки.
1. Установите Codex
# Windows
npm install -g @openai/codex@latest
# macOS / Linux
sudo npm install -g @openai/codex@latest
Проверьте установку:
codex --version
Если выводится номер версии, установка успешна.
2. Создайте API Key
Войдите в консоль yycode, откройте страницу Управление токенами и нажмите Добавить токен.


Заполните имя ключа, выберите группу Codex (модель и коэффициент), при необходимости настройте IP-ограничение, лимит квоты, ограничение моделей и срок действия. Новичкам рекомендуется использовать настройки по умолчанию.
Совет по безопасности: API Key эквивалентен учетным данным аккаунта. Храните его бережно, не отправляйте в репозиторий кода и не публикуйте.
3. Импортируйте ключ в Codex
Создайте каталог конфигурации
# Windows (PowerShell)
if (Test-Path "$env:USERPROFILE\.codex") { Remove-Item -Recurse -Force "$env:USERPROFILE\.codex" }
mkdir "$env:USERPROFILE\.codex"
# macOS / Linux
rm -rf ~/.codex && mkdir -p ~/.codex
Создайте config.toml
В каталоге ~/.codex/ (для Windows это %USERPROFILE%\.codex\) создайте config.toml:
model = "gpt-5.5"
model_provider = "yycode"
[model_providers.yycode]
name = "yycode New API"
base_url = "https://yycode.net/v1"
wire_api = "responses"
requires_openai_auth = true
Создайте auth.json
Нажмите кнопку Копировать рядом с ключом, чтобы получить API Key:

В том же каталоге создайте auth.json и замените YOUR_API_KEY на ключ, созданный в консоли:
{
"auth_mode": "apikey",
"OPENAI_API_KEY": "Здесь вставьте API Key, созданный на платформе"
}
4. Начните использовать
Перейдите в любой каталог проекта и выполните:
codex
Codex автоматически проанализирует код текущего каталога и предоставит интеллектуальную помощь в программировании. Больше сценариев смотрите в официальной документации OpenAI.
Частые вопросы (FAQ)
Q: При запуске npm install -g появляется сообщение о недостатке прав?
A: В macOS / Linux добавьте sudo перед командой; в Windows запустите PowerShell с правами администратора.
Q: codex --version сообщает, что команда не найдена?
A: Убедитесь, что глобальный каталог npm добавлен в системный PATH; можно выполнить npm bin -g, посмотреть путь и добавить его вручную.
Q: Подключение не удалось или возвращается ошибка 401?
A: Проверьте, что base_url в config.toml равен https://yycode.net, а API Key в auth.json корректен и не истек.
Q: Как переключать разные модели или коэффициенты?
A: Создавайте ключи разных групп в консоли yycode, обновляйте Key в auth.json или быстро переключайтесь между конфигурациями через CC Switch.