Claude Code --add-dir: Additional Working Directories
Utilise the --add-dir
functionality to work across multiple directories and repositories in a single Claude Code session.
What is --add-dir
Purpose - Extends Claude Code's workspace beyond your current working directory to include additional directories without changing your primary location.
- CLI argument:
--add-dir
when starting Claude Code - Slash command:
/add-dir
to expand workspace mid-session
How to Use --add-dir at Startup
Single Additional Directory - Add one extra directory when launching Claude Code:
claude --add-dir /path/to/other/project
Multiple Directories - Add several directories at once:
claude --add-dir ../backend --add-dir ../shared-utils --add-dir ~/company/configs
Combined with Other Options - Mix with model selection or other flags:
claude --model claude-sonnet-4-20250514 --add-dir ../backend-api
claude --add-dir ~/shared/libraries -p "Compare authentication patterns between current and shared directory"
Mid-Session Directory Addition
Slash Command Usage - Add directories without restarting your session:
/add-dir /path/to/other/project
/add-dir ../backend-api
/add-dir ~/shared/libraries
Dynamic Workflow Expansion - Start focused, expand as needed:
- Begin working on frontend project
- Realize you need backend API reference:
/add-dir ../backend-api
- Need shared utilities:
/add-dir ~/company/shared-utils
- Access documentation repo:
/add-dir ../project-docs
Common Use Cases
Multi-Repository Development - Work on interconnected projects:
# Frontend project needs backend API reference
claude --add-dir ../backend-api
# Microservices that share common code
claude --add-dir ../user-service --add-dir ../auth-service --add-dir ../shared-models
Shared Resources Access - Reference common configurations or libraries:
# Access company-wide shared configurations
claude --add-dir ~/company/shared-configs
# Reference template repositories
claude --add-dir ~/templates/react-components --add-dir ~/templates/api-patterns
Legacy Code Integration - Work with mixed old and new codebases:
# Modernizing project while referencing legacy system
claude --add-dir ../legacy-system --add-dir ../migration-scripts
Documentation and Examples - Include reference materials:
# Access documentation and example code
claude --add-dir ../project-docs --add-dir ../code-examples
See Also: Configuration Guide