Where is Claude Code Installed
Claude Code installs globally via npm
with the main application files in your system's global node_modules directory and configuration files stored in the ~/.claude/
directory for easy access and management.
Installation Locations
- Main Application: Global npm installation directory (varies by system)
- User Settings:
~/.claude/settings.json
(applies to all projects) - Project Settings:
.claude/settings.json
(shared with team, checked into source control) - Personal Settings:
.claude/settings.local.json
(personal preferences, not checked in)
Configuration Files
User Settings - ~/.claude/settings.json
contains global settings that apply to all projects.
Project Settings - .claude/settings.json
stores project-specific configurations shared with your team.
Personal Settings - .claude/settings.local.json
contains personal preferences that are not checked into source control.
Project Instructions - CLAUDE.md
files provide project-specific guidance and workflow instructions.
Verification Commands
# Check installation location
which claude
# View global packages
npm list -g --depth=0 | grep claude-code
# Check user configuration
cat ~/.claude/settings.json
I store my configuration files in the standard locations to ensure Claude Code can access them consistently across different terminal sessions and projects. The hierarchical settings system allows for global defaults with project-specific overrides.
Keep your ~/.claude/settings.json
file secure as it may contain sensitive settings. Use .claude/settings.local.json
for personal API keys that shouldn't be shared with your team.
See Also: Download Claude Code|Configuration Guide|Global Settings