Install the terminal command
On macOS or Linux, with Python 3.9 or newer:
curl -fsSL https://aithatsee.com/utah/install.sh | sh
On Windows 10 or 11, in PowerShell:
irm https://aithatsee.com/utah/install.ps1 | iex
Then open a new terminal and run utah. utah --version and utah --doctor check the installation, and running the install command again updates it. Every step is on Terminal setup.
Connect through the API
One UTAH_API_KEY works with these endpoints:
| Tool | Endpoint |
|---|---|
| Claude Code | /utah/v1/messages |
| Codex CLI | /utah/v1/responses |
| OpenAI SDKs | /utah/v1/chat/completions |
| Gemini CLI | /utah/v1beta/models/* |
| MCP clients | /utah/mcp |
The reference is on Developers, with the OpenAPI specification.
Create an API key
Open Utah API in your workspace sidebar, give the key a name, choose its access, Model requests or Models, browser and hosted terminal, and choose Create API key. The key is shown once, so copy it then. You can create up to 20 named keys.
Status codes to handle
| Code | Meaning |
|---|---|
| 402 | Usage allocation required. |
| 428 | The account owner must accept the model-use acknowledgment in the Utah web workspace. |
| 429 | Honor Retry-After. Never loop-retry billable completions. |
