AIToday
AI Coding AssistantsZenn AI/MLPublished: Oct 18, 2026, 10:00 JST

Claude Code bypassPermissions moves to user settings after v2.1.257

Claude Code bypassPermissions moves to user settings after v2.1.257

3 Key Points

  1. What happened

    A Zenn guide says bypassPermissions no longer loads from a project settings file since v2.1.257, so it must be set via permissions.defaultMode in ~/.claude/settings.json and the project's defaultMode line deleted.

  2. Why it matters

    Anyone who wrote the mode into a project's settings.json or settings.local.json will find the mode ignored on startup and must move the setting to the user file and restart, or it will not apply.

Not sure about something? Ask the AI

Questions and answers are published on this page.

Summaries like this, in your inbox every morning.

Context & Analysis

The change described in the guide is specific: since v2.1.257, writing bypassPermissions into a project's settings file no longer has any effect, and Claude Code instead starts in a mode that asks for confirmation. That is why the guide's steps center on relocation rather than on a new feature — the same string simply has to live in the user settings file, at permissions.defaultMode, for the terminal to read it at launch.

The guide also notes that when the mode is specified in more than one file, the project side wins, which is why deleting the project-level defaultMode line is part of the fix. Separately, it points out that if no mode is specified, terminal sessions start in auto mode as of v2.1.283, and that even in bypass mode operations listed under ask or destructive actions such as deleting important locations will still prompt.

The instructions were verified against Claude Code v2.1.296 on October 12, 2026, using the official documentation and the CHANGELOG, so behavior in later versions is not covered. The guide also notes that the VS Code extension reads its startup mode from a different setting and is outside the scope of these steps.

FAQ
Why does Claude Code still ask for permission every time even after I set bypassPermissions?
Because since v2.1.257 the mode is no longer read from a project settings file; if it remains there, Claude Code starts with permission prompts. Move the setting to permissions.defaultMode in the user settings file and delete the project-level entry.
Where is the user settings file located?
On mac and Linux it is ~/.claude/settings.json, and on Windows it is %USERPROFILE%\.claude\settings.json. If the file does not exist, create it with a permissions block containing defaultMode set to bypassPermissions.
Does this procedure work for the VS Code extension?
No. The VS Code extension determines its startup mode from its own setting, claudeCode.initialPermissionMode, not from project settings files, so the terminal procedure does not apply.

AI news that matters for your work, delivered every morning.

Pick your industry and the AI tools you use, and get news related to your work every day.

Free · 30 seconds with Google · unsubscribe anytimeWhat is AIToday? →

Ask AI

Ask AI anything about this article. The AI reads this article, earlier AIToday articles, and Wikipedia, and cites its sources. Q&As are published on this page for other readers too.

Questions and answers are published on this page.

Related Articles

Next articleMeta pulls scraping clause from business terms after Nieman Lab scrutiny