> ## Documentation Index
> Fetch the complete documentation index at: https://exosphere-auto-translate-docs-20260623-1106.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 환경 변수

> 환경 변수로 failproofai 동작 구성하기

## 대시보드

| 변수                                            | 설명                                              |
| --------------------------------------------- | ----------------------------------------------- |
| `PORT`                                        | 대시보드 포트 (기본값: `8020`)                           |
| `CLAUDE_PROJECTS_PATH`                        | Claude Code 프로젝트 폴더 경로 재정의                      |
| `FAILPROOFAI_DISABLE_PAGES=policies,projects` | 숨길 대시보드 페이지를 쉼표로 구분하여 지정                        |
| `FAILPROOFAI_ALLOWED_DEV_ORIGINS`             | 개발 리소스 접근을 허용할 호스트/IP. `--allowed-origins`와 동일. |

## 로깅

| 변수                                        | 설명                                                                      |
| ----------------------------------------- | ----------------------------------------------------------------------- |
| `FAILPROOFAI_LOG_LEVEL=info\|warn\|error` | 서버 로그 레벨 (기본값: `warn`)                                                  |
| `FAILPROOFAI_HOOK_LOG_FILE`               | 커스텀 훅 로그 파일 경로, 또는 기본 경로(`~/.failproofai/logs/hooks.log`)를 사용하려면 `true` |

## 텔레메트리

| 변수                                 | 설명               |
| ---------------------------------- | ---------------- |
| `FAILPROOFAI_TELEMETRY_DISABLED=1` | 익명 사용 통계 수집 비활성화 |

## 인증

| 변수                     | 설명                                                                                                                                                  |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| `FAILPROOF_API_URL`    | `failproofai auth` 및 대시보드 인증 대화상자에서 사용하는 API 서버 기본 URL 재정의. 기본값은 `https://api.befailproof.ai`이며, 로컬 api-server 실행 시 `http://localhost:8080` 등으로 설정. |
| `FAILPROOFAI_AUTH_DIR` | `auth.json`이 저장되는 경로 재정의 (기본값: `~/.failproofai`). 주로 격리된 테스트 환경에서 유용.                                                                               |

## 첫 실행 프롬프트

| 변수                           | 설명                                          |
| ---------------------------- | ------------------------------------------- |
| `FAILPROOFAI_NO_FIRST_RUN=1` | 최초 `failproofai` 실행 시 정책 설치를 제안하는 프롬프트 건너뛰기 |

## LLM (정책 평가용)

| 변수                         | 설명                                               |
| -------------------------- | ------------------------------------------------ |
| `FAILPROOFAI_LLM_BASE_URL` | LLM API 엔드포인트 (기본값: `https://api.openai.com/v1`) |
| `FAILPROOFAI_LLM_API_KEY`  | LLM 기반 정책에 사용할 API 키                             |
| `FAILPROOFAI_LLM_MODEL`    | 모델 이름 (기본값: `gpt-4o-mini`)                       |