가이드

CLI 설치와 연결 오류 해결

비공개 저장소 접근 없이 공개 개발 환경의 문제를 해결합니다.

빠른 시작을 기준으로 진행하세요. 외부 개발자 설치에는 Core 복제, GitHub 토큰, 비공개 Composer 패키지, 로컬 테넌트 DB가 필요하지 않습니다. 이전 안내에서 이를 요구한다면 공개 CLI 경로로 돌아오세요.

증상에 맞는 해결 방법 찾기

증상	다음 조치
`nexia` 명령을 찾지 못함	Node.js 22 이상과 `npm install --global @nexia/cli@alpha`를 설치한 뒤 터미널을 다시 열고 npm 실행 경로를 확인합니다.
브라우저 승인 시간 만료	`nexia login <project-id>`를 다시 실행하고 프로젝트 콘솔에서 새 코드를 승인합니다.
샌드박스가 준비되지 않았거나 만료됨	프로젝트 개발 공간 페이지에서 준비 완료를 기다리거나 사용 기간을 연장합니다.
로컬 앱을 연결하지 못함	`nexia dev my-app`을 켜 둔 채 출력된 로컬 주소를 사용합니다. 프로젝트와 워크스페이스가 일치하는지도 확인합니다.
다른 프로젝트에 연결된 앱	원하는 프로젝트를 승인한 뒤 `nexia link my-app`을 실행하고 출력된 대상을 확인합니다.
같은 버전에 다른 내용이 있음	`nexia.json`의 버전을 올리고 검사한 뒤 다시 제출합니다.
연결이 해제됨	로그인과 CLI 연결 승인을 다시 진행합니다.

계속 실패하면 OS, CLI 버전, 프로젝트 이름, 발생 시각, 민감한 정보를 제외한 재현 순서를 개발자 지원에 알려주세요. 토큰, 비밀번호, 고객 데이터는 공유하지 않습니다.

코드 예시

Shell

nexia status
nexia validate my-app12