Bohdan Triapitsyn
98b5ea2055
Adds new integrations docs for Claude Code, Command Code, and Cursor Links the Providers pages to the new integrations guide Updates the docs sidebar with localized integrations navigation
63 lines
2.7 KiB
Plaintext
63 lines
2.7 KiB
Plaintext
---
|
|
title: Providers, Models & Agents
|
|
description: Connect AI providers, pick models, and set up agents.
|
|
---
|
|
|
|
# Providers, Models & Agents
|
|
|
|
Before OpenChamber can do anything, it needs at least one AI provider connected. This page covers connecting a provider, choosing a model, and tailoring agents.
|
|
|
|
## Connect a provider
|
|
|
|
1. Open **Settings → Providers**.
|
|
2. Open the **Add provider** menu and pick a provider that isn't connected yet, or choose **Other / Custom** for an OpenAI-compatible endpoint.
|
|
3. Sign in one of two ways, depending on the provider:
|
|
- **API key** — paste your key and save.
|
|
- **Sign-in (device flow)** — OpenChamber shows a link and a short code. Open the link, enter the code, and approve. OpenChamber finishes connecting on its own.
|
|
|
|
### Custom / Other providers
|
|
|
|
For gateways, campus LLMs, Ollama, LiteLLM, and similar OpenAI-compatible APIs:
|
|
|
|
1. Choose **Other / Custom** in the provider list.
|
|
2. Enter a provider ID, display name, base URL (`http://` or `https://`), API key (or `{env:VAR_NAME}`), and at least one model id/name.
|
|
3. Optionally add request headers.
|
|
4. Save — OpenChamber writes the provider block to OpenCode config and stores the key in OpenCode auth (literal keys) or records an `{env:VAR}` reference.
|
|
5. To change an existing custom provider, open it and choose **Edit**.
|
|
|
|
Custom providers require an API key or `{env:VAR_NAME}` before they show as fully connected. Without credentials, models may appear but chat calls will fail.
|
|
|
|
When a provider shows as connected, its models become available in chat.
|
|
|
|
To disconnect, open the provider and choose to remove its sign-in.
|
|
|
|
## Pick a model
|
|
|
|
You pick the model where you're working:
|
|
|
|
- in chat, use the model picker in the message bar to set the provider and model for that session
|
|
- per agent, set a default model (below)
|
|
|
|
## Set up agents
|
|
|
|
An agent is a named setup — a model, a personality, and what it's allowed to do.
|
|
|
|
1. Open **Settings → Agents**.
|
|
2. Pick an agent, or create a new one.
|
|
3. Edit any of:
|
|
- **description** — what the agent is for
|
|
- **model** — its default model
|
|
- **temperature** — how creative its answers are
|
|
- **prompt** — standing instructions it always follows
|
|
- **tool rules** — which tools it may use
|
|
|
|
## Where your sign-ins live
|
|
|
|
Provider sign-ins are stored by OpenCode, not OpenChamber, so they're shared with the OpenCode CLI. If you set the same provider in more than one place, the most specific setting wins: a per-project setting overrides your personal one.
|
|
|
|
## Related
|
|
|
|
- [Integrations](/integrations/) — use a Claude, Command Code, or Cursor subscription as a provider
|
|
- [MCP Servers](/mcp/) — add extra tools for agents
|
|
- [Usage & Quotas](/usage/) — track how much you've used
|