From e982cb824a94abc32392861c0753373a8df1684e Mon Sep 17 00:00:00 2001
From: morgankrey <morgan@zed.dev>
Date: Thu, 4 Sep 2025 15:57:00 -0500
Subject: [PATCH] docs: Claude Authentication (#37573)

Release Notes:

- N/A
---
 docs/src/ai/agent-panel.md     | 2 +-
 docs/src/ai/external-agents.md | 6 ++++++
 2 files changed, 7 insertions(+), 1 deletion(-)

diff --git a/docs/src/ai/agent-panel.md b/docs/src/ai/agent-panel.md
index ce91ca3401d07aba552b1ca007b3809e301071de..b6b748e2f58493cd62abbd3c6e7dc443182e992f 100644
--- a/docs/src/ai/agent-panel.md
+++ b/docs/src/ai/agent-panel.md
@@ -23,7 +23,7 @@ From this point on, you can interact with the many supported features outlined b
 
 > Note that for external agents, like [Gemini CLI](./external-agents.md#gemini-cli) or [Claude Code](./external-agents.md#claude-code), some of the features outlined below are _not_ currently supported—for example, _restoring threads from history_, _checkpoints_, _token usage display_, _model selection_, and others. All of them should hopefully be supported in the future.
 
-### Creating New Threads
+### Creating New Threads {#new-thread}
 
 By default, the Agent Panel uses Zed's first-party agent.
 
diff --git a/docs/src/ai/external-agents.md b/docs/src/ai/external-agents.md
index 963e41d42f53ad68ef70de3466913b71b11bd38e..e05849ef1aa54c8ea2c3fff09c8008f58b8a01b7 100644
--- a/docs/src/ai/external-agents.md
+++ b/docs/src/ai/external-agents.md
@@ -85,6 +85,12 @@ If you'd like to bind this to a keyboard shortcut, you can do so by editing your
 ]
 ```
 
+### Authentication
+
+As of version `0.202.7` (stable) and `0.203.2` (preview), authentication to Zed's Claude Code installation is decoupled entirely from Zed's agent. That is to say, an Anthropic API key added via the [Zed Agent's settings](./llm-providers.md#anthropic) will _not_ be utilized by Claude Code for authentication and billing.
+
+To ensure you're using your billing method of choice, [open a new Claude Code thread](./agent-panel.md#new-thread)`. Then, run `/login`, and authenticate either via API key, or via `Log in with Claude Code` to use a Claude Pro/Max subscription.
+
 #### Installation
 
 The first time you create a Claude Code thread, Zed will install [@zed-industries/claude-code-acp](https://github.com/zed-industries/claude-code-acp). This installation is only available to Zed and is kept up to date as you use the agent.