Руководство по развертыванию Codex
Скачайте CC Switch для своей системы, укажите API-ключ Guishu AI и проверьте подключение по первому ответу в Codex CLI.
1. Скачайте и откройте CC Switch
В CC Switch вы укажете настройки API, а в Codex CLI сможете общаться с моделью из терминала. Выберите пакет CC Switch 4.0.25 для своего компьютера.
- Windows x64 · скачать MSI Подходит для большинства компьютеров с процессорами Intel и AMD. Дважды щёлкните скачанный файл
.msi, пройдите установку и откройте CC Switch из меню «Пуск». - Windows ARM64 · скачать MSI Выберите этот вариант, если в разделе «Параметры → Система → О системе» в строке «Тип системы» указан процессор ARM.
- macOS · скачать DMG Один пакет для Mac с процессорами Intel и чипами Apple. Откройте
.dmgдвойным щелчком, перетащите CC Switch в «Программы» и запустите его оттуда. - Linux · выбрать пакет Раскройте список Assets и выберите архитектуру по выводу
uname -m. Дляaarch64нужен пакетarm64. Для Ubuntu и Debian скачайте.deb, для Fedora —.rpm.
Скачали другой файл? В v3.12.2-en.md описаны изменения в версии. Если после распаковки виден только CC-SWITC.14, оставьте его расширение как есть и скачайте установщик для своей системы по ссылке выше. Другие версии доступны на официальной странице выпусков.
2. Установите Codex CLI
В Windows откройте командную строку, в macOS или Linux — терминал. Если Codex уже установлен, выполните codex --version. Появился номер версии? Переходите к шагу 3.
При первой установке сначала установите Node.js LTS, заново откройте терминал и выполните эти команды по очереди. Вторая выведет codex-cli и номер версии.
npm install -g @openai/codex@latest
codex --version3. Настройте Guishu AI в CC Switch
Выберите Codex на боковой панели. На вкладке Direct нажмите Add Provider (+) и выберите Custom Configuration в разделе All.
| Поле | Что указать |
|---|---|
| Имя провайдера | Введите «Guishu AI», чтобы легко найти его в списке. |
| Адрес API | https://api.llm-token.cn/v1. Сохраните /v1 в конце адреса. |
| API Key | Вставьте полный API-ключ, полученный в Guishu AI. |
| Модель по умолчанию | Скопируйте из списка моделей ID модели, которая поддерживает Responses и доступна с вашим ключом, например gpt-6.1-terra. |
Нажмите Add внизу страницы. Вернитесь на вкладку Direct и нажмите Switch на карточке Guishu AI. Если раньше использовалась маршрутизация или агрегация, кнопка будет называться «Back to direct and use». Когда на карточке появится In use, можно запускать Codex.
4. Получите первый ответ в терминале
Завершите текущий сеанс Codex, перейдите в терминале в каталог проекта и выполните codex. Если проекта ещё нет, создайте пустой каталог:
mkdir my-codex-project
cd my-codex-project
codexВ Codex введите «Ответь только OK». Полученный ответ подтверждает, что запрос выполнен. Тест расходует квоту вашего ключа.
Ответа нет? При ошибке 401 вставьте API-ключ ещё раз и убедитесь, что он активен. Если модель недоступна, проверьте её ID и права доступа ключа. Если не найден адрес API, проверьте, что URL заканчивается на /v1, а в дополнительных настройках выбран формат OpenAI Responses.
По желанию: настройка через файлы
Если после настройки в CC Switch вы уже получили ответ, всё готово. Для ручной настройки отредактируйте два файла в каталоге %USERPROFILE%\.codex\ в Windows или ~/.codex/ в macOS и Linux. Если каталога нет, создайте его. Перед изменением существующих файлов сделайте резервную копию и сохраните остальные настройки.
config.toml — укажите провайдера, адрес API и модель, доступную с вашим ключом.
model_provider = "gpt-agent"
model = "gpt-6.1-terra"
[model_providers.gpt-agent]
name = "LLM API Gateway"
base_url = "https://api.llm-token.cn/v1"
wire_api = "responses"
requires_openai_auth = trueauth.json — замените значение в примере своим API-ключом Guishu AI, сохраните файл и запустите Codex ещё раз, как в шаге 4.
{
"OPENAI_API_KEY": "YOUR_API_KEY"
}