Skip to content

Why is /btw Not Working in Claude Code? Troubleshooting Guide

Problem

When I try to use the /btw command in Claude Code, I get “command not found” or it simply doesn’t work. What’s going on?

Error message
/btw what is the capital of France?
Error: Unknown command '/btw'

Environment

  • Claude Code CLI
  • Various versions (2.1.49, 2.1.72, 2.1.73)
  • Multiple platforms (macOS, Linux, Windows)

What Happened

I heard about the new /btw command from a Reddit post with 480 upvotes. Everyone was excited about this feature for asking side questions without polluting conversation history.

I tried it in my Claude Code session:

Attempted command
/btw what is the difference between async and defer?

But I got:

Error response
Command not found: /btw

Other users reported similar issues:

IssueUser Report
Minimum version”Need version 2.1.72+ (claude update if you’re behind)“
Version 2.1.73 missing”I’m on 2.1.73 on Linux - Btw not available”
Stuck on older version”I’m stuck on 2.1.49 until the trusted workspace bug is fixed”
Version 2.1.72 missing”Not there - no such command or skill. Am running 2.1.72”

How to Solve It

Step 1: Check Your Version

First, verify your Claude Code version:

Check Claude Code version
claude --version

Expected output if /btw is supported:

Expected output
claude version 2.1.72 (or higher)

Step 2: Update if Needed

If your version is below 2.1.72, update:

Update Claude Code
claude update

Step 3: Manual Update (if claude update fails)

If the update command fails, try:

Manual npm update
# macOS/Linux/Windows with npm
npm install -g @anthropic-ai/claude-code@latest
# Verify
claude --version

Step 4: Diagnose Availability

Even after updating, some users still don’t see /btw. Here’s a diagnosis script:

diagnose-btw.sh
#!/bin/bash
# Diagnose /btw availability issues
echo "=== Claude Code /btw Diagnosis ==="
echo ""
# Check version
echo "1. Checking Claude Code version..."
VERSION=$(claude --version 2>/dev/null)
if [ $? -ne 0 ]; then
echo " ERROR: Claude Code not found or not in PATH"
exit 1
fi
echo " Current version: $VERSION"
# Parse version number
VERSION_NUM=$(echo "$VERSION" | grep -oE '[0-9]+\.[0-9]+\.[0-9]+' | head -1)
MAJOR=$(echo $VERSION_NUM | cut -d. -f1)
MINOR=$(echo $VERSION_NUM | cut -d. -f2)
PATCH=$(echo $VERSION_NUM | cut -d. -f3)
# Check if version supports /btw (2.1.72+)
echo ""
echo "2. Checking version compatibility..."
if [ "$MAJOR" -gt 2 ]; then
echo " OK: Version 3.x detected - /btw should be available"
elif [ "$MAJOR" -eq 2 ] && [ "$MINOR" -gt 1 ]; then
echo " OK: Version 2.2+ detected - /btw should be available"
elif [ "$MAJOR" -eq 2 ] && [ "$MINOR" -eq 1 ] && [ "$PATCH" -ge 72 ]; then
echo " OK: Version 2.1.72+ detected - /btw should be available"
else
echo " WARNING: Version below 2.1.72 - /btw NOT available"
echo " Solution: Run 'claude update' to upgrade"
fi
echo ""
echo "3. Known issues to consider..."
echo " - Linux users: Some report /btw missing even on 2.1.73+"
echo " - Stuck on 2.1.49: Trusted workspace bug may prevent update"
echo ""
echo "=== Diagnosis Complete ==="

The Reason

The /btw command not working is typically due to one of three issues:

Reason 1: Version Below 2.1.72

The /btw feature requires Claude Code version 2.1.72 or higher. This is the minimum version threshold confirmed by users.

Reason 2: Gradual Feature Rollout

Even on version 2.1.72+, some users don’t have access. Anthropic appears to use gradual feature rollouts:

Rollout StageWhat Happens
InitialFeature available to small percentage of users
ExpansionGradual increase to more users
GeneralAvailable to all users on supported versions

Signs of gradual rollout:

  • Same version, different feature availability across users
  • “Works for some, not for others” reports
  • Feature appearing days/weeks after version update

Reason 3: Platform-Specific Issues

Linux users report /btw missing even on version 2.1.73. This may indicate platform-specific availability or bugs.

Reason 4: Blocking Bugs Preventing Update

Some users are stuck on older versions due to bugs:

BugImpact
Trusted workspace issue (v2.1.49)Users stuck, cannot update
Linux availabilityLatest version but feature missing

Troubleshooting Checklist

Run through this checklist:

  • Check version with claude --version
  • Update with claude update if below 2.1.72
  • Try manual update with npm if claude update fails
  • Restart Claude Code session
  • Try again later (gradual rollout)
  • Check Anthropic status page for outages
  • Report issue if on 2.1.72+ and still missing

VS Code Extension vs CLI

For VS Code users, there’s additional confusion:

PlatformUpdate Method
VS Code ExtensionMay not update automatically - check marketplace
CLIRequires separate claude update command

The versions may differ between CLI and VS Code extension.

Summary

In this post, I showed how to troubleshoot when /btw is not working in Claude Code. The key point is that /btw requires version 2.1.72+, but even then, gradual rollout and platform-specific issues may delay access. First check your version, update if needed, and if it’s still missing on a supported version, you may be waiting for Anthropic’s rollout to reach your account.

Final Words + More Resources

My intention with this article was to help others share my knowledge and experience. If you want to contact me, you can contact by email: Email me

Here are also the most important links from this article along with some further resources that will help you in this scope:

Oh, and if you found these resources useful, don’t forget to support me by starring the repo on GitHub!

Comments