[BUG] User Agents Incorrectly Marked as "Overridden by projectSettings"
Resolved 💬 16 comments Opened Oct 20, 2025 by pnunezcalzado Closed Jan 12, 2026
Preflight Checklist
- [x] I have searched existing issues and this hasn't been reported yet
- [x] This is a single bug report (please file separate reports for different bugs)
- [x] I am using the latest version of Claude Code
What's Wrong?
Description
When running /agents, user-level agents are incorrectly displayed with a warning indicator ⚠ overridden by projectSettings, even though the project has no agent configuration.
Actual Behavior
User agents display with the ⚠ overridden by projectSettings warning, suggesting there's a project-level override when none exists.
Environment
- The project's
.claude/settings.jsoncontains:
``json``
{
"permissions": {
"deny": [
"Read(./.idea/**)",
"Read(./dist/**)",
...
]
}
}
- No agent configuration exists in the project
- User-level agents are present in
~/.claude/agents/
Output Example
User agents (/Users/.../.claude/agents)
code-review · sonnet ⚠ overridden by projectSettings
code-auditor · sonnet ⚠ overridden by projectSettings
backend-ts · sonnet ⚠ overridden by projectSettings
Project agents (/Users/.../.claude/agents)
code-review · sonnet
code-auditor · sonnet
backend-ts · sonnet
What Should Happen?
User agents should not show the "overridden by projectSettings" warning when the project settings do not contain any agent configuration.
Error Messages/Logs
Steps to Reproduce
- Create a project with a
.claude/settings.jsonthat contains only permissions (no agent configuration) - Have user-level agents defined in
~/.claude/agents/ - Run
/agentscommand in the project
Claude Model
Other
Is this a regression?
Yes, this worked in a previous version
Last Working Version
_No response_
Claude Code Version
2.0.24 (Claude Code)
Platform
Anthropic API
Operating System
macOS
Terminal/Shell
Other
Additional Information
Model: Haiku
Terminal/Shell: WebStorm terminal
16 Comments
I'm having the same issue. Is there a solution available?
I am facing the same issue in my computer:
<img width="864" height="480" alt="Image" src="https://github.com/user-attachments/assets/6c9e35dc-2dd3-4dcd-a742-d4643e6ae498" />
In my case, I also noticed that starting claude from within a project folder makes this problem even worse, the agents appear 3 times: twice caused by the user level agents being duplicated into project level agents, then one more time because of the project level agents. In my case, they are the same, but I would expect a full override instead of duplication. See the image below:
<img width="864" height="430" alt="Image" src="https://github.com/user-attachments/assets/80ecbbf8-fc95-42f7-a092-3fbe0d5adfa9" />
Having the same issue, and it says the agent is not available.
<img width="560" height="413" alt="Image" src="https://github.com/user-attachments/assets/08de2162-1208-491b-b370-a0fa6c133602" />
same
Same, and my local agents are not even shown, even though they exist.
Same problem here
same issue as reported.
Same issue here
Same issue here!!
any solution yet ?
same problem here
same problem here
Same here.
This issue has been inactive for 30 days. If the issue is still occurring, please comment to let us know. Otherwise, this issue will be automatically closed in 30 days for housekeeping purposes.
This issue has been automatically closed due to 60 days of inactivity. If you're still experiencing this issue, please open a new issue with updated information.
This issue has been automatically locked since it was closed and has not had any activity for 7 days. If you're experiencing a similar issue, please file a new issue and reference this one if it's relevant.