Claude Code 2.1: What's New

Update, October 2026: some of the Brewcode commands this post shows are retired. See the current docs.

Claude Code 2.1 is the largest update since the initial public release. It reworks how agents run in the background, how tools are selected, and how permissions are scoped. If you use Claude Code daily, this release changes several assumptions.

Here is what matters most.

Background Agents

Sessions can now spawn agents that continue working after you close the terminal. Background agents persist state to disk, pick up on restart, and report results asynchronously.

This is especially useful for long-running tasks like full codebase refactors, test suites, or multi-file migrations. You start the work, close the lid, and check results later.

For Brewcode users: /brewcode:start now detects background agent support automatically and uses it when available. No configuration needed.

Improved Tool Routing

The tool selection layer is smarter about matching requests to the right tool. File edits go to the edit tool instead of writing an entire file. Search queries use ripgrep before falling back to broader strategies.

In practice, this means fewer permission prompts and faster execution. The model spends less time choosing and more time doing.

Permissions Model

The new permissions system replaces the flat allow/deny list with scoped rules. You can now grant access per directory, per tool, or per session type.

Add scoped rules to your project settings:

# Allow file edits only in src/ and tests/
claude config set permissions.edit.paths "src/,tests/"

# Allow bash commands matching a pattern
claude config set permissions.bash.allow "npm test,npm run build"

# Deny network access in background agents
claude config set permissions.background.network false

Tip: Start with restrictive permissions and widen as needed. Run claude permissions list to see your active rules and where they come from (global, project, or session).

Upgrading

Update to 2.1 with:

claude update

If you use Brewcode, also update the plugin to pick up compatibility fixes:

claude plugin marketplace update claude-brewcode
claude plugin update brewcode@claude-brewcode

Background agents require Claude Code 2.1.60 or later. Check your version with claude --version.

What This Means for Daily Use

The combination of background agents and better tool routing makes Claude Code significantly more autonomous. You can queue up work, step away, and trust that execution will continue cleanly.

For teams using Brewcode, this release pairs well with the /brewcode:teams skill — background agents can now run team members in parallel without blocking your terminal.

We will cover background agent patterns in a dedicated tutorial next week.