Configuration
Learn how to configure Claude Code for your projects and workflow
title: Configuration description: Learn how to configure Claude Code for your projects and workflow
Claude Code offers flexible configuration options to customize its behavior for your specific needs. From project-level settings in CLAUDE.md files to global preferences, you have full control over how Claude assists you.
Configuration Options
CLAUDE.md Files
The most powerful way to configure Claude Code is through CLAUDE.md files. These Markdown files provide project-specific context and instructions that Claude reads automatically.
Learn more about CLAUDE.md files →
Settings & Preferences
Claude Code stores user preferences and settings that persist across sessions:
- Model selection - Choose your preferred Claude model
- Output formatting - Customize how responses are displayed
- Safety settings - Configure approval requirements for file changes
- Theme preferences - Set your preferred color scheme
Account Security
Secure your Claude Insider account with modern authentication methods:
- Passkeys - Sign in with Face ID, Touch ID, or security keys
- Two-Factor Authentication - Add TOTP codes from authenticator apps
- Multi-Device 2FA - Register multiple authenticators for backup
- Backup Codes - One-time recovery codes for emergencies
Quick Configuration Examples
Basic Project Setup
Create a CLAUDE.md at your project root:
Monorepo Configuration
For monorepos, you can have configuration at multiple levels:
Environment Variables
Some Claude Code features can be configured via environment variables:
| Variable | Description |
|----------|-------------|
| ANTHROPIC_API_KEY | Your API key for Claude |
| CLAUDE_MODEL | Default model to use |
| CLAUDE_CONFIG_DIR | Custom config directory |
Best Practices
- Keep CLAUDE.md updated - As your project evolves, update the configuration
- Be specific - Clear instructions lead to better assistance
- Use directory-level configs - Override settings for specific parts of your codebase
- Document conventions - Help Claude understand your coding standards