Bash Mode - Claude Code
Prefix prompts with ! to run shell commands directly, bypassing Claude.
Bash mode lets you drop straight into the shell without spending a turn asking Claude to run a command.
What it does
Start any prompt with ! and the rest of the line runs as a shell command. Output appears inline and is captured into the conversation so Claude can reference it on the next turn. This is faster than please run ls -la and more honest - you're not spending tokens on the interpreter round-trip.
When to use it
- Quick directory listings, git status checks, or file inspections.
- Sanity-checking the shell state before asking Claude to do real work.
- Piping output into a follow-up Claude prompt without editing files.
- Teaching Claude about your environment without explaining it.
Gotchas
- Bash mode respects your current permission rules. Denied commands still get blocked.
- The working directory is the same as Claude's Bash tool, not wherever your outer terminal sits.
- Shell state (exported vars, aliases) doesn't persist between bash-mode calls unless you use SessionStart hooks.
Official docs: https://code.claude.com/docs/en/interactive-mode.md#bash-mode-with--prefix
Technical content at the intersection of AI and development. Building with AI agents, Claude Code, and modern dev tools - then showing you exactly how it works.
Was this helpful?
Related Guides
Related Tools
Zed
High-performance code editor built in Rust with native AI integration. Sub-millisecond input latency. Built-in assistant...
View Tool
OpenCode
Open-source AI coding agent for terminal, desktop, and IDE. Works with 75+ LLM providers including Claude, GPT, Gemini,...
View Tool
Claude Code
Anthropic's agentic coding CLI. Runs in your terminal, edits files autonomously, spawns sub-agents, and maintains memory...
View Tool
Claude Agent SDK
Anthropic's SDK for building agents on the same tools, agent loop, and context management that power Claude Code. Python...
View ToolRelated Videos
Claude Code 'Interview' Mode in 6 Minutes
Effortless Project Planning: Mastering Spec-Driven Development with Claude Code Kick off the new year with a fresh approach to project planning using Claude Code! In this video, learn how to achieve
Generate Videos in Codex + Claude Code with This...
Check out HeyGen! https://heygen.1stcollab.com/developersdigest The video introduces HeyGen, an AI video generation platform with a rich API and a CLI that lets developers create, fetch, and manipula...
10x Design in Claude Code and Codex
Try Higgsfield: https://higgsfield.ai/s/higgsfield-general-campaign-developersdigest-juDMTi AI coding agents can build entire websites in minutes, but the default results often still look generic and...
Related Posts
Claude Fable 5.1 in Claude Code: How to Switch, Pin, and Pay Less
Claude Code v2.1.257 points /model fable at Fable 5.1: 1M context, $10/$50 per MTok, $0.25 cache reads. Setup, gotchas,...
Claude Design, Slides and Docs in Any Chat: How to Use Them
Claude Design, Slides and Docs now open in any Claude chat, Claude Code session or the Artifacts tab, on every plan. Exa...
Claude for Startups Offer Paused: What Founders Do Now
Claude for Startups paused its free Claude Team year and $1,000 API credit offer at capacity. What the program page says...
Claude Advisor Tool vs a Bigger Model: When the Pairing Pays
Anthropic's own runs: a Fable 5.1 advisor added 1.7 points to Opus 5.5 for 2.1x the cost. When the Claude advisor tool p...
Claude Code Retry Watchdog: Keep Unattended Runs Alive
CLAUDE_CODE_RETRY_WATCHDOG=1 makes Claude Code wait out 429 and 529 errors instead of failing after 10 retries. When to...
Claude Max API Credits: $100 a Month, What They Cover
Claude Max and Team plans now include a monthly Claude API credit, starting at $100 on Max 5x. What it covers, what it d...
