claude-code - 💡(How to fix) Fix [DOCS] Syntax highlighting docs missing Cedar policy file support [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#45468Fetched 2026-04-09 08:04:44
View on GitHub
Comments
0
Participants
1
Timeline
2
Reactions
0
Author
Participants
Timeline (top)
labeled ×2
RAW_BUFFERClick to expand / collapse

Documentation Type

Missing documentation (feature not documented)

Documentation Location

https://code.claude.com/docs/en/interactive-mode

Section/Topic

Theme and display / /theme syntax highlighting documentation

Current Documentation

The docs currently say:

| Ctrl+T | Toggle syntax highlighting for code blocks | Only works inside the /theme picker menu. Controls whether code in Claude's responses uses syntax coloring |

And:

| CLAUDE_CODE_SYNTAX_HIGHLIGHT | Set to false to disable syntax highlighting in diff output. Useful when colors interfere with your terminal setup |

And:

  • language: Programming language of the edited file, such as "TypeScript", "Python", "JavaScript", or "Markdown". Returns "unknown" for unrecognized file extensions.

No documentation currently exists for Cedar policy syntax highlighting support or for the newly recognized .cedar and .cedarpolicy extensions.

What's Wrong or Missing?

Changelog v2.1.97 added syntax highlighting for Cedar policy files (.cedar, .cedarpolicy), but the docs do not mention that Claude Code now recognizes Cedar policy files as part of its built-in syntax-highlighting support.

Users working with Cedar policies cannot tell from the docs that:

A. Cedar policy files are now recognized

.cedar and .cedarpolicy are now treated as Cedar files instead of remaining undocumented/unrecognized file types.

B. The syntax-highlighting docs have no supported-file-type guidance

The current docs explain how to toggle or disable syntax highlighting, but they do not say which file extensions Claude Code recognizes or note that Cedar support was added in v2.1.97.

Suggested Improvement

Add a short supported-file-type note anywhere Claude Code documents built-in syntax highlighting, and explicitly include Cedar policy files starting in v2.1.97.

Minimum useful fix:

  • Add a note in interactive-mode (or a linked source-of-truth page) that Claude Code recognizes .cedar and .cedarpolicy as Cedar for syntax highlighting.
  • Cross-reference that source of truth from pages that currently mention syntax highlighting controls (interactive-mode, env-vars, and related pages).

If Anthropic does not want to maintain a full exhaustive language matrix, a brief “recently added support” note for Cedar policy files would still close the gap created by the v2.1.97 changelog entry.

Impact

Low - Minor confusion or inconvenience

Additional Context

Affected Pages:

PageContext
https://code.claude.com/docs/en/interactive-mode/theme syntax-highlighting controls
https://code.claude.com/docs/en/env-varsCLAUDE_CODE_SYNTAX_HIGHLIGHT documents disabling highlighting but not supported file types
https://code.claude.com/docs/en/monitoring-usageNotes that unrecognized file extensions return "unknown", but does not mention Cedar recognition
https://code.claude.com/docs/en/keybindingsLists the syntax-highlighting toggle shortcut without any supported-language guidance

Total scope: 4 pages affected

Source: Changelog v2.1.97

Changelog entry: Added syntax highlighting for Cedar policy files (.cedar, .cedarpolicy)

extent analysis

TL;DR

Add documentation notes to indicate that Claude Code recognizes .cedar and .cedarpolicy files for syntax highlighting, starting from version 2.1.97.

Guidance

  • Update the interactive-mode documentation to include a note about supported file types for syntax highlighting, including .cedar and .cedarpolicy.
  • Cross-reference this information from related pages that mention syntax highlighting controls, such as env-vars and keybindings.
  • Consider adding a "recently added support" note for Cedar policy files to provide a clear indication of the new feature.
  • Review the affected pages (listed in the issue) to ensure consistency in documentation.

Example

A possible documentation update could be:

Claude Code supports syntax highlighting for the following file types: ... , .cedar, and .cedarpolicy (added in v2.1.97).

Notes

The suggested fix is relatively low-impact and only requires updates to the documentation. However, it is essential to ensure that the changes are consistent across all affected pages.

Recommendation

Apply a workaround by adding the suggested documentation notes to provide clarity on supported file types for syntax highlighting. This will help users understand the new feature and reduce confusion.

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…

Still need to ship something?

×6

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

Back to top recommendations

TRENDING