claude-code - 💡(How to fix) Fix [BUG] /terminal-setup fails on Windows Terminal despite listing it as supported [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#46291Fetched 2026-04-11 06:24:11
View on GitHub
Comments
0
Participants
1
Timeline
6
Reactions
0
Participants
Timeline (top)
labeled ×4cross-referenced ×1unlabeled ×1

Error Message

Running /terminal-setup inside Claude Code on Windows Terminal gives the error:

Error Messages/Logs

Code Example

The command fails with "Terminal setup cannot be run from windows-terminal."
RAW_BUFFERClick to expand / collapse

Preflight Checklist

  • I have searched existing issues and this hasn't been reported yet
  • This is a single bug report (please file separate reports for different bugs)
  • I am using the latest version of Claude Code

What's Wrong?

Running /terminal-setup inside Claude Code on Windows Terminal gives the error:

Terminal setup cannot be run from windows-terminal.

However, the same output then lists Windows Terminal as a supported terminal:

This is contradictory — it detects the terminal as "windows-terminal," refuses to run, but then tells me to run it in Windows Terminal.

What Should Happen?

The Shift+Enter shortcut should be configured for Windows Terminal.

Error Messages/Logs

The command fails with "Terminal setup cannot be run from windows-terminal."

Steps to Reproduce

  1. Open Windows Terminal on Windows 11
  2. Launch Claude Code (claude)
  3. Run /terminal-setup at the Claude Code prompt

Claude Model

Opus

Is this a regression?

I don't know

Last Working Version

No response

Claude Code Version

2.1.100

Platform

Anthropic API

Operating System

Windows

Terminal/Shell

Windows Terminal

Additional Information

No response

extent analysis

TL;DR

The issue might be resolved by modifying the terminal detection logic in Claude Code to correctly handle Windows Terminal.

Guidance

  • Verify that the windows-terminal detection is correctly implemented in the Claude Code terminal setup script.
  • Check if there are any specific configuration options or environment variables that need to be set for Windows Terminal to work with Claude Code.
  • Investigate if the error message "Terminal setup cannot be run from windows-terminal" is a hardcoded check that can be removed or modified to allow the setup to run in Windows Terminal.
  • Test the /terminal-setup command with other terminals to see if the issue is specific to Windows Terminal.

Example

No code snippet can be provided without more information about the Claude Code internals.

Notes

The issue seems to be related to the terminal detection logic in Claude Code, but without more information about the codebase, it's difficult to provide a more specific solution.

Recommendation

Apply workaround: Modify the terminal detection logic or configuration to allow the /terminal-setup command to run in Windows Terminal, as the current version (2.1.100) seems to have a contradictory behavior.

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