# /update-config Command

> You say a settings change, and Claude edits the file.

**Field:** Artificial Intelligence  
**Category:** Claude Code  
**Also known as:** /update-config, Edit settings.json

## Think of it like

It is like you tell a big kid what you want, and they write it down.

## Definition

/update-config is a bundled skill that changes Claude Code's settings files for you. You say the change in plain words, such as allow npm test, set an environment variable, or add a hook. Claude finds the right settings.json and edits it. For simple choices like the theme or the model, /config is quicker.

## Example

Lucy wants a sound when Claude finishes. She types /update-config play a sound when you stop, and Claude adds a Stop hook to her settings.

## Example code

```console
/update-config allow npm test without asking
```

Describe the change, and Claude edits the file.

## Why it matters

Settings files have many keys and a strict shape. You say what you want and skip learning the format.

## Common mistake

Using it to pick a theme or a model. /config does that in one line, with no file to edit.

## Three principles

- **Plain words in.** Say the change.
- **The right file.** Claude picks it.
- **Big changes.** /config for small ones.

## Related terms

- [/config Command](https://learn.benibix.com/term/ai/config-command)
- [Permission Rule](https://learn.benibix.com/term/ai/permission-rule)
- [Bundled Skills](https://learn.benibix.com/term/ai/bundled-skills)
- [/fewer-permission-prompts Command](https://learn.benibix.com/term/ai/fewer-permission-prompts-command)

## Told apart from

- [/update-config vs /config](https://learn.benibix.com/compare/update-config-command-vs-config-command): People think /update-config is just a longer name for /config. Both change settings, but they work in very different ways. /config opens the settings panel, or sets one key such as theme=dark, and works at once. /update-config is a skill. You say a change in plain words, such as allow a command or add a hook, and Claude finds the right settings.json and edits it. Use /config for a switch. Use /update-config for a rule or a hook.

## Taught in

- [Setup and Config Commands](https://learn.benibix.com/learn/ai-claude-code-commands/setup-and-config-commands): Claude Code Commands, 9/17

![Three commands, each writing to a settings file: /auto-mode-setup to your user settings, /fewer-permission-prompts to the project settings, /update-config to whichever file fits.](https://learn.benibix.com/diagrams/cmd-settings-writers.svg)

---

Source: https://learn.benibix.com/term/ai/update-config-command
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-16
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
