[BUG] illegal hardware instruction, please compile without the AVX2 requirement
Resolved 💬 24 comments Opened Aug 15, 2025 by diwu-sf Closed Jan 25, 2026
💡 Likely answer: A maintainer (ant-kurt, collaborator)
responded on this thread — see the highlighted reply below.
Environment
- Platform (select one):
- [X] Anthropic API
- Claude CLI version:
1.0.81 - Operating System: mac 12.7.6
- Terminal: iterm2
Bug Description
Claude native install has CPU hardware instruction problem:
claude --version
[1] 36152 illegal hardware instruction
Macbook is Retina 15 early 2013, cpu is Intel (3635QM)
This CPU does NOT have AVX2 / BMI2 / FMA support
Steps to Reproduce
- Use older intel macbook without AVX2 instructions
- Install claude code via npm
- Do native install, try to run, and hit error
Expected Behavior
It should not crash on unknown cpu instruction
Actual Behavior
Crashes due to unknown instruction
Additional Context
Claude code native build is not that CPU intensive, so I don't see why it would need to be compiled with AVX2 requirement. In Rust, please compile with target RUSTFLAGS="-C target-cpu=x86-64" and this should fix it by going back to the normal baseline x86-64 instructions
24 Comments
@diwu-sf can you see if this repros in version 1.0.69 ?
similar problem, is the build machine running with
target-cpu=native?This should be working better in upcoming release 1.0.84 - likely rolling out Monday
@ant-kurt this is still happening with 1.0.84.
For reference the NPM version works fine, even the ripgrep binary from the npm install works fine.
Hmm - can you try running v1.0.84 with env var
USE_BUILTIN_RIPGREP=0to see if that isolates the problem?oo, same thing happening with me
Apple M1 Pro Sonoma 14.7.6(23H626)
i got this illegal instruction when installing with native
then i went to brew cask, and installment passed but i couldn't boot it after installment... here is the log
npm version worked fine with me before too.
@ant-kurt version 1.0.86 native still has trouble on that intel macbook without the avx2
Env var
USE_BUILTIN_RIPGREP=0does not helpI have the same issue with native install script - Mac Mini 4,1 - Linux Mint 22.2 Zara
Tried setting USE_BUILTIN_RIPGREP=0, with no impact
npm install succeeds, and claude code works properly
same issue on mac pro m1
illegal hardware instruction claudeNot exactly the same issue as the original post but I am getting
Illegal instruction: 4when I run theclaudecommand after installing via Homebrew. I tried installing via curl and gotbash: line 142: 2857 Illegal instruction: 4 "$binary_path" install ${TARGET:+"$TARGET"}. I am on a 2021 Macbook Pro with Apple M1 Max chip and Sonoma 14.6.1.Update:
Somehow I was running an intel shell on my M1 mac. To fix this I ran
chsh -s /bin/zsh. Then I reinstalled homebrew, ensuring it was the ARM version installed in/opt/homebrew. Then I reinstalled Claude and deleted the old Claude at/usr/local/bin/claude. This is not a bug with Claude, I'm just leaving this here in case someone else has a similar issue.arch -arm64 brew install --cask claude-code
My problem has been solved
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.
on MacOS M1
first i installed with
curl -fsSL https://claude.ai/install.sh | bashand got this error:then i successfully installed with
arch -arm64 brew install --cask claude-code, but when runclaudecommand, got this errorfinally, i uninstalled and installed via
npm install -g @anthropic-ai/claude-code. now, it worked fineThis 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 was closed incorrectly despite recent human comments. This behavior of the bot is reported at https://github.com/anthropics/claude-code/issues/16497. Please upvote that issue, so maybe it gets noticed.
Still happening! On a circa 2012 Mac Mini
CPU: Intel(R) Core(TM) i5-3210M CPU @ 2.50GHz
AVX flags:
AVX1.0
vinest@Pippin-190 bi
same here on Intel(R) Core(TM)2 Duo CPU P8600 @ 2.40GHz
claude --version
Illegal instruction (core dumped)
@UNIXTCPIP you’re using for moltbot?
Seeing the same, illegal instructions on late 2013 Mac Pro, 2.7 GHz 12-Core Intel Xeon E5. Manifests with both curl install and brew.
to make it clear, npm install works fine the problem is with the native install. please add support for older CPUs.
Have the same issue on MacBook Pro 13-inch M1.
Same on Intel Mac Pro
Verified that this is still happening on a Mac Pro 3,1 running Ubuntu 22.04 LTS.
I can install the NPM version, but I can't install the native version because it fails when it tries to run the downloaded binary, and the VS Code extension also fails.
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.