Claude Code가 안에서 코드를 돌리는 엔진을 Node.js에서 Bun으로 바꾸면서, Bun 기본 설치본이 요구하는 AVX 명령어가 문제가 됐어요. AVX를 가상 서버 안쪽에 열어주지 않는 Proxmox·KVM·VMware 같은 상당수 VPS에서, 시작하자마자 "실행할 수 없는 명령"이라며 멈춰버려요. 원 글은 "Bun을 가벼운 baseline 설치본으로 바꾸면 한 줄로 해결"이라지만, 실제로는 함께 묶여 들어간 Bun을 갈아끼울 방법이 없고 baseline을 넣어도 멈춘 사례가 있어 일반적인 해법으로 보긴 어려워요. 더 확실한 건 가상화 프로그램의 CPU 설정을 host로 바꿔 진짜 CPU의 AVX를 가상 서버에 그대로 넘기는 방법이고, 오래 쓰이던 npm 설치 우회마저 v2.1.126부터 막혔어요.
용어 풀이
- AVX
- CPU가 여러 숫자를 한 번에 계산하게 해주는 고급 명령어 모음(고성능 연산용)
- VPS
- 한 대의 서버를 여러 개로 쪼개 빌려 쓰는 가상 서버
- CPU
- 컴퓨터에서 실제 계산을 도맡는 핵심 부품
- 하이퍼바이저
- 컴퓨터 한 대 위에 여러 가상 서버를 만들어 굴리는 가상화 프로그램
- Node.js · Bun
- 자바스크립트로 만든 프로그램을 실행해 주는 엔진(Bun이 더 새것)
운영자 인사이트
엔진을 Bun으로 통일하면서 AVX가 꺼진 가상 환경을 놓친 사례예요. 사내 VPS나 집 서버(홈랩)에 도구를 깔 땐, 미리 grep avx /proc/cpuinfo 명령으로 그 서버가 AVX를 지원하는지부터 확인하는 게 안전해요.
여러 관점으로 보기
- 현상·원 제보 엔진을 Bun으로 바꾼 뒤 AVX를 지원하지 않는 가상 환경에서 Claude Code가 바로 멈춘다는 버그 신고로, 어떤 환경이 영향받는지 정리돼 있어요. GitHub Issue #19981
- "한 줄 해결" 반론 함께 묶여 들어간 Bun 실행 파일은 사용자가 갈아끼울 방법이 없어서, baseline 설치본으로 바꾸라는 우회법이 그대로는 통하지 않는다는 점을 짚어줘요. GitHub Issue #33153
- 실제로 통하는 해결책 Proxmox에서 CPU 설정을 host로 바꿔, 진짜 CPU의 AVX를 가상 서버로 넘기는 방법을 명령어와 화면 절차까지 보여줘요. Christopher Hart
- 공식 안내 공식 문서가 AVX 미지원이 원인일 땐 우회할 다른 실행 파일이 없다고 못 박고, AVX 지원 여부를 확인하는 명령(grep avx /proc/cpuinfo)을 안내해요. Claude Code 공식 문서