Skip to content

docs(docs/ai-coder/ai-gateway/clients): update VS Code to reflect 1.122 Custom Endpoint support#26126

Merged
matifali merged 3 commits into
mainfrom
docs/vscode-ai-gateway-1122
Jun 8, 2026
Merged

docs(docs/ai-coder/ai-gateway/clients): update VS Code to reflect 1.122 Custom Endpoint support#26126
matifali merged 3 commits into
mainfrom
docs/vscode-ai-gateway-1122

Conversation

@matifali

@matifali matifali commented Jun 6, 2026 •
edited
Loading

Copy link
Copy Markdown
Member

Updates the VS Code AI Gateway client docs to reflect the Custom Endpoint provider introduced in VS Code 1.121 (Insiders) and promoted to Stable in 1.122.

Changes

docs/ai-coder/ai-gateway/clients/vscode.md

  • Replace the deprecated customoai vendor with customendpoint
  • Add the required apiType field (responses for OpenAI, messages for Anthropic)
  • Add Anthropic provider setup (Messages API type, base URL …/aibridge/anthropic)
  • Note GitHub sign-in is no longer required — works in air-gapped/restricted environments
  • Add limitation callout: inline suggestions and NES still require GitHub Copilot
  • Reflect the UI-first API key entry flow (VS Code stores the token securely; do not paste into JSON directly)
  • Drop the Centralized/BYOK split — VS Code has no template injection path, so both scenarios follow the same user-driven UI flow

docs/ai-coder/ai-gateway/clients/index.md

  • VS Code compatibility row: Anthropic ❌ → ✅
  • Updated Notes column
Research notes
  • VS Code 1.121 shipped the Custom Endpoint provider (Insiders), replacing the legacy OpenAI Compatible (customoai) provider which is now deprecated.
  • VS Code 1.122 promoted Custom Endpoint to Stable and removed the GitHub sign-in requirement for BYOK.
  • Anthropic support confirmed working: apiType: "messages" + base URL …/api/v2/aibridge/anthropic (Coder's gateway accepts the Coder session token as x-api-key).
  • OpenAI uses apiType: "responses" + base URL …/api/v2/aibridge/openai.
  • API keys must be entered via the Manage Language Models UI — VS Code stores them securely and references them as ${input:chat.lm.secret.XXXXX} in the JSON.

This PR was drafted by Coder Agents on behalf of @matifali.

@github-actions

github-actions Bot commented Jun 6, 2026

Copy link
Copy Markdown

Docs preview

📖 View docs preview for docs/ai-coder/ai-gateway/clients/index.md

@matifali
docs(docs/ai-coder/ai-gateway/clients): update VS Code to reflect 1.1…
75e7442 
…22 Custom Endpoint support

- Replace deprecated customoai vendor with customendpoint provider
- Add apiType field (responses for OpenAI, messages for Anthropic)
- Add Anthropic provider setup using Messages API type
- Note that GitHub sign-in is not required (air-gapped environments)
- Add limitation callout for inline suggestions
- Reflect UI-first flow for API key entry (stored securely by VS Code)
- Update compatibility table: Anthropic now supported
@matifali matifali force-pushed the docs/vscode-ai-gateway-1122 branch from a7c62a3 to 75e7442 Compare June 6, 2026 21:40
@matifali matifali changed the title docs(ai-coder/ai-gateway/clients): update VS Code to reflect 1.122 Custom Endpoint support docs(docs/ai-coder/ai-gateway/clients): update VS Code to reflect 1.122 Custom Endpoint support Jun 6, 2026
@matifali matifali marked this pull request as ready for review June 6, 2026 21:46
@matifali matifali requested review from dannykopping and ssncferreira and removed request for ssncferreira June 6, 2026 21:47
@coder coder deleted a comment from linear-code Bot Jun 7, 2026
dannykopping
dannykopping reviewed Jun 8, 2026
View reviewed changes

@dannykopping dannykopping left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for this @matifali

Have you personally tested this functionality for both OAI & Anthropic?

Comment thread docs/ai-coder/ai-gateway/clients/vscode.md Outdated
@matifali

matifali commented Jun 8, 2026 •
edited
Loading

Copy link
Copy Markdown
Member Author

Thanks for this @matifali

Have you personally tested this functionality for both OAI & Anthropic?

Yes I have tested both. My existing settings stoped working which prompted me to look into this so this PR is created after I verified personally.

dannykopping
dannykopping approved these changes Jun 8, 2026
View reviewed changes

@dannykopping dannykopping left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Awesome, thanks @matifali

@matifali matifali enabled auto-merge (squash) June 8, 2026 07:33
@matifali matifali requested a review from nickvigilante June 8, 2026 07:33
@matifali matifali merged commit 2211f9c into main Jun 8, 2026
29 checks passed
@matifali matifali deleted the docs/vscode-ai-gateway-1122 branch June 8, 2026 07:35
@github-actions github-actions Bot locked and limited conversation to collaborators Jun 8, 2026
@matifali

matifali commented Jun 8, 2026

Copy link
Copy Markdown
Member Author

@nickvigilante, what are your thoughts on backporting such updates at least to our ESR branch?

@nickvigilante Linear Code

nickvigilante commented Jun 8, 2026

Copy link
Copy Markdown
Contributor

I would say yes, bundle into the ESR branch, provided we have a good backporting mechanism to do so. Ben wants to display the release branch itself for each version and not just the latest tag, so any meaningful update we can make to the docs is worth it to do.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Reviewers

@dannykopping dannykopping dannykopping approved these changes

@ssncferreira ssncferreira Awaiting requested review from ssncferreira

@nickvigilante nickvigilante Awaiting requested review from nickvigilante

Assignees

@matifali matifali

Labels

cherry-pick

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

3 participants

@matifali @nickvigilante @dannykopping