본문으로 건너뛰기

설치

요구 사항​

  • Node.js 18.0 이상
  • npm 8.0 이상 (Node.js와 함께 제공)
  • Git (버전 관리 기능용)

npm으로 설치​

npm install -g archicore

설치 확인​

archicore --version
# ArchiCore v0.1.0

인증​

ArchiCore를 사용하기 전에 인증이 필요합니다:

archicore login

이 명령은:

  1. ArchiCore 로그인 페이지를 브라우저에서 엽니다
  2. 로그인 후 CLI를 자동으로 구성합니다
  3. 자격 증명을 안전하게 저장합니다

디바이스 코드 플로우 (헤드리스)​

브라우저가 없는 서버의 경우:

archicore login --device-code

ArchiCore Device Auth에서 입력할 코드가 표시됩니다.

프로젝트 초기화​

프로젝트 디렉토리로 이동하여 실행:

cd /프로젝트/경로
archicore init

기본 구성을 가진 .archicore/ 디렉토리가 생성됩니다.

업데이트​

npm update -g archicore

제거​

npm uninstall -g archicore

구성도 제거하려면:

rm -rf ~/.archicore

플랫폼별 참고 사항​

Windows​

PowerShell 또는 Git Bash를 사용하세요. 명령 프롬프트는 작동하지만 기능이 제한됩니다.

# PowerShell
npm install -g archicore

Linux​

전역 설치에 sudo가 필요할 수 있습니다:

sudo npm install -g archicore

또는 npm이 로컬 디렉토리를 사용하도록 구성:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
npm install -g archicore

macOS​

npm install -g archicore

권한 오류가 발생하면:

sudo chown -R $(whoami) $(npm config get prefix)/{lib/node_modules,bin,share}
npm install -g archicore

문제 해결​

"EACCES: 권한 거부됨"​

sudo npm install을 사용하지 마세요. 대신 npm 권한을 수정:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

"archicore: 명령을 찾을 수 없음"​

npm 전역 bin이 PATH에 있는지 확인:

export PATH="$(npm bin -g):$PATH"

영구적으로 만들려면 ~/.bashrc 또는 ~/.zshrc에 추가하세요.

프록시 환경​

npm config set proxy http://proxy.company.com:8080
npm config set https-proxy http://proxy.company.com:8080
npm install -g archicore