API-ключ Codex VS Code: использование пользовательского эндпоинта

Что вы настраиваете

Помощники для кода в VS Code общаются с моделью по HTTP. Большинство использует формат API OpenAI, поэтому принимают пользовательский базовый URL и ключ вместо стандартных. Этот сервис совместим с OpenAI, поэтому подключается к любому инструменту с такой опцией.

Чётко понимайте, что находится на другой стороне. Это одна модель с открытыми весами от независимого провайдера, настроенная на ответы без отказов по контенту для законного использования взрослыми. Это не модель Codex от OpenAI и не официальный API другого вендора. Только текст, контекстное окно на 100 000 токенов, вызов функций и JSON-режим. Если нужны детали маршрутов в стиле OpenAI, прочитайте документацию; если нужен только адрес, см. страницу о базовом URL API Codex.

Вот три значения, которые нужно использовать везде:

Получите ключ и проверьте его

Создайте аккаунт на странице API-ключа через Google или по электронной почте и паролю. Новые пользователи могут получить $0,50 пробного баланса в один клик, действительный в течение 7 дней, без привязки карты. Затем проверьте ключ в терминале, прежде чем настраивать VS Code. Успешный вызов curl подтверждает корректность ключа и URL, так что последующие ошибки будут связаны с расширением.

Copy# macOS or Linux, add to ~/.zshrc or ~/.bashrc
export CODEX_API_KEY="YOUR_KEY"

# then verify the endpoint answers
curl https://api.getcodexapi.com/v1/chat/completions \
  -H "Authorization: Bearer $CODEX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a Python one-liner that reverses a string."}]}'

Ответ — JSON формата chat completions, и в ответе есть заголовок X-Balance-USD с оставшимся балансом. Храните ключ в переменной окружения или в хранилище секретов расширения, но не в репозитории.

Расширение Codex и CLI: файл конфигурации

Инструменты Codex от OpenAI поддерживают пользовательских провайдеров моделей через файл конфигурации TOML в домашнем каталоге, а расширение VS Code, согласно документации, использует эту конфигурацию совместно с CLI. Проверьте это по текущей документации Codex для вашей версии, так как формат эволюционировал.

Copy# ~/.codex/config.toml
model = "uncensored"
model_provider = "custom"

[model_providers.custom]
name = "Custom endpoint"
base_url = "https://api.getcodexapi.com/v1"
env_key = "CODEX_API_KEY"
wire_api = "chat"

Точки для проверки:

• base_url заканчивается на /v1, без добавления /chat/completions.
• env_key — это имя переменной окружения, а не сам ключ.
• wire_api определяет формат запроса. Этот сервис принимает как POST /v1/chat/completions, так и POST /v1/responses. Сначала попробуйте "chat"; используйте "responses", если ваша версия Codex требует этого.
• Запускайте VS Code из оболочки, в которой задана переменная, или перезапустите его после добавления переменной в ваш профиль. Запуск через графический интерфейс на macOS часто не видит экспорты оболочки.

Агентные инструменты полагаются на вызов функций. Это поддерживается здесь, включая потоковую передачу вызовов функций, но качество варьируется в зависимости от модели, поэтому сначала выполните небольшую задачу. На связанной странице использования API в Cursor описана аналогичная настройка в другом редакторе.

Continue, Cline и другие расширения

Сторонние расширения имеют свои экраны, но принцип тот же: выберите провайдер OpenAI или «OpenAI-совместимый», затем заполните базовый URL, ключ и модель. Continue использует конфигурацию YAML:

Copy# Continue (config.yaml), model entry
models:
  - name: Hosted uncensored
    provider: openai
    model: uncensored
    apiBase: https://api.getcodexapi.com/v1
    apiKey: YOUR_KEY

Cline и Roo Code предлагают провайдер «Совместимый с OpenAI» в панели настроек с теми же тремя полями. Названия и меню часто меняются, поэтому ищите в документации расширения «OpenAI compatible» или «custom base URL». Если в расширении нет поля для базового URL, оно не может использовать этот эндпоинт.

Советы, экономящие время:

• Отключите автодополнение по вкладкам для размещённой модели, если не хотите, чтобы запрос отправлялся при каждой паузе. Действия в чате и редактирование обходятся дешевле.
• Установите меньший контекст в расширении для повседневных правок. Отправка целых репозиториев модели стоит входные токены каждый раз.
• Используйте отдельный ключ для каждого инструмента, чтобы понимать, какой из них расходует ваш баланс.

Какие задачи редактора подходят этой модели

Общая текстовая модель с большим окном достаточно хорошо подходит для нескольких повседневных задач: объяснение незнакомого кода, написание модульных тестов для функции, конвертация скрипта между языками, черновик docstrings и регулярных выражений, а также переписывание модуля при вставке всего файла. Контекстное окно на 100 000 токенов позволяет вместить несколько средних файлов плюс ваши инструкции в один запрос, и модель может использовать всё, что осталось в контексте.

Будьте реалистичны в остальном. Это не специализированная модель для кода с обучением, учитывающим редактор, поэтому запуски агентов с несколькими файлами могут требовать больше указаний и проверок, чем инструменты, созданные для них. Запрашивайте диффы вместо целых файлов, проверяйте каждое изменение перед принятием и запускайте тесты. Если задача требует контента, который фильтрующий ассистент откажется писать, например, каркас для взрослой прозы или текст для исследований безопасности для законного использования, эндпоинт без отказов по контенту — причина использовать именно этот.

Сколько это стоит в редакторе

Цены: $0,15 за 1M входных токенов и $0,50 за 1M выходных токенов. Инструменты для кода отправляют много контекста, поэтому сначала смотрите на входные данные.

Пример: запрос на редактирование с контекстом файла в 8 000 токенов и ответом в 600 токенов стоит 8 000 x $0,15 / 1M + 600 x $0,50 / 1M = $0,0012 + $0,0003 = $0,0015. День из 150 таких запросов стоит 150 x $0,0015 = $0,225. Двадцать рабочих дней: $4,50.

Агент, читающий много файлов, может отправлять 40 000 токенов за шаг. При таком размере один шаг стоит $0,006 плюс вывод, поэтому 100 шагов стоят около $0,60 плюс вывод. Следите за циклами агентов. Неудачные или отклонённые запросы не тарифицируются, баланс не сгорает. Пополнения от $20 до $500 можно оплатить картой (Visa, Mastercard, Apple Pay, Google Pay) или криптовалютой. Текущие тарифы указаны на странице цен.

Устранение неполадок

401 Unauthorized

Ключ отсутствует, содержит лишний пробел или переменная окружения не видна для VS Code. Перезапустите редактор из терминала, где установлена переменная.

404 или «модель не найдена»

Используйте точную модель uncensored и базовый URL с /v1 в конце.

Ошибки 429

Полный ключ позволяет 8 параллельных запросов и 300 в минуту; пробный ключ позволяет 2 и 60. Расширение, отправляющее несколько параллельных запросов, например автодополнение плюс чат, может достичь лимита параллельности. Код ошибки concurrency для слишком большого количества одновременно и rate_limited для лимитов в минуту. Заголовок Retry-After: 5 означает временную перегрузку.

Потоковая передача зависает

Некоторые корпоративные прокси буферизируют события, отправляемые сервером. Протестируйте из другой сети или отключите потоковую передачу в расширении.

Ответы отличаются от того, что вы видели с другим ассистентом

Это ожидаемо. Это другая модель со своими сильными сторонами. Дайте чёткие, конкретные инструкции и протестируйте её на коде из вашего проекта.

Дополнительные руководства

• API Codex на Python: вызов языковой модели для кода
• Codex API Base URL: Как направить клиента на наш API