Ручное подключение Codex и Claude

Этот путь подходит, если вы хотите сами скопировать настройки. Для автоматического варианта используйте установщик NeuroAPI; если уже была неудачная попытка, сначала откройте восстановление подключения. Перед правкой сохраните копию существующего файла. Не вставляйте ключ в TOML, JSON, скрипт или команду, которая останется в истории терминала.

Везде ниже нужен обычный ключ NeuroAPI целиком, включая sk-, и модель, доступная вашему ключу. gpt-6-sol и claude-opus-5-5 — примеры: если модель не входит в ваш тариф или ограничения ключа, замените её точным ID из каталога. Слова Bearer в поле ключа быть не должно.

1. Введите ключ только в текущий терминал

На macOS откройте Terminal и вставьте блок. Ввод ключа не отображается:

printf 'Вставьте ключ NeuroAPI и нажмите Enter: '
read -r -s NEUROAPI_API_KEY
printf '\n'
export NEUROAPI_API_KEY

На Windows откройте PowerShell и вставьте блок. Не используйте setx для записи ключа в постоянную переменную:

$secure = Read-Host 'Ключ NeuroAPI' -AsSecureString
$ptr = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($secure)
try { $env:NEUROAPI_API_KEY = [Runtime.InteropServices.Marshal]::PtrToStringBSTR($ptr) }
finally { [Runtime.InteropServices.Marshal]::ZeroFreeBSTR($ptr) }
Remove-Variable secure, ptr

После проверки закройте это окно терминала. Переменная из него не попадёт автоматически в уже запущенное графическое приложение.

2. Codex CLI: скопируйте профиль

Создайте файл ~/.codex/neuroapi-manual.config.toml на macOS или %USERPROFILE%\.codex\neuroapi-manual.config.toml на Windows. Если задан CODEX_HOME, используйте его вместо стандартной папки. Пользовательский профиль Codex не должен находиться в .codex вашего проекта.

Сначала сохраните каталог моделей, полученный с тем же ключом. На macOS:

mkdir -p "$HOME/.codex"
umask 077
printf 'url = "https://codex.neuroapi.host/v1/models"\nheader = "Authorization: Bearer %s"\n' "$NEUROAPI_API_KEY" |
  curl --config - --fail --silent --show-error --output "$HOME/.codex/neuroapi-manual-models.json"

На Windows, в том же PowerShell, где ввели ключ:

$codexHome = Join-Path $env:USERPROFILE '.codex'
New-Item -ItemType Directory -Force $codexHome | Out-Null
Invoke-WebRequest -UseBasicParsing -Uri 'https://codex.neuroapi.host/v1/models' `
  -Headers @{ Authorization = "Bearer $env:NEUROAPI_API_KEY" } `
  -OutFile (Join-Path $codexHome 'neuroapi-manual-models.json')

Откройте файл профиля обычным текстовым редактором и вставьте весь блок ниже. Замените только model_catalog_json на полный путь к сохранённому JSON: например, /Users/anna/.codex/neuroapi-manual-models.json или C:/Users/Anna/.codex/neuroapi-manual-models.json. Если gpt-6-sol недоступна, замените и model на ID из ответа каталога.

model = "gpt-6-sol"
model_provider = "neuroapi_manual"
model_catalog_json = "/ПОЛНЫЙ/ПУТЬ/neuroapi-manual-models.json"
web_search = "disabled"

[features]
multi_agent = false
goals = false
apps = false
browser_use = false

[model_providers.neuroapi_manual]
name = "NeuroAPI"
base_url = "https://codex.neuroapi.host/v1"
wire_api = "responses"
supports_websockets = true
env_key = "NEUROAPI_API_KEY"

Запустите из того же терминала codex --profile neuroapi-manual. В клиенте выполните /debug-config: должен быть provider neuroapi_manual и адрес https://codex.neuroapi.host/v1. Если соединение WebSocket не проходит, поменяйте supports_websockets = false в этом файле и повторите короткий запрос через HTTP/SSE. При смене ключа заново сохраните каталог моделей.

3. Claude Code CLI: скопируйте команды

В том же терминале, где задан NEUROAPI_API_KEY, вставьте команды для своей ОС. На macOS:

export ANTHROPIC_BASE_URL="https://claude.neuroapi.host"
export ANTHROPIC_AUTH_TOKEN="$NEUROAPI_API_KEY"
export ANTHROPIC_MODEL="claude-opus-5-5"
export ANTHROPIC_DEFAULT_HAIKU_MODEL="claude-haiku-4-5"
export CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY="1"
claude

На Windows PowerShell:

$env:ANTHROPIC_BASE_URL = 'https://claude.neuroapi.host'
$env:ANTHROPIC_AUTH_TOKEN = $env:NEUROAPI_API_KEY
$env:ANTHROPIC_MODEL = 'claude-opus-5-5'
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL = 'claude-haiku-4-5'
$env:CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY = '1'
claude

ANTHROPIC_MODEL выбирает основную модель, а ANTHROPIC_DEFAULT_HAIKU_MODEL задаёт модель Haiku для фоновых задач Claude Code. Фоновые запросы оплачиваются по обычным ценам выбранной модели. Обе модели должны быть доступны вашему ключу; при ограничении списка моделей включите в него claude-haiku-4-5.

Замените claude-opus-5-5, если ключ видит другую Claude-модель. В Claude Code выполните /status: там должен быть адрес NeuroAPI и источник ключа из текущего окружения; затем проверьте /model. Если адрес остался старым, посмотрите ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_API_KEY и ~/.claude/settings.json: настройки env в файле Claude Code могут перекрыть значения из терминала. Не вставляйте ключ в проектный .claude/settings.json. Для постоянного запуска с защищённым helper используйте инструкцию установщика.

4. Codex Desktop: пользовательский файл и защищённый helper

Графический Codex читает пользовательский %USERPROFILE%\.codex\config.toml на Windows или ~/.codex/config.toml на macOS. Сначала сделайте его копию. Если ранее подключали NeuroAPI, измените существующие model, model_provider и [model_providers.<id>]; не вставляйте второй экземпляр этих ключей. Профиль CLI из шага 2 сам по себе не переключает GUI. На Windows Codex Desktop и CLI в WSL используют разные домашние папки.

Для обычного GUI-запуска нужен helper, читающий ключ из защищённого хранилища. Установщик создаёт его автоматически. Если создаёте вручную, выполните следующие шаги.

macOS: в Terminal сохраните ключ в login Keychain. Команда запросит его скрытым вводом:

security add-generic-password -U -a "$USER" -s neuroapi-codex-manual -w

Создайте файл ~/.codex/neuroapi-key-helper.sh с этим содержимым и выполните chmod 700 ~/.codex/neuroapi-key-helper.sh:

#!/bin/sh
account=$(/usr/bin/id -un)
exec /usr/bin/security find-generic-password -a "$account" -s neuroapi-codex-manual -w

В ~/.codex/config.toml добавьте или обновите записи ниже. Замените оба пути /Users/ИМЯ/... на свой полный путь и убедитесь, что каталог моделей из шага 2 существует:

model = "gpt-6-sol"
model_provider = "neuroapi"
model_catalog_json = "/Users/ИМЯ/.codex/neuroapi-manual-models.json"

[model_providers.neuroapi]
name = "NeuroAPI"
base_url = "https://codex.neuroapi.host/v1"
wire_api = "responses"
supports_websockets = false

[model_providers.neuroapi.auth]
command = "/bin/sh"
args = ["/Users/ИМЯ/.codex/neuroapi-key-helper.sh"]
timeout_ms = 5000
refresh_interval_ms = 300000

Windows: в PowerShell сохраните ключ в DPAPI-хранилище текущего пользователя:

$codexHome = Join-Path $env:USERPROFILE '.codex'
New-Item -ItemType Directory -Force $codexHome | Out-Null
(Read-Host 'Ключ NeuroAPI' -AsSecureString | ConvertFrom-SecureString) |
  Set-Content -LiteralPath (Join-Path $codexHome 'neuroapi-manual-key.dpapi') -Encoding ASCII

Создайте файл %USERPROFILE%\.codex\neuroapi-key-helper.ps1 со следующим содержимым:

$ErrorActionPreference = 'Stop'
$path = Join-Path $env:USERPROFILE '.codex\neuroapi-manual-key.dpapi'
$secret = (Get-Content -LiteralPath $path -Raw).Trim() | ConvertTo-SecureString
$ptr = [Runtime.InteropServices.Marshal]::SecureStringToBSTR($secret)
try { [Console]::Write([Runtime.InteropServices.Marshal]::PtrToStringBSTR($ptr)) }
finally { [Runtime.InteropServices.Marshal]::ZeroFreeBSTR($ptr) }

В %USERPROFILE%\.codex\config.toml добавьте или обновите блок. Замените оба вхождения ИМЯ на имя вашей папки в C:\Users\ и при необходимости модель. Используйте прямые слеши в TOML:

model = "gpt-6-sol"
model_provider = "neuroapi"
model_catalog_json = "C:/Users/ИМЯ/.codex/neuroapi-manual-models.json"

[model_providers.neuroapi]
name = "NeuroAPI"
base_url = "https://codex.neuroapi.host/v1"
wire_api = "responses"
supports_websockets = false

[model_providers.neuroapi.auth]
command = "powershell.exe"
args = ["-NoLogo", "-NoProfile", "-NonInteractive", "-ExecutionPolicy", "Bypass", "-File", "C:/Users/ИМЯ/.codex/neuroapi-key-helper.ps1"]
timeout_ms = 5000
refresh_interval_ms = 300000

Полностью закройте Codex Desktop, откройте снова и создайте новую локальную задачу. Если новая ошибка всё ещё указывает на chatgpt.com/backend-api/codex/responses, активен другой provider или приложение читает другой пользовательский файл. В истории NeuroAPI должен появиться выполненный модельный запрос; сам список моделей этого не доказывает.

5. Claude Desktop: заполните поля в приложении

Для этого клиента не нужно редактировать JSON или TOML. Откройте Help → Troubleshooting → Enable Developer Mode, затем Developer → Configure Third-Party Inference и скопируйте значения:

Сохраните настройку, откройте новую Local сессию во вкладке Code и выберите модель, доступную ключу. ANTHROPIC_BASE_URL и ~/.claude/settings.json относятся к Claude Code CLI и не переключают этот GUI. Если поля заблокированы политикой организации, обратиться нужно к администратору устройства. Подробности: Claude Desktop.

6. Проверьте реальную задачу

Попросите клиента создать небольшой index.html в тестовой папке, проверьте файл и следующий ход с его чтением. Сверьте время и модель в истории запросов NeuroAPI. Если запрос не появился, проверьте конфигурацию и источник ключа; если появился с ошибкой, сохраните её безопасный код и следуйте руководству восстановления. Не отправляйте в поддержку ключ, содержимое helper или рабочие файлы.

Источники: провайдеры и профили Codex, Claude Code gateway, Claude Desktop gateway.