canonical_url: https://yycode.net/docs/ru/codex-quickstart
lang: ru
updated_at: 2026-07-04T13:33:48.616Z
source_html: https://yycode.net/docs/ru/codex-quickstart

# yycode × Codex: руководство быстрого старта

## Предварительное условие: установка окружения Node.js

Codex зависит от среды выполнения Node.js. Сначала установите и проверьте ее по инструкции [Руководство по установке окружения Node.js](nodejs-setup).

## Более простой способ: автоматическая настройка

Если вы не хотите устанавливать вручную и по пунктам прописывать конфигурацию, рекомендуем сразу использовать [инструмент автоматической настройки](auto-config-tool).

---

## 1. Установите Codex

```bash
# Windows
npm install -g @openai/codex@latest

# macOS / Linux
sudo npm install -g @openai/codex@latest
```

Проверьте установку:

```bash
codex --version
```

Если выводится номер версии, установка успешна.

---

## 2. Создайте API Key

Войдите в [консоль yycode](https://yycode.net/console/token), откройте страницу **Управление токенами** и нажмите **Добавить токен**.

![](https://r2.yycode.net/yycode/i9bq1Ik.png)
![](https://r2.yycode.net/yycode/9KXR1Ik.png)

Заполните имя ключа, выберите группу Codex (модель и коэффициент), при необходимости настройте IP-ограничение, лимит квоты, ограничение моделей и срок действия. Новичкам рекомендуется использовать настройки по умолчанию.

> **Совет по безопасности**: API Key эквивалентен учетным данным аккаунта. Храните его бережно, не отправляйте в репозиторий кода и не публикуйте.

---

## 3. Импортируйте ключ в Codex



#### Создайте каталог конфигурации

```powershell
# Windows (PowerShell)
if (Test-Path "$env:USERPROFILE\.codex") { Remove-Item -Recurse -Force "$env:USERPROFILE\.codex" }
mkdir "$env:USERPROFILE\.codex"
```

```bash
# macOS / Linux
rm -rf ~/.codex && mkdir -p ~/.codex
```

#### Создайте `config.toml`

В каталоге `~/.codex/` (для Windows это `%USERPROFILE%\.codex\`) создайте `config.toml`:

```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:

![](https://r2.yycode.net/yycode/EDOv1Ik.png)

В том же каталоге создайте `auth.json` и замените `YOUR_API_KEY` на ключ, созданный в консоли:

```json
{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "Здесь вставьте API Key, созданный на платформе"
}
```

---

## 4. Начните использовать

Перейдите в любой каталог проекта и выполните:

```bash
codex
```

Codex автоматически проанализирует код текущего каталога и предоставит интеллектуальную помощь в программировании. Больше сценариев смотрите в [официальной документации OpenAI](https://github.com/openai/codex).

---

## Частые вопросы (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](https://yycode.net/console/token), обновляйте Key в `auth.json` или быстро переключайтесь между конфигурациями через CC Switch.