> ## 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`               | 自定义 hook 日志文件路径，或设为 `true` 使用默认路径（`~/.failproofai/logs/hooks.log`） |

## 遥测

| 变量                                 | 描述       |
| ---------------------------------- | -------- |
| `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`）                     |