update-config-settings-file-locations

Guide storage and management of Claude Code's settings.json across user scopes.

7|Updated Mar 8, 2026
One-click install
npx skills add https://github.com/mkusaka/ccskills --skill update-config-settings-file-locations
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: update-config-settings-file-locations
Source: https://github.com/mkusaka/ccskills/tree/main/skills/update-config-settings-file-locations
Command: npx skills add https://github.com/mkusaka/ccskills --skill update-config-settings-file-locations

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill provides a comprehensive guide on where Claude Code stores the settings.json file across different scopes, making it easier to locate and manage settings for personal preferences, team-wide hooks, and project-specific overrides.

Core Features & Use Cases

  • Global, Project, and Local Settings: Navigate through global, project-specific, and local settings.json files for personal preferences, team-wide hooks, and project-specific overrides.
  • Settings Load Order: Understand the order in which settings are loaded: user → project → local, with later settings overriding earlier ones.
  • Permissions, Environment Variables, and More: Access detailed references on permissions, environment variables, model and agent configurations, attribution, MCP server management, plugins, and other settings.

Quick Start

Use the update-config-settings-file-locations skill to find the correct location for your project settings file.

Frequently Asked Questions about update-config-settings-file-locations

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Where does Claude Code store the settings.json file for global and project configurations?

Claude Code stores settings.json across multiple scopes: global for personal preferences, project for team-wide hooks, and local for project-specific overrides. The skill guides you to the exact file path for each configuration scope.

How do I configure environment variables and permissions in Claude Code settings?

You configure environment variables and permissions by editing the settings.json file at the appropriate scope. This skill provides detailed references for managing permissions, environment variables, and MCP server configurations within your settings files.

What is the load order for Claude Code global, project, and local settings?

The settings load order in Claude Code is user, then project, then local. Later settings override earlier ones, allowing local settings.json files to apply project-specific overrides on top of global and team-wide configurations.

Can I manage MCP servers and model configurations through Claude Code settings files?

Yes, you can manage MCP servers, model configurations, and agent settings through the settings.json file. This skill covers where to locate these configurations and how to apply them across different user scopes.

How do I set up team-wide hooks in Claude Code project settings?

You set up team-wide hooks by editing the project-level settings.json file. This skill helps you locate the correct project settings file path to configure hooks and other team-wide overrides for your Claude Code environment.