---
title: AI 계정 및 구독
description: AI Chat용 AI 소스(API 키, OpenRouter 또는 Google 로그인, 패널 제공자)를 연결하고, 공식 CLI를 통해 자신만의 Claude, ChatGPT 또는 Gemini 구독을 사용하세요.
url: https://nexcmp.com/ko/docs/configure-with-ai/ai-accounts-and-subscriptions/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# AI 계정 및 구독 {#ai-accounts-and-subscriptions}

> **관리자 위치:** System › Settings › AI accounts (`/agent/accounts`), **Accounts** 탭 및 **Use your own AI subscription**. 선택 사항인 터미널은 AI Console (`/agent/console`)이며, AI Chat이 활성화된 경우에만 나타납니다.

## 작동 내용 {#what-it-does}

AI Chat이 응답하려면 소스가 필요합니다. 이 페이지에서 관리자 계정용 소스를 연결할 수 있습니다:

- **API 소스**: OpenAI, Anthropic (Claude), Google Gemini, OpenRouter (API 키 또는 로그인 사용).
- **패널 AI 제공자**: System › Settings › AI provider에서 이미 설정한 경우.
- **자신의 AI 구독** (Claude, ChatGPT, Gemini): 패널 서버나 사용자 컴퓨터에서 벤더의 **공식 명령줄 도구**를 통해 사용.

연결한 모든 항목은 관리자 계정에 속합니다. 키와 토큰은 본인만 사용할 수 있도록 암호화되어 저장되며 다른 관리자는 사용할 수 없습니다.

## 요구 사항 {#requirements}

| 항목 | 요구 사항 |
|---|---|
| 역할 | 로그인한 관리자. 데모 패널에서는 아무것도 연결하거나 제거할 수 없습니다. |
| API 소스 | 벤더사의 계정 및 API 키 (카드에 벤더 페이지를 여는 **Get API key** 링크가 있습니다). |
| 패널 서버의 CLI | AI Console 활성화됨(아래 참조), 서버에서 벤더 및 `nodejs.org` 그리고 npm 레지스트리로의 아웃바운드 HTTPS, 그리고 **2 GB 이상의 RAM** (CLI 실행 시 약 1 GB의 여유 공간 필요; 2 GB 미만인 경우 설치 프로그램이 경고함). Node.js 20 이상이 있으면 사용하며, 그렇지 않으면 설치 프로그램이 체크섬 검사와 함께 Node.js 22를 다운로드합니다. |
| 사용자 컴퓨터의 CLI | CLI를 설치하기 위한 Node.js 20 이상 및 본인의 구독. |

## API 소스 연결 {#connect-an-api-source}

1. **System › Settings › AI accounts**를 열고 **Accounts** 탭에 머뭅니다.
2. 소스 카드에서 **Connect**을 클릭합니다. 새 탭에서 공급자의 키 페이지가 열리면 거기서 키를 생성하세요.
3. 해당 필드에 키를 붙여넣고 저장합니다. 카드가 마지막 네 글자와 함께 연결된 상태를 표시합니다.
4. 다른 모델을 원하면 **default model**을 선택한 다음 **Test**을 클릭합니다. 결과가 "Connected - example-model, 850 ms"와 비슷하게 표시되면 정상입니다.

![API 소스 카드, 연결된 OpenAI 카드, Panel AI 공급자 카드가 있는 AI 계정 페이지](https://nexcmp.com/ko/docs/images/configure-with-ai/ai-accounts-and-subscriptions-01-accounts.webp)

| Source | 로그인 대안 |
|---|---|
| OpenRouter | **Sign in with OpenRouter**을 클릭하면 팝업이나 탭에서 OpenRouter가 열리며, 승인하면 이 페이지로 돌아와 연결됩니다. |
| Google Gemini | **Sign in with Google**은 **Set up Google sign-in (optional)** 아래 카드에 **직접** Google Cloud 프로젝트에서 생성한 OAuth 클라이언트(`.apps.googleusercontent.com`로 끝나는 클라이언트 ID 및 시크릿)를 저장한 후에 나타납니다. NexCMP는 공유 Google 클라이언트를 제공하지 않습니다. |
| 패널 AI 공급자 | System › Settings › AI provider([AI provider](https://nexcmp.com/ko/docs/ai/ai-providers/))에 이미 설정된 공급자를 사용합니다. 붙여넣을 필요가 없습니다. |

소스를 연결 해제하려면 해당 카드의 **Remove**를 클릭합니다. 계정에 저장된 키가 삭제됩니다.

### 기본값, 일일 한도 및 권한 {#defaults-daily-cap-and-permissions}

**Accounts** 탭 하단에서 **Defaults for AI Chat**에는 세 가지 설정이 있습니다.

| 설정 | 의미 |
|---|---|
| 기본 소스 및 모델 | 새 채팅에서 사용하는 설정입니다. 메시지별로 소스를 변경할 수 있습니다. |
| 일일 지출 한도 (USD, 0 = 제한 없음) | 기본값 5. 페이지에 "used today"가 표시됩니다. [AI Chat in the admin](https://nexcmp.com/ko/docs/configure-with-ai/ai-chat-in-admin/#daily-spending-cap)을 참조하세요. |
| 채팅 세션 권한 | 어시스턴트가 사용할 수 있는 범위입니다. `admin:read`은 항상 켜져 있고, `secrets:write`은 기본적으로 꺼져 있습니다. [Admin API keys](https://nexcmp.com/ko/docs/configure-with-ai/admin-api-keys/#scopes)를 참조하세요. |

**Save defaults**을 클릭합니다.

## 자체 AI 구독 사용 {#use-your-own-ai-subscription}

별도의 API 키 없이 이미 이용 중인 Claude, ChatGPT 또는 Gemini 플랜을 사용하여 NexCMP를 구동할 수 있습니다. 방법은 두 가지가 있습니다.

### 방법 1 (권장): 본인 컴퓨터의 CLI {#way-1-recommended-the-cli-on-your-own-computer}

자신의 컴퓨터에서 공급업체의 자체 도구를 사용하고, 공급업체의 일반적인 방식으로 자체 계정에 로그인합니다. NexCMP는 수명이 짧은 키로 서명된 MCP 호출만 수신합니다. **AI accounts › Use your own AI subscription**을 열면 도구별로 3단계 과정이 표시됩니다.

1. **Create a 7-day key**를 클릭하고 권한 수준을 선택합니다: **Read only**(`admin:read`) 또는 **Read + configuration**(`admin:read`, `catalog:write`, `infra:write`, `settings:write`). 그러면 아래 명령어에 실제 키가 포함됩니다.
2. CLI를 설치하고 로그인합니다. 키는 이 페이지에서 단 한 번만 표시됩니다.

   | 도구 | 설치 | 로그인 |
   |---|---|---|
   | Claude Code | `npm install -g @anthropic-ai/claude-code` | `claude` 실행 후 `/login` 실행 |
   | Codex CLI | `npm install -g @openai/codex` | `codex login` |
   | Gemini CLI | `npm install -g @google/gemini-cli` | `gemini` 실행 후 "Login with Google" 선택 |

3. 페이지에서 복사한 단일 명령어 또는 단일 블록을 사용하여 패널에 연결합니다:

   ```bash
   # Claude Code
   claude mcp add --transport http nexcmp https://cloud.example.com/mcp/admin \
     --header "Authorization: Bearer ak_XXXX"
   ```

   ```toml
   # Codex CLI: ~/.codex/config.toml, then: export NEXCMP_KEY=ak_XXXX
   [mcp_servers.nexcmp]
   url = "https://cloud.example.com/mcp/admin"
   bearer_token_env_var = "NEXCMP_KEY"
   ```

   ```json
   // Gemini CLI: ~/.gemini/settings.json
   { "mcpServers": { "nexcmp": {
       "httpUrl": "https://cloud.example.com/mcp/admin",
       "headers": { "Authorization": "Bearer ak_XXXX" } } } }
   ```

4. 도구를 시작하고 예를 들어 "what is left to set up in nexcmp?"라고 질문합니다. MCP 연결에 대한 모든 세부 정보는 [AI 클라이언트 연결](https://nexcmp.com/ko/docs/configure-with-ai/mcp-admin/)에 나와 있습니다.

동일한 탭에서 OAuth로 로그인하여 별도의 키가 필요 없는 **claude.ai** 및 **ChatGPT** 커넥터용 URL을 확인할 수 있습니다: [OAuth 커넥터](https://nexcmp.com/ko/docs/configure-with-ai/oauth-connectors/).

![7일 키 버튼과 3개 CLI용 설치, 로그인, 연결 명령어가 포함된 Use your own AI subscription 탭](https://nexcmp.com/ko/docs/images/configure-with-ai/ai-accounts-and-subscriptions-02-subscription.webp)

### 방법 2: 패널 서버의 CLI (설치 / 로그인 버튼) {#way-2-the-cli-on-the-panel-server-install-login-buttons}

"CLI를 통한 구독(Claude, ChatGPT, Gemini)" 아래의 카드를 사용하면 NexCMP가 패널 서버에 공식 CLI를 설치하고 자체 로그인 흐름을 열어 주므로, **AI Chat**에서 구독 정보로 답변할 수 있습니다.

**격리 방식.** CLI는 별도의 프로세스(`nexcmp-ai.service`)에서 전용 시스템 사용자 `nexcmp-ai`로 실행되며, sudo 권한이 없고 NexCMP의 데이터 및 설정 폴더에 접근할 수 없으며 메모리 제한이 적용됩니다. 모든 AI Chat 메시지마다 CLI는 허용된 NexCMP MCP 도구(셸 및 파일 도구는 비활성화됨)와 서버 전용 키만을 사용하여 시작됩니다. NexCMP는 CLI의 로그인을 읽거나 복사하지 않으며, CLI는 이를 관리자 계정용 비공개 폴더에 보관합니다.

별도로 활성화할 필요가 없습니다. 패널이 1.4.0 버전 이상으로 설치되거나 업데이트될 때 `nexcmp-ai` 사용자 및 서비스를 자동으로 설정하므로 카드를 바로 사용할 수 있습니다.

**설치 및 로그인 (관리자별):**

1. CLI 카드에서 **Login**을 클릭합니다. CLI가 아직 설치되지 않은 경우 패널이 먼저 설치를 진행합니다. 진행률 표시기와 간단한 로그를 통해 다운로드 과정(필요한 경우 Node.js, 그 후 CLI)이 표시됩니다. 서버의 RAM이 2 GB 미만인 경우 경고가 표시됩니다.
2. 카드는 CLI가 요구하는 사항을 보여줍니다:
   - **Codex CLI**: **Open the sign-in page**를 클릭하고 카드에 표시된 일회용 코드를 입력합니다. (ChatGPT 보안 설정에서 OpenAI의 디바이스 로그인이 활성화되어 있어야 합니다.)
   - **Claude Code 및 Gemini CLI**: **Open the sign-in page**를 클릭하여 로그인한 후, 벤더 페이지에 표시된 인증 코드를 **Paste the verification code here**에 붙여넣고 **Send code**를 클릭합니다.
3. 카드가 계정 및 버전 정보와 함께 "Signed in" 상태로 바뀝니다. 10분 이내에 로그인을 완료하지 않으면 취소되므로, **Login**을 다시 클릭하십시오.
4. 이제 **AI Chat**의 선택기에서 해당 소스가 표시됩니다 (예: "ChatGPT (via Codex CLI)").
5. **로그아웃(Sign out)**은 해당 계정의 CLI 로그인 정보를 제거합니다.

Claude의 경우 카드에 **I understand and accept the vendor's terms for using a subscription this way**라는 추가 스위치가 있으며 기본값은 꺼져 있습니다. 이 스위치가 켜지기 전까지는 AI Chat에서 해당 소스가 제공되지 않습니다.

![설치 및 로그인 버튼이 있는 CLI 구독 카드, Codex 카드의 일회용 코드, 그리고 Claude 카드의 이해 완료 스위치](https://nexcmp.com/ko/docs/images/configure-with-ai/ai-accounts-and-subscriptions-03-cli.webp)

### AI 벤더의 약관 {#terms-of-the-ai-vendors}

소비자 구독을 통한 로그인은 변경될 수 있는 각 벤더의 약관 적용을 받습니다. 아래의 내용은 2026년 10월 기준으로 벤더가 공표한 내용을 요약한 것이며, 법률 자문이나 벤더를 대신하는 공식 성명이 아닙니다. 이 기능을 활성화하기 전에 최신 페이지를 확인하십시오.

| 벤더 | 벤더 페이지의 내용 | Source |
|---|---|---|
| Anthropic (Claude) | 수정되지 않은 Claude Code에 개인 플랜으로 로그인하는 것은 지원됩니다. 다른 제품을 통해 구독을 사용하거나, 제품이 로그인을 수집 또는 전달하는 경우는 다르게 취급되며, 플랜 제한은 일반적인 개인용 사용을 기준으로 합니다. 이것이 Claude 카드에 안내 문구와 **I understand** 스위치가 있는 이유이며, 방법 1이 더 깔끔한 선택인 이유입니다. | https://code.claude.com/docs/en/legal-and-compliance |
| OpenAI (Codex) | Codex는 ChatGPT 계정 또는 API 키를 사용한 로그인을 지원합니다. OpenAI는 자동화를 위해 API 키를 권장하며 신뢰할 수 없거나 공개된 환경에 Codex를 노출하지 말라고 경고합니다. 카드는 본인용으로만 사용하십시오. | https://developers.openai.com/codex/auth |
| Google (Gemini CLI) | Google 계정으로 로그인, API 키 및 Vertex AI를 지원합니다. 약관은 로그인 방식에 따라 다르고 플랜의 할당량이 적용됩니다. | https://geminicli.com/docs/get-started/authentication |

이 문제를 완전히 피하려면 **API key** 소스를 사용하거나 본인 컴퓨터에서 방식 1을 이용하세요.

## AI Console {#ai-console}

AI Console은 패널 서버에서 로그인된 CLI 중 하나를 실행하기 위한 선택적 터미널 페이지입니다. **기본적으로 꺼져 있습니다**.

- 서버에서 켜거나 끄고 CLI를 관리할 수 있습니다:

  ```bash
  sudo nexcmp ai-console enable          # turn on (also creates the nexcmp-ai user and service)
  sudo nexcmp ai-console disable         # turn off
  sudo nexcmp ai-console status          # runner, console state and installed CLIs
  sudo nexcmp ai-console install claude  # or codex, or gemini
  ```

  `status`은 AI 러너 소켓의 준비 여부, AI Console의 활성화/비활성화 상태, 각 CLI의 "installed" 또는 "not installed" 여부를 출력합니다. `sudo nexcmp status`은 "AI runner: active"도 함께 보여줍니다.
- 활성화되면 AI Chat 아래에 **AI Console** 탭이 나타납니다. 로그인된 CLI를 선택하고 관리자 비밀번호(사용 중인 경우 2FA 코드 포함)를 다시 입력한 뒤 세션을 엽니다. 여기서 실행하는 명령어는 MCP 도구를 통해서만 NexCMP를 관리할 수 있으며 쉘 및 파일 도구는 비활성화된다는 안내 배너가 표시됩니다.
- 데모 설치 환경에서는 `nexcmp-ai` 사용자를 생성하지 않습니다.

![CLI 선택기, 비밀번호 필드 및 MCP 전용 경고 배너가 있는 AI Console 시작 화면](https://nexcmp.com/ko/docs/images/configure-with-ai/ai-accounts-and-subscriptions-04-console.webp)

## 확인 {#verify}

1. API 소스에서 **Test**를 실행하면 모델 이름이 반환됩니다.
2. CLI 카드에 계정과 함께 "Signed in" 상태가 표시됩니다.
3. 서버에서 `sudo nexcmp ai-console status`은(는) CLI가 설치된 것으로 나열하고, `systemctl is-active nexcmp-ai`은(는) `active`을(를) 출력합니다.
4. AI Chat에서 소스를 선택하고 "Check my setup progress"라고 물어보면 도구 카드가 나타납니다.

## 한도 및 참고 사항 {#limits-notes}

- CLI 답변은 관리자당 한 번에 5분 및 하나의 답변으로 제한됩니다. 일일 한도에는 CLI 답변이 포함되지 않습니다.
- CLI 소스의 모든 변경 사항도 AI Chat의 확인 카드에 표시되며, CLI가 스스로 변경 사항을 적용할 수는 없습니다.
- 구독 플랜에는 자체 사용량 한도가 있습니다. 벤더가 "usage limit" 또는 "not logged in"이라고 표시하면 채팅에 해당 메시지가 나타납니다.
- 소스를 제거해도 대화 내용은 삭제되지 않습니다.
- 서버를 최신 상태로 유지하세요. CLI는 '설치'를 클릭한 시점에 벤더의 공식 퍼블릭 패키지로부터 설치됩니다.

## Troubleshooting {#troubleshooting}

| 증상 | 원인 | 해결 방법 |
|---|---|---|
| 로그인이 비활성화되고 카드가 "AI tools are not ready on the server yet"라고 표시됨 | `nexcmp-ai` 서비스가 실행 중이지 않음 | 패널을 최신 버전으로 업데이트한 후 `sudo nexcmp status`을(를) 확인하세요. 읽기 전용 데모에서는 정상적인 동작입니다. |
| "이 서버에 AI tools가 아직 설치되지 않았습니다" | `nexcmp-ai` 서비스가 실행 중이지 않음(구버전 패널 또는 데모 패널) | 패널을 업데이트한 후 `sudo nexcmp ai-console install claude`(또는 `codex`, `gemini`)을(를) 실행하세요. |
| 2 GB 미만의 RAM에 대한 경고 | 서버 사양이 낮음 | 설치가 느려지거나 실패할 수 있습니다. 메모리를 늘리거나 방식 1을 사용하세요. |
| "Node.js download checksum mismatch" 또는 "download failed" | 서버가 nodejs.org에 도달할 수 없거나 프록시가 다운로드를 변조함 | 아웃바운드 HTTPS를 허용하고 다시 시도하세요. |
| 설이 오류로 끝남 | npm이 패키지를 설치할 수 없음 | 카드의 로그를 읽고, npm 레지스트리로의 아웃바운드 접근을 확인한 후 다시 시도하세요. |
| 로그인이 오류로 끝나거나 시간 초과됨 | 10분 제한 시간이 지났거나 코드가 잘못됨 | **Login**을(를) 다시 클릭하고 더 빠르게 완료하세요. |
| AI Chat에서 Claude 소스가 누락됨 | **I understand** 스위치가 꺼져 있거나 CLI가 로그인되지 않음 | 벤더 페이지를 읽은 후 스위치를 켜고 로그인하세요. |
| Gemini에서 "Sign in with Google"이 누락됨 | 저장된 Google OAuth 클라이언트가 아직 없음 | 자체 Google Cloud 프로젝트에서 클라이언트를 생성하고 카드의 **Set up Google sign-in (optional)** 아래에 저장하거나, 대신 API 키를 붙여넣으십시오. |
| "Sign in with OpenRouter" 실행 시 오류 발생 | 취소했거나 팝업이 차단됨 | 팝업을 허용하고 다시 시도하십시오. |
| CLI 응답에 "usage limit"이 표시됨 | 요금제의 할당량이 모두 소진됨 | 잠시 기다리거나 소스를 변경하십시오. |