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

# 코드 실행

> 채팅 내 코드 실행 환경 및 코드 인터프리터를 구성합니다.

<Info>관리자 › 설정 › 코드 실행</Info>

AI 생성 코드의 실행 환경을 구성합니다.

* 이 페이지에서는 **코드 실행 엔진**(활성화 + Pyodide/Jupyter)을 설정하며, 이 엔진은 사용자 수동 실행과 에이전트의 **코드 인터프리터**(자동 실행)가 함께 사용합니다.

<Frame caption="코드 실행 엔진(Pyodide/Jupyter)을 설정합니다 — 사용자 수동 실행과 에이전트 코드 인터프리터가 공유">
  <img src="https://mintcdn.com/cloocus/Or1RjU_AzOVJRxuS/images/admin/settings-code-execution.png?fit=max&auto=format&n=Or1RjU_AzOVJRxuS&q=85&s=8f49913a528ddd639db66d86cb3702d0" alt="코드 실행 설정 탭" width="2880" height="1800" data-path="images/admin/settings-code-execution.png" />
</Frame>

## 코드 실행 vs 코드 인터프리터

|            | 코드 실행                         | 코드 인터프리터                                             |
| ---------- | ----------------------------- | ---------------------------------------------------- |
| **동작**     | AI가 생성한 코드 블록을 **사용자가 수동 실행** | AI가 **자동으로 코드를 생성하고 실행**                             |
| **트리거**    | 코드 블록의 "실행" 버튼 클릭             | AI가 데이터 분석이 필요하다고 판단 시                               |
| **활성화 조건** | 이 설정만 켜면 됨                    | 이 설정 + 에이전트 기능(capability) + 사용자 채팅 토글 **3가지 모두 필요** |

***

## 코드 실행 (Code Execution)

채팅에서 AI가 생성한 코드 블록을 사용자가 직접 실행할 수 있는 기능입니다.

| 설정 항목         | 설명              | 기본값       |
| ------------- | --------------- | --------- |
| **코드 실행 활성화** | 코드 실행 기능 ON/OFF | 활성화       |
| **실행 엔진**     | 코드 실행 환경 선택     | `pyodide` |

### 실행 엔진

<Tabs>
  <Tab title="Pyodide">
    브라우저 내에서 Python을 실행합니다. WebAssembly 기반으로 서버에 영향을 주지 않습니다.

    | 장점        | 제약              |
    | --------- | --------------- |
    | 별도 서버 불필요 | 일부 네이티브 패키지 미지원 |
    | 보안 위험 없음  | 대용량 데이터 처리 제한   |
    | 즉시 사용 가능  | 파일 시스템 접근 불가    |
  </Tab>

  <Tab title="Jupyter">
    Jupyter 서버에서 코드를 실행합니다. 서버 환경의 모든 패키지를 사용할 수 있습니다.

    | 설정 항목          | 설명                         |
    | -------------- | -------------------------- |
    | **서버 URL**     | Jupyter 서버 주소              |
    | **인증 방식**      | None, Token, Password 중 선택 |
    | **인증 토큰/비밀번호** | 인증 정보                      |
    | **타임아웃**       | 실행 제한 시간 (초)               |

    <Warning>
      Jupyter 실행은 서버에서 임의의 코드를 실행하므로 심각한 보안 위험이 있습니다. 신뢰할 수 있는 환경에서만 사용하세요.
    </Warning>
  </Tab>
</Tabs>

***

## 코드 인터프리터 (Code Interpreter)

에이전트가 자동으로 코드를 생성·실행하여 데이터 분석, 차트 생성 등을 수행하는 기능입니다.

* **이 탭에 별도 설정 항목이 있는 것이 아니라**, 위에서 구성한 코드 실행 엔진(Pyodide/Jupyter)을 그대로 사용합니다.
* 활성화 여부는 에이전트·그룹 권한·채팅 토글로 제어합니다.

<Warning>
  코드 인터프리터가 동작하려면 **3가지 조건**이 모두 충족되어야 합니다:

  1. 이 탭에서 **코드 실행 활성화** (엔진 설정 완료)
  2. 에이전트 설정에서 코드 인터프리터 기능을 **Default On**(기본 켜짐) 또는 **Default Off**(기본 꺼짐)로 설정
  3. 사용자가 채팅에서 코드 인터프리터를 **직접 켜기** (Default Off인 경우)

  하나라도 빠지면 코드 인터프리터가 동작하지 않습니다.
</Warning>

<Note>
  사용자별 코드 인터프리터 사용 허용은 [그룹 및 권한](/ko/admin/groups)의 **기능 권한 › 코드 인터프리터** 토글로 제어합니다.
</Note>