> ## Documentation Index
> Fetch the complete documentation index at: https://docs.baseten.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Baseten Grid

> Connect your organization's coding agents to models on Baseten and frontier providers, with model access by team, monthly spend limits, and usage tracking.

> [!NOTE]
>
> Baseten Grid is in preview for enterprise organizations. Your Baseten account team enables it and sizes Model API capacity for your developers. To get started, [Contact us](mailto:support@baseten.co).

Baseten Grid connects your organization's coding agents to models on Baseten and connected providers. Admins choose each team's models and budgets; developers use the team's routes in Claude Code, Codex, OpenCode, or Pi.

## Get started

> [card] [Set up your organization](https://docs.baseten.co/grid/set-up.md)
>
> For admins: organize teams, connect providers, choose models, and set limits.

> [card] [Connect your coding agent](https://docs.baseten.co/grid/developers/set-up.md)
>
> For developers: build your setup command, select a team model, and verify the connection.

For IT and platform teams distributing Grid across machines, see [Roll out Grid to developers](https://docs.baseten.co/grid/roll-out.md).

## Where requests go

Setup changes the coding agent's model connection. The developer then uses the agent as usual, and its model requests go to Grid with a Grid API key.

```mermaid theme={"system"}
flowchart TD
    Agent["Coding agent"] -->|"Grid API key"| Grid["Team route on Grid"]
    Grid --> Baseten["Baseten Model APIs"]
    Grid -->|"Team connection"| Provider["Connected model provider"]
    classDef endpoint fill:#ecfdf5,stroke:#00a35a,color:#14532d
    class Agent,Grid,Baseten,Provider endpoint
```

On a direct route, Grid sends every request to the configured model. On an auto route, a managed classifier chooses among the route's allowed models and uses its default route when it makes no selection.

Baseten bills Model API usage. Connected providers bill usage to the account behind the team's provider key. Developers use their Grid API keys to call Grid; an admin manages the provider keys in **Connections**.

## How Grid works

1. **Choose each team's models.** Add open-weight models from Model APIs, frontier models from Anthropic, OpenAI, or xAI through your own API key, or both. Add an auto route when you want a classifier to choose among several models for each request. Developers select direct and auto routes from the same model picker.
2. **Set spend limits.** Set a monthly budget for each member and for the team as a whole, and raise one developer's limit when they need more. Grid meters spend every 15 minutes, so spend can exceed a limit before new requests are blocked. For more information, see [How spend limits work](https://docs.baseten.co/grid/manage.md#how-spend-limits-work).
3. **Let developers keep their workflow.** Each developer runs [`baseten grid setup`](https://docs.baseten.co/reference/cli/baseten/grid#setup) once. Their coding agent lists the team's models and keeps its shortcuts, MCP servers, and plugins.
4. **Track spend and usage.** See spend, tokens, and cache hit rate by team, developer, model, and provider, and adjust models and limits as your teams' needs change.

## Key terms

* **Route**: a named entry a coding agent can call. A direct route calls one model; an auto route chooses among several direct routes.
* **Connection**: provider credentials stored on a team, so the team's routes can call that provider's models.
* **Harness defaults**: the model each coding agent uses for its main work and for background tasks when a developer runs setup.
* **Spend limit**: a monthly cap, in USD, on a developer's or a team's Grid spend. Limits reset at the start of each UTC calendar month.
* **Grid API key**: the key `baseten grid setup` creates for coding agents on one machine. It's separate from a developer's personal Baseten API key, and spend limits apply to it.

## When to use Grid

Grid is for organizations that want central control over coding agent models and spend. For other cases:

* To connect your own coding agent to Model APIs without admin controls, use [Baseten Switch or a direct provider setup](https://docs.baseten.co/inference/model-apis/coding-agents.md).
* To give customers or applications access to models across providers with federated API keys, use [Frontier Gateway](https://docs.baseten.co/frontier-gateway/overview.md).