# OpenCat Setup Guide for OfoxAI

Source: https://ofox.ai/docs/integrations/opencat

[OpenCat](https://opencat.app) is a clean and smooth AI client (macOS, iOS) designed for everyday AI conversations, supporting custom API providers, multi-model switching, and conversation history.

By configuring OfoxAI as your provider, you can use GPT, Claude, Gemini, DeepSeek, and 100+ models in OpenCat with a single API Key.

## Prerequisites

- An OfoxAI account with an API Key ([Get one here](https://app.ofox.ai))
- OpenCat installed ([Download](https://opencat.app))

## Setup Steps

### Step 1: Open Settings

Launch OpenCat and click the **Settings** icon in the bottom left.

![Open OpenCat Settings](https://ofox.ai/screenshots/opencat/01-home.png)

### Step 2: Go to Providers and Select OpenAI Compatible

Click **Providers** in the sidebar, then find and click **OpenAI Compatible**.

![Select OpenAI Compatible](https://ofox.ai/screenshots/opencat/02-provider.png)

Select **OpenAI Compatible**, not the native OpenAI option. The native OpenAI option tries to fetch the model list from OpenAI's official API, which is incompatible with OfoxAI's model format.

### Step 3: Fill in the Configuration

Fill in the following:

| Field | Value |
|-------|-------|
| **Base URL** | `https://api.ofox.ai/v1` |
| **API Key** | Your OfoxAI API Key |
| **Custom Models** | Enter model names manually, e.g. `openai/gpt-6.1-sol` |

![Fill in configuration](https://ofox.ai/screenshots/opencat/03-config.png)

Custom models use the `provider/model-name` format. You can add multiple models at once for easy switching during conversations.

### Step 4: Validate and Save

Click the **Validate** button. Once you see "**Validate Success**", click **Save** in the top right.

![Validate Success](https://ofox.ai/screenshots/opencat/04-validate.png)

## Start Using

After setup, go back to the main screen to start chatting. The current model name is shown at the top.

![Start chatting](https://ofox.ai/screenshots/opencat/05-start-chat.png)

## Available Model Examples

For recommended models, see the [OfoxAI Model Marketplace](https://ofox.ai/models).

## Troubleshooting

**Q: Validation fails**

1. Make sure Base URL is `https://api.ofox.ai/v1` (no trailing slash)
2. Make sure your API Key is copied in full from the [OfoxAI Console](https://app.ofox.ai) with no extra spaces
3. Check your network connection

**Q: Why use OpenAI Compatible instead of native OpenAI?**

The native OpenAI provider in OpenCat automatically calls `/v1/models` to fetch the model list, but OfoxAI's model names include provider prefixes like `openai/` that OpenCat can't recognize. Using **OpenAI Compatible** with manually entered model names works around this issue.

**Q: Can I add multiple models at once?**

Yes — enter multiple model names line by line in the Custom Models field. After saving, you can switch between them during conversations.