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?
/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:
/btw what is the difference between async and defer?But I got:
Command not found: /btwOther users reported similar issues:
| Issue | User 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:
claude --versionExpected output if /btw is supported:
claude version 2.1.72 (or higher)Step 2: Update if Needed
If your version is below 2.1.72, update:
claude updateStep 3: Manual Update (if claude update fails)
If the update command fails, try:
# macOS/Linux/Windows with npmnpm install -g @anthropic-ai/claude-code@latest
# Verifyclaude --versionStep 4: Diagnose Availability
Even after updating, some users still don’t see /btw. Here’s a diagnosis script:
#!/bin/bash# Diagnose /btw availability issues
echo "=== Claude Code /btw Diagnosis ==="echo ""
# Check versionecho "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 1fiecho " Current version: $VERSION"
# Parse version numberVERSION_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 Stage | What Happens |
|---|---|
| Initial | Feature available to small percentage of users |
| Expansion | Gradual increase to more users |
| General | Available 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:
| Bug | Impact |
|---|---|
| Trusted workspace issue (v2.1.49) | Users stuck, cannot update |
| Linux availability | Latest version but feature missing |
Troubleshooting Checklist
Run through this checklist:
- Check version with
claude --version - Update with
claude updateif below 2.1.72 - Try manual update with npm if
claude updatefails - 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:
| Platform | Update Method |
|---|---|
| VS Code Extension | May not update automatically - check marketplace |
| CLI | Requires 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:
- 👨💻 Reddit: Claude just released /BTW and it's clutch
- 👨💻 Claude Code Documentation
- 👨💻 Anthropic Status Page
Oh, and if you found these resources useful, don’t forget to support me by starring the repo on GitHub!
Comments