cc-profiles Documentation PyPI GitHub Install

Guides

Settings

The Settings tab edits one profile at a time; pick it at the top. Changes apply from the next Claude Code session in that profile, and every save goes to the backup.

The Settings tab: the /config settings of the Default profile with dropdowns and switches

If a file is shared, a shared with … label warns that the change applies to every sharing profile.

General

The same settings as the /config panel of Claude Code, in groups, plus two that /config does not have, with commit and pull request attribution as on/off switches.

Setting Key Control
Replies    
Thinking mode alwaysThinkingEnabled on/off, on by default
Output style outputStyle built-in styles plus the profile’s custom styles in output-styles/
Language language free text
Prompt suggestions promptSuggestionEnabled on/off, on by default
Session recap awaySummaryEnabled on/off, on by default
Auto-compact autoCompactEnabled ¹ on/off, on by default
Precompute compaction precomputeCompactionEnabled on/off, on by default
Idle compaction idleCompaction on/off, on by default
Rewind code (checkpoints) fileCheckpointingEnabled ¹ on/off, on by default
Default permission mode permissions.defaultMode default, plan, acceptEdits, auto, dontAsk
Use auto mode during plan useAutoModeDuringPlan on/off, on by default
Artifacts enableArtifact on/off, on by default: off, Claude never publishes pages to claude.ai
Interface    
Theme theme ² auto, dark, light, dark-daltonized, light-daltonized, dark-ansi, light-ansi
Show tips spinnerTipsEnabled on/off, on by default
Reduce motion prefersReducedMotion on/off
Verbose output verbose ¹ on/off
Terminal progress bar terminalProgressBarEnabled ¹ on/off, on by default
Show turn duration showTurnDuration ¹ on/off, on by default
Time format timeFormat auto, 12-hour, 24-hour, 24-hour-utc
Default view defaultView transcript, chat
Auto-scroll autoScrollEnabled ¹ on/off, on by default
Show PR status footer prStatusFooterEnabled ¹ on/off, on by default
Editor and files    
Editor mode editorMode ² normal, vim
Respect .gitignore in file picker respectGitignore ¹ on/off, on by default
Skip the /copy picker copyFullResponse ¹ on/off
Copy on select copyOnSelect ¹ on/off, on by default
Show last response in external editor externalEditorContext ¹ on/off
Diff tool diffTool ¹ auto, terminal
Auto-connect to IDE (external terminal) autoConnectIde ¹ on/off
Auto-install IDE extension autoInstallIdeExtension ¹ on/off, on by default
Worktree base ref worktree.baseRef fresh, head
Voice (claude.ai sign-in only; the same as /voice)    
Voice mode voice.enabled on/off
How to talk voice.mode hold (default: hold the key while you talk), tap (tap to start, tap to stop and send)
Send on release voice.autoSubmit on/off: send the prompt when you release the key, with hold only
Notifications and updates    
Notifications preferredNotifChannel ¹ auto, iterm2, terminal_bell, iterm2_with_bell, kitty, ghostty, notifications_disabled
Auto-update channel autoUpdatesChannel latest, stable
Commits and pull requests    
Commit attribution attribution.commit on/off, on by default: off saves an empty text (no attribution), on removes the key; a custom text counts as on and is kept
Pull request attribution attribution.pr on/off, the same way
Co-authored-by in commits includeCoAuthoredBy shown only while a profile has it: deprecated by Claude Code, remove it with ×
Storage and hooks (not in /config)    
Keep conversations for (days) cleanupPeriodDays a whole number, 1 or more: Claude Code deletes older conversations when it starts; 30 when empty
Turn off all hooks disableAllHooks on/off: no hook runs, from settings files or plugins, and neither does the status line

¹ Kept in the profile’s .claude.json, as /config does, not in settings.json. Claude Code re-reads that file before it writes it, so a change made here is not lost; an open session picks it up when it restarts. ² Edited where a settings file already has it, otherwise in .claude.json, as /config does.

Settings that /config turns on by removing the key (Thinking mode, Prompt suggestions, Session recap, Artifacts) are removed here too when you turn them on, and so is Turn off all hooks when you turn it off. The model is picked with /model in Claude Code, so it is not listed here. Effort level and the renderer are not in /config either: edit them in the advanced editor.

Dropdowns list the values the Claude Code settings schema accepts. They were checked against the version shown in the tab. A value already in your file that is not in the list stays selectable as (current value), so nothing is lost.

Changes in General are not saved one by one: each changed row is marked, and a bar at the bottom counts them, with Cancel and Save changes. Saving writes them all in one backup and keeps the page where it is. Switching profile or closing the page with unsaved changes asks first.

For each setting you see:

Apply a setting to every profile

Apply to all… first shows which profiles change (old value → new value, and the file) and which are skipped, with the reason:

Each profile is written where its value lives, as with a normal save. If the value is the default, the setting is removed wherever it is set. It is one operation with one backup covering every profile: one Restore in the Backups tab undoes it all.

CLAUDE.md

CLAUDE.md in the profile folder holds global instructions, loaded at the start of every session in that profile. It is the right place for context that must always apply (“in this profile you work for …”, conventions, tools to prefer). If it does not exist, saving creates it.

Permissions

Rules in settings.json, one per line, in three lists:

Precedence: deny wins over ask, which wins over allow. Examples:

Bash(npm run test:*)
Read(~/Documents/**)
mcp__claude_ai_Gmail

Other keys of permissions (such as defaultMode) are preserved. Rules in settings.local.json are shown as a count; edit them in the advanced editor.

Add a rule to every profile… adds one rule to one list (allow, ask or deny) in the settings.json of every profile. The confirmation lists the profiles that change and the ones skipped: those that already have the rule in that list, those sharing settings.json with a profile already changed, and those whose settings.json has an error. If a profile has the same rule in another list, the confirmation says so. One backup covers every profile.

Hooks

Hooks are commands Claude Code runs on its own events: a formatter after every edit (PostToolUse), a notification when Claude needs you (Notification), a check before a session starts (SessionStart). The Hooks section lists those of settings.json and settings.local.json, one row each: the event, the matcher (every when empty), what it runs, its timeout, and the file it is in.

Other hook types (prompt, agent, http, mcp_tool) are listed, copied and deleted here, and edited in the advanced editor. Hooks that installed plugins bring (their hooks/hooks.json) are listed under From plugins, read-only.

If the file changed after the page loaded it, for example because you edited it in an editor, an edit or a delete is refused with reload and try again instead of touching the wrong hook. cc-profiles never runs a hook. When Turn off all hooks is on, the section says so: none of them runs.

Keyboard shortcuts

keybindings.json in the profile folder holds the shortcuts that /keybindings edits in Claude Code. The section lists the shortcuts it sets (context, keys, action, or unbound for null) and edits the file as JSON:

{
  "bindings": [
    { "context": "Chat", "bindings": { "ctrl+e": "chat:externalEditor", "ctrl+g": "command:review", "ctrl+u": null } }
  ]
}

The file is checked as Claude Code checks it. A missing bindings list or an action that is not text or null cannot be saved. An unknown context, or a command: binding outside the Chat context, is saved with a warning, since Claude Code ignores only that binding. Without the file, Claude Code’s default shortcuts apply, and saving creates it.

Copy to… and Apply to all… give other profiles this profile’s saved file, replacing theirs (each one goes to the backup). Remove file goes back to the default shortcuts. Under the editor, each other profile shows how many shortcuts it sets, or the same.

Advanced editor

Edits the whole settings.json or settings.local.json: hooks, env, attribution, and anything else. The JSON is checked as you type, Format re-indents it, Save settings.json (or Save settings.local.json) saves the file shown, and invalid JSON or a non-object cannot be saved.

Global

.claude.json is mostly Claude Code’s internal state (caches, counters, tips already seen) and is shown read-only. The only setting you can change here is Auto-updates (autoUpdates).

Status line

Below General, Status line builds the line Claude Code shows under the prompt: tick the pieces, put them in order, pick brackets, separator and colors, and check the preview; or set your own command. See Status line.