[BUG] Agents not detected by Native binary installation (MacOS)
Resolved 💬 6 comments Opened Sep 11, 2025 by pdelre Closed Nov 7, 2025
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?
When installed from the native binary on MacOS, /agents will report there are no agents found in ~/.claude/agents. When attempting to create one from /agents, the file will be created but /agents will continue to report there are no agents found. Additionally, @agent also does not report custom agents.
What Should Happen?
Agents should be found the same as the npm distribution.
Error Messages/Logs
✅ NPM Installation
<details><summary>Output</summary>
<p>
$ /Users/pdelre/.local/share/fnm/node-versions/v18.20.2/installation/bin/claude
> /doctor
Diagnostics
└ Currently running: unknown (1.0.111)
└ Path: /Users/pdelre/.local/share/fnm/node-versions/v18.20.2/installation/bin/node
└ Invoked: /Users/pdelre/.local/share/fnm/node-versions/v18.20.2/installation/bin/claude
└ Config install method: unknown
└ Auto-updates enabled: default (true)
└ Search: OK (vendor)
Warning: Multiple installations found
└ npm-global at /Users/pdelre/.local/share/fnm/node-versions/v18.20.2/installation/bin/claude
└ native at /Users/pdelre/.local/bin/claude
> /agents
╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ Agents │
│ 80 agents │
│ │
│ ❯ Create new agent │
│ │
│ User agents (/Users/pdelre/.claude/agents) │
│ devops-troubleshooter · sonnet │
│ frontend-developer · sonnet │
│ csharp-pro · sonnet │
│ mobile-developer · sonnet
| ....
│ seo-authority-builder · sonnet │
│ sales-automator · haiku │
│ customer-support · sonnet │
│ │
│ Built-in agents (always available) │
│ general-purpose · sonnet │
│ statusline-setup · sonnet │
│ output-style-setup · sonnet │
│ │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Press ↑↓ to navigate · Enter to select · Esc to go back</p>
</details>
❌ Native installation
<details><summary>Output</summary>
<p>
$ /Users/pdelre/.local/bin/claude
> /doctor
Diagnostics
└ Currently running: native (1.0.111)
└ Path: /Users/pdelre/.local/state/fnm_multishells/91089_1756824571303/bin/claude
└ Invoked: /Users/pdelre/.local/share/claude/versions/1.0.111
└ Config install method: native
└ Auto-updates enabled: default (true)
└ Search: OK (bundled)
Warning: Multiple installations found
└ npm-global at /Users/pdelre/.local/share/fnm/node-versions/v18.20.2/installation/bin/claude
└ native at /Users/pdelre/.local/bin/claude
Warning: Leftover npm global installation at /Users/pdelre/.local/share/fnm/node-versions/v18.20.2/installation/bin/claude
Fix: Run: npm -g uninstall @anthropic-ai/claude-code
> /agents
╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ Agents │
│ No agents found │
│ │
│ ❯ Create new agent │
│ │
│ No agents found. Create specialized subagents that Claude can delegate to. │
│ Each subagent has its own context window, custom system prompt, and specific tools. │
│ Try creating: Code Reviewer, Code Simplifier, Security Reviewer, Tech Lead, or UX Reviewer. │
│ │
│ │
│ Built-in (always available): │
│ general-purpose · sonnet │
│ statusline-setup · sonnet │
│ output-style-setup · sonnet │
│ │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Press ↑↓ to navigate · Enter to select · Esc to go back</p>
</details>
❌ Homebrew installation
<details><summary>Output</summary>
<p>
$ /opt/homebrew/bin/claude
> /doctor
Diagnostics
└ Currently running: native (1.0.111)
└ Path: /Users/pdelre/.local/state/fnm_multishells/91089_1756824571303/bin/claude
└ Invoked: /opt/homebrew/Caskroom/claude-code/1.0.111/claude
└ Config install method: native
└ Auto-updates enabled: default (true)
└ Search: OK (bundled)
Warning: Multiple installations found
└ npm-global at /Users/pdelre/.local/share/fnm/node-versions/v18.20.2/installation/bin/claude
└ native at /Users/pdelre/.local/bin/claude
Warning: Leftover npm global installation at /Users/pdelre/.local/share/fnm/node-versions/v18.20.2/installation/bin/claude
Fix: Run: npm -g uninstall @anthropic-ai/claude-code
> /agents
╭─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ Agents │
│ No agents found │
│ │
│ ❯ Create new agent │
│ │
│ No agents found. Create specialized subagents that Claude can delegate to. │
│ Each subagent has its own context window, custom system prompt, and specific tools. │
│ Try creating: Code Reviewer, Code Simplifier, Security Reviewer, Tech Lead, or UX Reviewer. │
│ │
│ │
│ Built-in (always available): │
│ general-purpose · sonnet │
│ statusline-setup · sonnet │
│ output-style-setup · sonnet │
│ │
╰─────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
Press ↑↓ to navigate · Enter to select · Esc to go back</p>
</details>
Steps to Reproduce
- Have agents in
~/.claude/agents/ - Install from native instructions or Homebrew
- Native:
curl -fsSL https://claude.ai/install.sh | bash - Homebrew:
brew install claude-code - Start
claude - Run
/agents
Claude Model
None
Is this a regression?
I don't know but it's at least an issue for the past 2 weeks of releases. I wasn't trying to use agents before that.
Last Working Version
I don't know
Claude Code Version
1.0.111
Platform
Anthropic API
Operating System
macOS
Terminal/Shell
Other
Additional Information
_No response_
This issue has 6 comments on GitHub. Read the full discussion on GitHub ↗