Practical guides · 08
Connect a cloud model with your own API key.
Paste a provider key once, keep it in the macOS Keychain, and let AITerm talk straight to that account — without an AITerm proxy in the middle.
4 minute read
Local Ollama keeps requests on your Mac. Sometimes you want a cloud model instead: a harder question, a model you already pay for, or a day when the local engine is not ready. AITerm’s Free tier supports that through bring-your-own-key (BYOK) presets. You bring the account; AITerm stores the key in the Keychain and sends each request from your Mac to the provider you chose.
1. Know what “your own key” means.
A BYOK connection uses an API key from a provider’s own dashboard — for example an OpenAI sk-… key or an Anthropic sk-ant-… key. AITerm does not issue these keys and does not proxy the traffic through an AITerm server. The request goes from your Mac to that provider, authenticated with your account. The provider’s own terms and usage charges apply.
Built-in Free presets include OpenAI, Anthropic (Claude), OpenRouter, Groq, DeepSeek, Mistral, xAI, Gemini, Perplexity and several others listed in Settings ▸ AI. A Custom OpenAI-compatible… connection is also Free if you point at your own server. Azure OpenAI, Amazon Bedrock, managed MLX and Claude Code / Codex subscription doors are Pro and are not covered here.
2. Use the setup door for OpenAI or Claude.
On first launch — or whenever you reopen the AI setup sheet — look for Paste an OpenAI or Claude key. Choose the provider, paste the key, and click Save key & check. The first time, AITerm asks once whether it may use a cloud model. The key is saved in the macOS Keychain, sent only to that provider, used to pick a model, and checked. A wrong key says so right there.
If the connection is waiting for your OK to use a cloud model, the sheet offers Allow cloud use…. It shows what is sent and where it goes before you agree. Use the cloud model (or Return) agrees; Not now (or Esc) leaves everything as it was. That OK applies to every cloud connection in AITerm.
3. Add every other Free provider in Settings ▸ AI.
OpenAI and Claude have the shortcut door. Everything else in the Free catalog is set up under Settings ▸ AI (also reachable from More… on the setup sheet):
- Pick the provider from the connection catalog.
- Paste your API key into the key field. It is saved to the Keychain.
- Pick a model. If the model list cannot load, use Retry; you can still type a model id directly.
Get the key from that provider’s own account dashboard. If a later request fails to authenticate, the key is usually missing, mistyped or expired — reopen Settings ▸ AI and re-enter it. AITerm fails closed on a missing key rather than silently falling back to another provider.
4. Choose how much context a cloud model sees.
Before you lean on a cloud connection for real work, open Settings ▸ Privacy and set How much the AI sees. The default is Recent commands only (command lines and exit codes, no output bodies). You can also choose Nothing or Recent commands + output. The setting only caps what cloud models receive; a local model still gets the full session context because that context stays on your Mac.
After a request that carried context, the eye chip on the input bar shows what the provider received — the redacted payload for a cloud provider. Treat redaction as a safety net, not a guarantee. Our guide to what your AI terminal sends walks through that check.
A two-minute practice run.
- Open Settings ▸ AI (or the first-launch key door) and select a Free cloud preset you already have an account for.
- Paste a key from that provider’s dashboard, save it, and confirm the check succeeds.
- In Settings ▸ Privacy, note the current How much the AI sees level.
- In a folder with nothing private in it, ask for a harmless command such as listing the current directory.
- Read the proposal, check the risk badge, then open the eye chip and confirm the context matches what you expected. Discard the proposal with Escape if you do not want to run it.
Try it in AITerm.
BYOK cloud presets, Keychain storage of your keys, local Ollama setup, /fix, /explain, risk badges, tabs, split panes and saved workspaces are part of the free core app. Runbooks and the autonomous agent are Pro. AITerm runs on Apple Silicon Macs with macOS 13 or later. Cloud provider charges are separate from the app.
Keep learning.
- Run your terminal’s AI on your own Mac with Ollama
- What your AI terminal sends, and how to check it
- Privacy and data handling
Prepared with AI assistance from the current AITerm documentation. The steps follow the handbook; this is not a recorded app demonstration.