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

# 환경

> 앱에 주입되는 플랫폼 변수 및 형제 URL입니다.

# 환경

Kazzle은 앱 프로세스에 소수의 플랫폼 변수를 주입합니다. 자신의 자격증명은 `kazzle.config.ts`를 통해 Vault에서 가져옵니다.

## 프로세스 변수

| 변수               | 설명                         | 예시                       |
| ---------------- | -------------------------- | ------------------------ |
| `PORT`           | 프로세스가 수신 대기할 포트            | `3000`                   |
| `HOST`           | 바인딩할 호스트                   | `0.0.0.0`                |
| `KAZZLE_API_URL` | Kazzle 런타임 헬퍼가 사용하는 기본 URL | `https://api.kazzle.app` |

`PORT`, `HOST`, `KAZZLE_API_URL`은 프로세스 컴포넌트에 설정됩니다. Kazzle은 앱 프로세스에 대해 API 키를 자동으로 생성하지 않습니다. 앱이 실제로 필요할 때만 명시적 자격증명을 추가하세요.

프로세스는 `HOST:PORT`에 바인딩해야 합니다. Kazzle은 그 위에 미리보기 라우팅 및 프로덕션 도메인을 처리합니다.

## 형제 컴포넌트 URL

앱에 여러 컴포넌트가 있을 때, Kazzle은 한 컴포넌트가 다른 컴포넌트에 접근할 수 있도록 하는 URL을 주입할 수 있습니다:

| 변수                                | 설명                |
| --------------------------------- | ----------------- |
| `KAZZLE_APP_COMPONENT_{NAME}_URL` | 런타임에 형제 컴포넌트의 URL |

이름은 컴포넌트의 `name` 필드에서 가져옵니다: 대문자로 변환되고, 영숫자가 아닌 문자는 언더스코어가 됩니다. `API Server`라는 형제는 `KAZZLE_APP_COMPONENT_API_SERVER_URL`이 됩니다.

이 URL은 배포된 형제가 있을 때는 그것을 가리키고, 없으면 해당 형제 컴포넌트의 현재 개발 주소를 가리킵니다.

## 앱 자격증명

앱 자격증명은 시크릿 컬렉션 + 환경을 통해 컴포넌트에 전달됩니다. Vault에 환경 변수 키로 원하는 이름으로 시크릿을 저장하고(예: `KAZZLE_API_KEY`), 컴포넌트가 해당 컬렉션 + 환경을 가리키도록 설정하세요:

```typescript theme={"theme":"material-theme-darker"}
export default defineConfig({
  components: [
    {
      name: 'server',
      type: 'process',
      path: './server',
      env: {
        collection: 'my-app',
        environment: 'default'
      }
    }
  ]
});
```

생성된 앱에서 Kazzle의 `/ai/*` 엔드포인트를 호출할 때 `KAZZLE_API_KEY`를 사용하세요. `VITE_*`를 통해 개인 키를 노출하지 마세요. 이 값들은 브라우저 코드에 번들됩니다.