rocky linux 10 에 gemini-cli 설치

록키리눅스 10에 gemini cli 설치법

1. # Node.js 20 버전 설치 예시
vonguy@localhost:~$ curl -fsSL https://rpm.nodesource.com/setup_20.x
vonguy@localhost:~$ sudo bash -
[sudo] vonguy 암호: 

2. 
vonguy@localhost:~$ sudo dnf install nodejs -y

3.
설치되었습니다:
  nodejs-2:20.19.6-1nodesource.x86_64                                           
vonguy@localhost:~$ npm -v
10.8.2

4.
vonguy@localhost:~$ npm install -g @google/gemini-cli
npm error code EACCES

이 에러는 \*\*권한 문제(EACCES: permission denied)\*\*로 인해 발생했습니다. 🛑

현재 사용자 계정으로 **`/usr/lib/node_modules`** 디렉터리에 파일을 생성(mkdir)하거나 쓰는 권한이 없기 때문에 전역 설치가 실패한 것입니다. 이 디렉터리는 시스템 전체에서 사용되는 패키지를 위한 위치로, 일반적으로 **관리자(root)** 권한이 필요합니다.

Rocky Linux 10에서 이 문제를 해결하는 가장 안전하고 권장되는 방법은 다음과 같습니다.

-----

## 🛠️ 해결 방법 (권장: 사용자 디렉터리에 npm 전역 설치 경로 설정)

시스템 디렉터리를 수정하는 대신, `npm`이 전역 패키지를 사용자 홈 디렉터리 내의 안전한 위치(예: `~/.npm-global`)에 설치하도록 설정하는 것이 가장 좋은 방법입니다. 이렇게 하면 **`sudo` 없이** 전역 패키지를 설치할 수 있습니다.

### 1\. 전역 설치 경로 설정

다음 명령어를 순서대로 실행하여 전역 설치 폴더를 사용자 홈 디렉터리로 변경하고, 해당 경로를 시스템 환경 변수에 추가합니다.

```bash
# 1. 홈 디렉터리에 새로운 전역 설치 폴더 생성
mkdir -p ~/.npm-global

# 2. npm의 기본 전역 설치 경로를 새 폴더로 설정
npm config set prefix '~/.npm-global'
```

### 2\. 환경 변수 업데이트

Shell이 새로운 전역 패키지 실행 파일($PATH$)을 찾을 수 있도록 환경 변수를 업데이트합니다.

  * `~/.bashrc` (또는 사용하는 셸에 따라 `~/.zshrc`) 파일을 엽니다.

    ```bash
    nano ~/.bashrc
    # 또는 vi ~/.bashrc
    ```

  * 파일의 맨 아래에 다음 줄을 추가합니다.

    ```bash
    export PATH=~/.npm-global/bin:$PATH
    ```

  * 파일을 저장하고 닫은 후, 변경 사항을 즉시 적용합니다.

    ```bash
    source ~/.bashrc
    ```

### 3\. Gemini CLI 재설치

이제 관리자 권한 없이 Gemini CLI를 다시 설치할 수 있습니다.

```bash
npm install -g @google/gemini-cli
```

이 명령은 이제 `/usr/lib/node_modules` 대신 **`~/.npm-global`** 디렉터리에 Gemini CLI를 설치하며, **`gemini`** 명령어가 정상적으로 실행될 것입니다.

-----

설치가 완료되면, gemini 명령을 입력하여 CLI를 실행하고 인증 절차를 시작합니다.
Bash

gemini

1. 초기 설정 및 테마 선택

CLI가 시작되면, 색상 테마를 선택하라는 안내가 나옵니다. 화살표 키로 원하는 테마를 선택하고 Enter를 누르세요.

2. 인증 방법 선택

다음으로, Gemini API를 사용하기 위한 인증 방법을 선택해야 합니다.

    Google 계정으로 로그인 (권장):

        "Login with Google" 옵션을 선택하고 Enter를 누르세요.

        터미널에 인증 URL이 표시되며, 자동으로 웹 브라우저가 열릴 것입니다.

        웹 브라우저에서 Google 계정으로 로그인하고 권한을 승인하면 됩니다. (이 방법은 API 키 관리 없이 무료 사용 한도 내에서 Gemini 2.5 Pro 모델을 포함한 모델에 접근할 수 있게 해줍니다.)

    API 키 사용 (선택 사항):

        "Use Gemini API Key" 옵션을 선택했다면, 미리 발급받은 Gemini API 키를 입력하라는 메시지가 나옵니다.

인증이 완료되면, Gemini CLI의 대화형 인터페이스로 바로 진입하게 되며, 이제 Rocky Linux 터미널에서 Gemini AI를 사용할 수 있습니다!