Choose authentication

Open Settings → AI → Configure…. OpenAI API and ChatGPT / Codex are separate connections and can both stay connected. A ChatGPT subscription does not supply an OpenAI API key.

Connect a ChatGPT account

Select ChatGPT / Codex → Connect ChatGPT. Complete the OpenAI account flow and confirm the account shown on its consent page before continuing. If a runtime is unavailable, follow the runtime guidance shown in the modal. Choose Disconnect to remove the account connection.

Use an OpenAI API key

Select OpenAI API, enter your own API key and choose Connect. API access, billing and model availability belong to your OpenAI API account. The connected state shows the key’s last four characters and a Disconnect button.

Choose a model

Choose the connection’s Provider default model, then select your Settings default provider and model. An individual AI Prompt action can choose a different connected provider/model in its gear settings or custom action editor.

Privacy and storage

API keys stay in the macOS Keychain. Online Actions must be enabled. When you run an action, its selected text and instructions go to OpenAI through the connection you chose. See the central provider setup guide.

Troubleshooting

Confirm the intended account, connection, model access and Online Actions setting. If you disconnect a provider used by an action, reconnect it or change that action’s provider. Do not share API keys or account authorization codes.

Back to all guides