Issue Station
Sign In
Tools hereToolbox

claude-code - 💡(How to fix) Fix [DOCS] Channels docs still say Console/API key authentication is unsupported [1 participants]

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…
GitHub stats
anthropics/claude-code#56152•Fetched 2026-05-05 05:56:49
View on GitHub
Comments
0
Participants
1
Timeline
3
Reactions
0
Author
coygeekcoygeek
Participants
coygeekcoygeek
Timeline (top)
labeled ×3
RAW_BUFFERClick to expand / collapse

Documentation Type

Incorrect/outdated documentation

Documentation Location

https://code.claude.com/docs/en/channels

Section/Topic

Research preview note and Enterprise controls for --channels

Current Documentation

The docs currently say:

Channels are in research preview and require Claude Code v2.1.80 or later. They require claude.ai login. Console and API key authentication is not supported. Team and Enterprise organizations must explicitly enable them.

The reference page repeats the same requirement:

Channels are in research preview and require Claude Code v2.1.80 or later. They require claude.ai login. Console and API key authentication is not supported. Team and Enterprise organizations must explicitly enable them.

What's Wrong or Missing?

This is outdated as of v2.1.128. --channels now works with Console/API key authentication, but the docs still tell users that Console and API key auth are unsupported.

The current docs also do not connect that new support to the managed-settings requirement for Console organizations: channel delivery still depends on channelsEnabled: true.

That combination creates the wrong troubleshooting path for Console users. Instead of checking their organization's managed settings, they are told their authentication method cannot work at all.

Suggested Improvement

Update the note on both channels pages to reflect the new behavior in v2.1.128.

Suggested replacement text:

Channels are in research preview and require Claude Code v2.1.80 or later. They work with claude.ai login and with Claude Console/API key authentication. For Console organizations, admins must enable channels with channelsEnabled: true in managed settings before channel messages can be delivered.

Also add a short cross-reference from the channels docs to the authentication and settings pages so Console users can verify both their login method and the required managed setting.

Impact

High - Prevents users from using a feature

Additional Context

Affected Pages:

PageLine(s)Context
https://code.claude.com/docs/en/channels20Research preview note says Console and API key authentication are not supported
https://code.claude.com/docs/en/channels-reference20Repeats the same unsupported-authentication statement

Total scope: 2 pages affected

Cross-references:

PageLine(s)Context
https://code.claude.com/docs/en/authentication23, 61-91Authentication docs already describe Claude Console as a supported login path
https://code.claude.com/docs/en/settings180Settings reference already documents channelsEnabled as the managed setting that gates channel delivery

Behavior changed in v2.1.128.

extent analysis

TL;DR

Update the documentation on the channels pages to reflect the new behavior in v2.1.128, allowing Console and API key authentication.

Guidance

  • Review the suggested replacement text to ensure it accurately describes the current functionality of channels with Console and API key authentication.
  • Verify that the managed settings requirement for Console organizations is clearly documented, including the need for channelsEnabled: true.
  • Add cross-references from the channels docs to the authentication and settings pages to help users troubleshoot issues.
  • Check the affected pages (https://code.claude.com/docs/en/channels and https://code.claude.com/docs/en/channels-reference) to ensure the updates are applied correctly.

Example

The updated documentation could include the suggested replacement text:

Channels are in research preview and require Claude Code v2.1.80 or later. They work with claude.ai login and with Claude Console/API key authentication. For Console organizations, admins must enable channels with channelsEnabled: true in managed settings before channel messages can be delivered.

Notes

The updates should be applied to both the channels and channels-reference pages to ensure consistency and accuracy.

Recommendation

Apply the workaround by updating the documentation to reflect the new behavior in v2.1.128, as this will help prevent users from being misinformed about the supported authentication methods and troubleshooting paths.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…
#api#ISR setup#authentication setup#request error#file not found

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING

claude-code - 💡(How to fix) Fix [DOCS] Channels docs still say Console/API key authentication is unsupported [1 participants]