From c82cd0c6b1939a8638ef2a9d1e085d1584313509 Mon Sep 17 00:00:00 2001
From: Danilo Leal <67129314+danilo-leal@users.noreply.github.com>
Date: Sun, 10 Aug 2025 23:28:28 -0300
Subject: [PATCH] docs: Clarify storage of AI API keys (#35963)

Previous docs was inaccurate as Zed doesn't store LLM API keys in the
`settings.json`.

Release Notes:

- N/A
---
 docs/src/ai/llm-providers.md | 34 +++++++++++++++++-----------------
 1 file changed, 17 insertions(+), 17 deletions(-)

diff --git a/docs/src/ai/llm-providers.md b/docs/src/ai/llm-providers.md
index 8fdb7ea325..64995e6eb8 100644
--- a/docs/src/ai/llm-providers.md
+++ b/docs/src/ai/llm-providers.md
@@ -6,29 +6,29 @@ You can do that by either subscribing to [one of Zed's plans](./plans-and-usage.
 
 ## Use Your Own Keys {#use-your-own-keys}
 
-If you already have an API key for an existing LLM provider—say Anthropic or OpenAI, for example—you can insert them in Zed and use the Agent Panel **_for free_**.
+If you already have an API key for an existing LLM provider—say Anthropic or OpenAI, for example—you can insert them into Zed and use the full power of the Agent Panel **_for free_**.
 
-You can add your API key to a given provider either via the Agent Panel's settings UI or directly via the `settings.json` through the `language_models` key.
+To add an existing API key to a given provider, go to the Agent Panel settings (`agent: open settings`), look for the desired provider, paste the key into the input, and hit enter.
+
+> Note: API keys are _not_ stored as plain text in your `settings.json`, but rather in your OS's secure credential storage.
 
 ## Supported Providers
 
 Here's all the supported LLM providers for which you can use your own API keys:
 
-| Provider                                        |
-| ----------------------------------------------- |
-| [Amazon Bedrock](#amazon-bedrock)               |
-| [Anthropic](#anthropic)                         |
-| [DeepSeek](#deepseek)                           |
-| [GitHub Copilot Chat](#github-copilot-chat)     |
-| [Google AI](#google-ai)                         |
-| [LM Studio](#lmstudio)                          |
-| [Mistral](#mistral)                             |
-| [Ollama](#ollama)                               |
-| [OpenAI](#openai)                               |
-| [OpenAI API Compatible](#openai-api-compatible) |
-| [OpenRouter](#openrouter)                       |
-| [Vercel](#vercel-v0)                            |
-| [xAI](#xai)                                     |
+- [Amazon Bedrock](#amazon-bedrock)
+- [Anthropic](#anthropic)
+- [DeepSeek](#deepseek)
+- [GitHub Copilot Chat](#github-copilot-chat)
+- [Google AI](#google-ai)
+- [LM Studio](#lmstudio)
+- [Mistral](#mistral)
+- [Ollama](#ollama)
+- [OpenAI](#openai)
+- [OpenAI API Compatible](#openai-api-compatible)
+- [OpenRouter](#openrouter)
+- [Vercel](#vercel-v0)
+- [xAI](#xai)
 
 ### Amazon Bedrock {#amazon-bedrock}