> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CometAPI와 함께 Gemini CLI 사용하기

> 이 가이드를 사용해 CometAPI 자격 증명, base URL 설정, Gemini model ID로 Gemini CLI를 구성하세요.

이 가이드를 사용해 API 엔드포인트로 CometAPI를 설정하여 [Gemini CLI](https://github.com/google-gemini/gemini-cli)를 실행하세요.

공식 참고 자료:

* [Gemini CLI GitHub](https://github.com/google-gemini/gemini-cli)
* [Gemini CLI Authentication](https://github.com/google-gemini/gemini-cli/blob/main/docs/get-started/authentication.mdx)

<Note>
  모델 제공 여부는 시간이 지남에 따라 변경될 수 있습니다. 사용 가능한 Gemini 모델은 [CometAPI Models page](/ko/overview/models)에서 확인하세요.
</Note>

## 사전 요구 사항

| 요구 사항        | 세부 정보                                                            |
| ------------ | ---------------------------------------------------------------- |
| Node.js      | 22+ (LTS 권장)                                                     |
| OS           | macOS, Linux 또는 Windows                                          |
| CometAPI key | [CometAPI Dashboard](https://www.cometapi.com)에서 발급 ( `sk-`로 시작) |

## 설정

<Steps>
  <Step title="Gemini CLI 설치">
    ```bash theme={null}
    npm install -g @google/gemini-cli
    ```

    또는 Homebrew(macOS / Linux)로 설치:

    ```bash theme={null}
    brew install gemini-cli
    ```

    확인:

    ```bash theme={null}
    gemini --version
    ```
  </Step>

  <Step title="환경 변수 설정">
    ```bash theme={null}
    export GEMINI_API_KEY="sk-your-cometapi-key"
    export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"
    ```

    `sk-your-cometapi-key`를 실제 CometAPI 키로 바꾸세요.
  </Step>

  <Step title="Gemini CLI 시작">
    ```bash theme={null}
    cd your-project
    gemini
    ```

    처음 실행하면 테마 선택, 안전 고지 확인, 작업 디렉터리 신뢰 여부를 묻는 안내가 표시됩니다.
  </Step>
</Steps>

## 환경 변수 영구 저장

세션마다 다시 export하지 않으려면 셸 설정에 추가하세요:

```bash theme={null}
# Add to ~/.zshrc (macOS) or ~/.bashrc (Linux)
export GEMINI_API_KEY="sk-your-cometapi-key"
export GOOGLE_GEMINI_BASE_URL="https://api.cometapi.com"
```

변경 사항을 적용하려면 터미널을 다시 시작하세요.

## 문제 해결

<AccordionGroup>
  <Accordion title="유효하지 않은 API Key 오류">
    `GEMINI_API_KEY`가 올바르게 설정되었는지 확인하세요. 확인하려면 `echo $GEMINI_API_KEY`를 실행하세요.
  </Accordion>

  <Accordion title="fetch failed">
    네트워크 제한으로 인해 연결이 차단될 수 있습니다. 시스템 전체 프록시를 사용해 보세요.
  </Accordion>

  <Accordion title="잘못된 Node.js 버전">
    Gemini CLI는 Node.js 22+가 필요합니다. 확인하려면 `node --version`을 실행하세요.
  </Accordion>

  <Accordion title="Gemini CLI 제거">
    `npm uninstall -g @google/gemini-cli`를 실행하세요.
  </Accordion>
</AccordionGroup>

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "HowTo",
        "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#howto",
        "name": "CometAPI와 함께 Gemini CLI 사용하기",
        "description": "이 가이드를 사용해 CometAPI 자격 증명, base URL 설정, Gemini model ID로 Gemini CLI를 구성하세요.",
        "step": [
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-1",
            "position": 1,
            "name": "Gemini CLI 설치",
            "text": "CometAPI와 함께 Gemini CLI 사용하기 가이드의 Gemini CLI 설치 단계를 완료하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-2",
            "position": 2,
            "name": "환경 변수 설정",
            "text": "CometAPI와 함께 Gemini CLI 사용하기 가이드의 환경 변수 설정 단계를 완료하세요."
          },
          {
            "@type": "HowToStep",
            "@id": "https://apidoc.cometapi.com/integrations/gemini-cli#step-3",
            "position": 3,
            "name": "Gemini CLI 시작",
            "text": "CometAPI와 함께 Gemini CLI 사용하기 가이드의 Gemini CLI 시작 단계를 완료하세요."
          }
        ]
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI 문서",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "통합",
            "item": "https://apidoc.cometapi.com/integrations"
          },
          {
            "@type": "ListItem",
            "position": 3,
            "name": "CometAPI와 함께 Gemini CLI 사용하기",
            "item": "https://apidoc.cometapi.com/integrations/gemini-cli"
          }
        ]
      }
    ]
    }
    `}
</script>