From b035843484a56c52059c15abace6643414896f5b Mon Sep 17 00:00:00 2001
From: "blinkagent[bot]" <237617714+blinkagent[bot]@users.noreply.github.com>
Date: Fri, 30 Jan 2026 14:49:06 +0000
Subject: [PATCH] docs: clarify that only Coder tokens work with AI Bridge
 authentication (#21791)

## Summary

Clarifies the [AI Bridge client config authentication
section](https://coder.com/docs/ai-coder/ai-bridge/client-config#authentication)
to explicitly state that only **Coder-issued tokens** are accepted.

## Changes

- Changed "API key" to "Coder API key" throughout the Authentication
section
- Added a note clarifying that provider-specific API keys (OpenAI,
Anthropic, etc.) will not work with AI Bridge

Fixes #21790

---

Created on behalf of @dannykopping

---------

Co-authored-by: blink-so[bot] <211532188+blink-so[bot]@users.noreply.github.com>
---
 docs/ai-coder/ai-bridge/client-config.md | 10 +++++++---
 1 file changed, 7 insertions(+), 3 deletions(-)

diff --git a/docs/ai-coder/ai-bridge/client-config.md b/docs/ai-coder/ai-bridge/client-config.md
index dbbb72cada..b09ee89707 100644
--- a/docs/ai-coder/ai-bridge/client-config.md
+++ b/docs/ai-coder/ai-bridge/client-config.md
@@ -15,10 +15,14 @@ Replace `coder.example.com` with your actual Coder deployment URL.
 
 ## Authentication
 
-Instead of distributing provider-specific API keys (OpenAI/Anthropic keys) to users, they authenticate to AI Bridge using their **Coder session token** or **API key**:
+Instead of distributing provider-specific API keys (OpenAI/Anthropic keys) to users, they authenticate to AI Bridge using their **Coder session token** or **Coder API key**:
 
-- **OpenAI clients**: Users set `OPENAI_API_KEY` to their Coder session token or API key
-- **Anthropic clients**: Users set `ANTHROPIC_API_KEY` to their Coder session token or API key
+- **OpenAI clients**: Users set `OPENAI_API_KEY` to their Coder session token or Coder API key
+- **Anthropic clients**: Users set `ANTHROPIC_API_KEY` to their Coder session token or Coder API key
+
+> [!NOTE]
+> Only Coder-issued tokens are accepted at this time.
+> Provider-specific API keys (such as OpenAI or Anthropic keys) will not work with AI Bridge.
 
 Again, the exact environment variable or setting naming may differ from tool to tool; consult your tool's documentation.