# Codex CLI

Підключіть API AstroWay до **Codex CLI** через MCP. Codex використовує локальний stdio-пакет, налаштований у файлі TOML.

## Передумови

Отримайте API-ключ у [дашборді](https://api.astroway.info/dashboard/sign-up). Для безкоштовного тестування використовуйте sandbox-ключ `aw_test_*` — він не списує кредити.

## Підключення

Відредагуйте `~/.codex/config.toml`. Додайте блок нижче і **перезапустіть Codex CLI**. Автентифікація через env-змінну, працює офлайн:

<Code lang="toml" title="~/.codex/config.toml" code={`[mcp_servers.astroway]
command = "npx"
args = ["-y", "@astroway/mcp"]
env = { ASTROWAY_API_KEY = "aw_live_YOUR_KEY" }`} />

## Перевірка

Напишіть Codex у чаті: «Перелічи інструменти Astroway» — або попросіть викликати безкоштовний reference-інструмент, наприклад отримати список знаків зодіаку. Якщо у відповідь приходить результат, підключення працює.

## Усунення проблем

- **401 / invalid key** — переконайтеся, що ключ має префікс `aw_live_*` або `aw_test_*` і не відкликаний. Перевірити можна в [дашборді](https://api.astroway.info/dashboard/sign-up).
- **Інструменти не з'являються** — повністю перезапустіть Codex CLI і перевірте шлях до `~/.codex/config.toml`.
- **Помилки валідації `-32602`** — оновіть пакет: `npm i @astroway/mcp@latest`. Схеми перегенеровуються з актуальної специфікації.

Усі клієнти — [Налаштування агента](/agent-setup/).