이 빠른 시작 가이드는 한 대의 머신에서 세션을 보고하도록 설정하고, 감사를 실행하며, 정책을 배포하는 과정을 안내합니다. 스킬을 사용하거나 수동 단계를 따라 Failproof AI를 설정하세요.어떤 방법을 선택하시겠어요? 에이전트가 12개의 지원 하네스 중 하나(코딩 CLI, 또는 Hermes나 OpenClaw 같은 게이트웨이)에서 실행된다면 아래 단계를 따르세요. Node.js 20.9 이상이 필요합니다. 에이전트에 하네스가 없다면 추적 및 감사를 위해 Python SDK로 계측한 후, 첫 번째 실패 검사 실행에서 다시 합류하세요. 해당 경로에서의 적용(enforcement)은 런타임에 훅이 필요합니다.
스킬 사용
수동 설정
1
Failproof AI 스킬 설치
npx skills add FailproofAI/skills
2
에이전트에게 모든 설정을 요청
Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives.
에이전트가 프로젝트를 검사하고, 관련 통합을 선택하며, 설정을 수행하고, 검증합니다. 개별 스킬 및 고급 설치 옵션은 FailproofAI 스킬 저장소를 참조하세요.
이 단 하나의 명령으로 전체 설정이 완료됩니다. 로컬 데몬을 설치하고(루트 권한 한 번 필요), 발견된 모든 에이전트 CLI에 훅을 연결하며, 이 머신을 Cloud에 연결합니다. 키를 --token이 아닌 환경 변수로 전달하면 ps에서 노출되지 않습니다(머신의 모든 사용자가 명령의 인수를 볼 수 있기 때문). 단, 셸 히스토리에는 남을 수 있으므로, read -s로 읽어 들이는 것이 그것을 방지합니다. CI에서는 마스킹된 시크릿으로 주입하고 셸 추적(set -x)을 끄세요. 추적이 켜져 있으면 키가 출력됩니다.세션 트랜스크립트는 기본적으로 전송됩니다. 트랜스크립트 내용 없이 훅 활동과 정책 결정만 보고하려면 --no-transcripts를 추가하세요.
여기서 failproofai config --connect <url>을 사용하지 마세요. 이 플래그는 이미 설정된 머신을 등록하고 바로 반환합니다. 데몬도, 훅도 설정되지 않으므로, 머신이 Cloud에는 나타나지만 실제로는 아무것도 수집하거나 적용하지 않게 됩니다.
이 머신에 이미 에이전트 기록이 있다면, 최근 7일치를 미리 보고 가져온 후 전달이 완료될 때까지 기다리세요. 새 머신이라면 이 단계를 건너뛰세요.
이전 단계에서 감지된 모든 에이전트 CLI에 이미 연결이 완료되었습니다. 필요할 때 특정 하네스에 대해 명시적으로 재실행하거나, 이후에 설치된 하네스를 추가할 때 사용하세요. 12개 모두 유효한 --cli 값입니다 — claude, codex, copilot, cursor, opencode, pi, hermes, openclaw, factory, devin, antigravity, goose.
failproofai policies --install --cli claude --scope user # 코딩 CLIfailproofai policies --install --cli hermes --scope user # Slack/Telegram 게이트웨이
실행 전에 도구 호출을 차단하는 기능은 12개 모두에서 검증됩니다. 턴 종료 게이트는 8개에서 검증됩니다 — 하네스별 매트릭스는 적용 기능을 참조하세요.
3
적용할 정책 선택
훅 연결 자체는 어떤 정책도 활성화하지 않습니다. 설정 시 정책을 의도적으로 선택하지 않습니다 — 그 결정은 여러분의 것입니다. 다음과 같이 팩을 가져오세요:
failproofai policies add FailproofAI/policies
팩은 GitHub 릴리스에서 가져와 체크섬이 검증되고, 해석된 정확한 태그에 고정됩니다. 38개의 정책이 포함되어 있으며, 매니페스트에서 무인 활성화가 안전하다고 표시된 10개가 켜집니다. 이를 통해 Failproof AI가 세션을 감사하고 에이전트를 위한 정책을 작성하기 전에 로컬 정책 결정을 확인하고 적용을 시험해볼 수 있습니다.failproofai policies show <owner>/<repo>로 가져오기 전에 팩을 먼저 읽어보고, 일부만 가져오는 방법은 정책 팩을 참조하세요.이 단계가 실행되기 전까지는 block-failproofai-commands만 적용됩니다 — 이는 에이전트가 Failproof AI를 끄지 못하도록 막는 항상 켜져 있는 가드입니다. failproofai policies로 현재 활성화된 정책을 확인할 수 있습니다.
4
동작 감사
첫 번째 실패 검사 실행을 따르세요. “에이전트가 접근 방식을 변경하지 않고 실패한 도구를 재시도한 세션 찾기”와 같이 구체적인 목표를 사용하세요.
5
실패 방지
정책으로 첫 번째 실패 방지를 따르세요. 관찰 모드에서 시작하여 매칭을 검사한 후, 검토된 버전을 적용하세요.
failproofai config --status를 실행하세요. 정상적인 설정은 클라우드 연결, 데몬 상태, 적용(enforcement) 일시 중지 여부를 보고합니다.
이 페이지가 도움이 되었나요?
{"docsConfig":{"theme":"palm","$schema":"https://mintlify.com/docs.json","name":"Failproof AI","description":"The reliability layer for autonomous agents: trace every run, find where agents fail, and stop it with policies enforced in realtime.","colors":{"primary":"#c92251","light":"#e4587d","dark":"#e4587d"},"logo":{"light":"https://mintcdn.com/exosphere/63Tp--IVddVBndpp/logo/Failproof_AI_logo_light.png?fit=max\u0026auto=format\u0026n=63Tp--IVddVBndpp\u0026q=85\u0026s=5231ac600a18d7ad299834e4a880f6e0","dark":"https://mintcdn.com/exosphere/63Tp--IVddVBndpp/logo/Failproof_AI_logo.png?fit=max\u0026auto=format\u0026n=63Tp--IVddVBndpp\u0026q=85\u0026s=3f0e8fc7951c3550b7fdeabbca03daff","href":"https://befailproof.ai"},"favicon":"https://mintcdn.com/exosphere/63Tp--IVddVBndpp/favicon.ico?fit=max\u0026auto=format\u0026n=63Tp--IVddVBndpp\u0026q=85\u0026s=ef7e5e9c419deaf5a2298f5ef6d5929f","api":{"openapi":"reference/openapi.json","playground":{"display":"simple"},"examples":{"languages":["curl","python","javascript"]}},"navbar":{"links":[{"icon":"discord","href":"https://discord.befailproof.ai","label":""},{"icon":"reddit","href":"https://www.reddit.com/r/failproofai/","label":""},{"icon":"x-twitter","href":"https://x.com/failproofai","label":""},{"icon":"github","href":"https://github.com/FailproofAI/failproofai","label":"⭐ 1.5k"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.befailproof.ai"}},"footer":{"socials":{"github":"https://github.com/FailproofAI/failproofai","x":"https://x.com/failproofai"}},"search":{"prompt":"Search Failproof AI docs"},"seo":{"indexing":"navigable"},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","assistant","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"global":{"anchors":[{"anchor":"Support","icon":"mail","href":"mailto:support@befailproof.ai"}]},"languages":[{"language":"en","href":""},{"language":"zh","href":"zh"},{"language":"ja","href":"ja"},{"language":"ko","href":"ko"},{"language":"es","href":"es"},{"language":"pt-BR","href":"pt-br"},{"language":"de","href":"de"},{"language":"fr","href":"fr"},{"language":"ru","href":"ru"},{"language":"hi","href":"hi"},{"language":"tr","href":"tr"},{"language":"vi","href":"vi"},{"language":"it","href":"it"},{"language":"ar","href":"ar"},{"language":"he","href":"he"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"exosphere","hasAudioNarration":false,"actualSubdomain":"exosphere","customDomains":["docs.befailproof.ai"],"gitSource":{"type":"github","owner":"failproofai","repo":"failproofai","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{},"buildId":"6afdb4dca93dec3133f828e2","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"en","tag":"Integrations and reference","count":130},{"language":"en","tag":"HTTP API","count":109},{"language":"en","tag":"Trace","count":18},{"language":"en","tag":"Audits","count":18},{"language":"en","tag":"Analyse","count":17},{"language":"ar","tag":"Trace","count":17},{"language":"de","tag":"Trace","count":17},{"language":"es","tag":"Trace","count":17},{"language":"fr","tag":"Trace","count":17},{"language":"he","tag":"Trace","count":17},{"language":"hi","tag":"Trace","count":17},{"language":"it","tag":"Trace","count":17},{"language":"ja","tag":"Trace","count":17},{"language":"ko","tag":"Trace","count":17},{"language":"pt-BR","tag":"Trace","count":17},{"language":"ru","tag":"Trace","count":17},{"language":"tr","tag":"Trace","count":17},{"language":"vi","tag":"Trace","count":17},{"language":"zh","tag":"Trace","count":17},{"language":"en","tag":"Issues","count":15},{"language":"en","tag":"Events","count":14},{"language":"ar","tag":"Analyse","count":14},{"language":"de","tag":"Analyse","count":14},{"language":"es","tag":"Analyse","count":14},{"language":"fr","tag":"Analyse","count":14},{"language":"he","tag":"Analyse","count":14},{"language":"hi","tag":"Analyse","count":14},{"language":"it","tag":"Analyse","count":14},{"language":"ja","tag":"Analyse","count":14},{"language":"ko","tag":"Analyse","count":14},{"language":"pt-BR","tag":"Analyse","count":14},{"language":"ru","tag":"Analyse","count":14},{"language":"tr","tag":"Analyse","count":14},{"language":"vi","tag":"Analyse","count":14},{"language":"zh","tag":"Analyse","count":14},{"language":"en","tag":"Settings","count":13},{"language":"en","tag":"Start","count":13},{"language":"en","tag":"Start here","count":13},{"language":"ar","tag":"Integrations and reference","count":13},{"language":"de","tag":"Integrations and reference","count":13},{"language":"es","tag":"Integrations and reference","count":13},{"language":"fr","tag":"Integrations and reference","count":13},{"language":"he","tag":"Integrations and reference","count":13},{"language":"hi","tag":"Integrations and reference","count":13},{"language":"it","tag":"Integrations and reference","count":13},{"language":"ja","tag":"Integrations and reference","count":13},{"language":"ko","tag":"Integrations and reference","count":13},{"language":"pt-BR","tag":"Integrations and reference","count":13},{"language":"ru","tag":"Integrations and reference","count":13},{"language":"tr","tag":"Integrations and reference","count":13},{"language":"vi","tag":"Integrations and reference","count":13},{"language":"zh","tag":"Integrations and reference","count":13},{"language":"ar","tag":"Start","count":12},{"language":"ar","tag":"Start here","count":12},{"language":"de","tag":"Start","count":12},{"language":"de","tag":"Start here","count":12},{"language":"es","tag":"Start","count":12},{"language":"es","tag":"Start here","count":12},{"language":"fr","tag":"Start","count":12},{"language":"fr","tag":"Start here","count":12},{"language":"he","tag":"Start","count":12},{"language":"he","tag":"Start here","count":12},{"language":"hi","tag":"Start","count":12},{"language":"hi","tag":"Start here","count":12},{"language":"it","tag":"Start","count":12},{"language":"it","tag":"Start here","count":12},{"language":"ja","tag":"Start","count":12},{"language":"ja","tag":"Start here","count":12},{"language":"ko","tag":"Start","count":12},{"language":"ko","tag":"Start here","count":12},{"language":"pt-BR","tag":"Start","count":12},{"language":"pt-BR","tag":"Start here","count":12},{"language":"ru","tag":"Start","count":12},{"language":"ru","tag":"Start here","count":12},{"language":"tr","tag":"Start","count":12},{"language":"tr","tag":"Start here","count":12},{"language":"vi","tag":"Start","count":12},{"language":"vi","tag":"Start here","count":12},{"language":"zh","tag":"Start","count":12},{"language":"zh","tag":"Start here","count":12},{"language":"ar","tag":"Understand every run","count":11},{"language":"de","tag":"Understand every run","count":11},{"language":"es","tag":"Understand every run","count":11},{"language":"fr","tag":"Understand every run","count":11},{"language":"he","tag":"Understand every run","count":11},{"language":"hi","tag":"Understand every run","count":11},{"language":"it","tag":"Understand every run","count":11},{"language":"ja","tag":"Understand every run","count":11},{"language":"ko","tag":"Understand every run","count":11},{"language":"pt-BR","tag":"Understand every run","count":11},{"language":"ru","tag":"Understand every run","count":11},{"language":"tr","tag":"Understand every run","count":11},{"language":"vi","tag":"Understand every run","count":11},{"language":"zh","tag":"Understand every run","count":11},{"language":"ar","tag":"Find and manage failures","count":9},{"language":"de","tag":"Find and manage failures","count":9},{"language":"es","tag":"Find and manage failures","count":9},{"language":"fr","tag":"Find and manage failures","count":9},{"language":"he","tag":"Find and manage failures","count":9},{"language":"hi","tag":"Find and manage failures","count":9},{"language":"it","tag":"Find and manage failures","count":9},{"language":"ja","tag":"Find and manage failures","count":9},{"language":"ko","tag":"Find and manage failures","count":9},{"language":"pt-BR","tag":"Find and manage failures","count":9},{"language":"ru","tag":"Find and manage failures","count":9},{"language":"tr","tag":"Find and manage failures","count":9},{"language":"vi","tag":"Find and manage failures","count":9},{"language":"zh","tag":"Find and manage failures","count":9},{"language":"ar","tag":"Fix","count":8},{"language":"de","tag":"Fix","count":8},{"language":"es","tag":"Fix","count":8},{"language":"fr","tag":"Fix","count":8},{"language":"he","tag":"Fix","count":8},{"language":"hi","tag":"Fix","count":8},{"language":"it","tag":"Fix","count":8},{"language":"ja","tag":"Fix","count":8},{"language":"ko","tag":"Fix","count":8},{"language":"pt-BR","tag":"Fix","count":8},{"language":"ru","tag":"Fix","count":8},{"language":"tr","tag":"Fix","count":8},{"language":"vi","tag":"Fix","count":8},{"language":"zh","tag":"Fix","count":8},{"language":"ar","tag":"Reference","count":7},{"language":"de","tag":"Reference","count":7},{"language":"es","tag":"Reference","count":7},{"language":"fr","tag":"Reference","count":7},{"language":"he","tag":"Reference","count":7},{"language":"hi","tag":"Reference","count":7},{"language":"it","tag":"Reference","count":7},{"language":"ja","tag":"Reference","count":7},{"language":"ko","tag":"Reference","count":7},{"language":"pt-BR","tag":"Reference","count":7},{"language":"ru","tag":"Reference","count":7},{"language":"tr","tag":"Reference","count":7},{"language":"vi","tag":"Reference","count":7},{"language":"zh","tag":"Reference","count":7},{"language":"ar","tag":"Connect your agents","count":6},{"language":"de","tag":"Connect your agents","count":6},{"language":"es","tag":"Connect your agents","count":6},{"language":"fr","tag":"Connect your agents","count":6},{"language":"he","tag":"Connect your agents","count":6},{"language":"hi","tag":"Connect your agents","count":6},{"language":"it","tag":"Connect your agents","count":6},{"language":"ja","tag":"Connect your agents","count":6},{"language":"ko","tag":"Connect your agents","count":6},{"language":"pt-BR","tag":"Connect your agents","count":6},{"language":"ru","tag":"Connect your agents","count":6},{"language":"tr","tag":"Connect your agents","count":6},{"language":"vi","tag":"Connect your agents","count":6},{"language":"zh","tag":"Connect your agents","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":":root{--fpai-pink: #c92251}.dark{--fpai-pink: #e4587d}h1,h2,h3{letter-spacing:-0.025em}#content blockquote{position:relative;margin:1.5rem 0;padding:1.25rem 1.5rem 1.25rem 3.75rem!important;border-left:4px solid var(--fpai-pink)!important;border-radius:0 14px 14px 0;background:#f3f4f6!important;color:inherit!important}#content blockquote::before{content:\"“\";position:absolute;top:0.35rem;left:1rem;color:var(--fpai-pink);font-size:3rem;font-weight:700;line-height:1}#content blockquote p:first-child{margin-top:0}#content blockquote p:last-child{margin-bottom:0}.dark #content blockquote{background:rgba(148, 163, 184, 0.12)!important}.navbar-link a[href=\"https://discord.befailproof.ai\"],.navbar-link a[href=\"https://www.reddit.com/r/failproofai/\"],.navbar-link a[href=\"https://x.com/failproofai\"],.navbar-link a[href=\"https://github.com/FailproofAI/failproofai\"],#topbar-cta-button a[href=\"https://app.befailproof.ai\"]{position:relative}.navbar-link a[href=\"https://discord.befailproof.ai\"]::after,.navbar-link a[href=\"https://www.reddit.com/r/failproofai/\"]::after,.navbar-link a[href=\"https://x.com/failproofai\"]::after,.navbar-link a[href=\"https://github.com/FailproofAI/failproofai\"]::after,#topbar-cta-button a[href=\"https://app.befailproof.ai\"]::after{position:absolute;top:calc(100% + 0.5rem);left:50%;z-index:50;padding:0.35rem 0.55rem;border-radius:0.4rem;background:#111827;color:#fff;font-size:0.75rem;font-weight:500;line-height:1;opacity:0;pointer-events:none;transform:translate(-50%, -0.2rem);transition:opacity 120ms ease, transform 120ms ease}.navbar-link a[href=\"https://discord.befailproof.ai\"]::after{content:\"Join the community\"}.navbar-link a[href=\"https://www.reddit.com/r/failproofai/\"]::after{content:\"Join r/failproofai\"}.navbar-link a[href=\"https://x.com/failproofai\"]::after{content:\"Follow launches\"}.navbar-link a[href=\"https://github.com/FailproofAI/failproofai\"]::after{content:\"Star us!\"}#topbar-cta-button a[href=\"https://app.befailproof.ai\"]::after{content:\"Go to Failproof\"}.navbar-link a[href=\"https://discord.befailproof.ai\"]:hover::after,.navbar-link a[href=\"https://discord.befailproof.ai\"]:focus-visible::after,.navbar-link a[href=\"https://www.reddit.com/r/failproofai/\"]:hover::after,.navbar-link a[href=\"https://www.reddit.com/r/failproofai/\"]:focus-visible::after,.navbar-link a[href=\"https://x.com/failproofai\"]:hover::after,.navbar-link a[href=\"https://x.com/failproofai\"]:focus-visible::after,.navbar-link a[href=\"https://github.com/FailproofAI/failproofai\"]:hover::after,.navbar-link a[href=\"https://github.com/FailproofAI/failproofai\"]:focus-visible::after,#topbar-cta-button a[href=\"https://app.befailproof.ai\"]:hover::after,#topbar-cta-button a[href=\"https://app.befailproof.ai\"]:focus-visible::after{opacity:1;transform:translate(-50%, 0)}img[src^=\"/images/frameworks/\"]{opacity:0.78}.dark img[src^=\"/images/frameworks/\"]{filter:invert(1);opacity:0.7}"}]}
{"page":{"pagePath":"ko/start/quickstart","slug":"/ko/start/quickstart","pageMetadata":{"title":"빠른 시작","description":"에이전트 세션을 캡처하고, 실패를 찾고, 이를 방지하기 시작하세요.","icon":"zap","href":"/ko/start/quickstart"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"에이전트 세션을 캡처하고, 실패를 찾고, 이를 방지하기 시작하세요.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{Check,CodeBlock,Heading,Step,Steps,Tab,Tabs,Warning}=_components;if(!Check)_missingMdxReference(`Check`,true);if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Tab)_missingMdxReference(`Tab`,true);if(!Tabs)_missingMdxReference(`Tabs`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`이 빠른 시작 가이드는 한 대의 머신에서 세션을 보고하도록 설정하고, 감사를 실행하며, 정책을 배포하는 과정을 안내합니다. 스킬을 사용하거나 수동 단계를 따라 Failproof AI를 설정하세요.`}),`\n`,_jsxs(_components.p,{children:[_jsx(_components.strong,{children:`어떤 방법을 선택하시겠어요?`}),` 에이전트가 12개의 지원 `,_jsx(_components.a,{href:`/ko/reference/harnesses`,children:`하네스`}),` 중 하나(코딩 CLI, 또는 Hermes나 OpenClaw 같은 게이트웨이)에서 실행된다면 아래 단계를 따르세요. Node.js 20.9 이상이 필요합니다. 에이전트에 하네스가 없다면 추적 및 감사를 위해 `,_jsx(_components.a,{href:`/ko/reference/custom-agents`,children:`Python SDK`}),`로 계측한 후, `,_jsx(_components.a,{href:`/ko/start/first-audit`,children:`첫 번째 실패 검사 실행`}),`에서 다시 합류하세요. 해당 경로에서의 적용(enforcement)은 런타임에 훅이 필요합니다.`]}),`\n`,_jsxs(Tabs,{children:[_jsx(Tab,{title:`스킬 사용`,id:`%EC%8A%A4%ED%82%AC-%EC%82%AC%EC%9A%A9`,children:_jsxs(Steps,{children:[_jsx(Step,{title:`Failproof AI 스킬 설치`,children:_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`npx`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` skills`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` add`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` FailproofAI/skills`})]}),`\n`]})})})}),_jsxs(Step,{title:`에이전트에게 모든 설정을 요청`,children:[_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`Set up Failproof AI for this project, connect this machine, install the right hooks and policies, and verify that a session arrives.`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),_jsxs(_components.p,{children:[`에이전트가 프로젝트를 검사하고, 관련 통합을 선택하며, 설정을 수행하고, 검증합니다. 개별 스킬 및 고급 설치 옵션은 `,_jsx(_components.a,{href:`https://github.com/FailproofAI/skills`,children:`FailproofAI 스킬 저장소`}),`를 참조하세요.`]})]})]})}),_jsxs(Tab,{title:`수동 설정`,id:`%EC%88%98%EB%8F%99-%EC%84%A4%EC%A0%95`,\"data-child-heading-ids\":`[\"%EC%8B%9C%EC%9E%91-%EC%A0%84-%EC%A4%80%EB%B9%84\",\"%EC%84%A4%EC%B9%98\"]`,children:[_jsx(Heading,{level:`2`,id:`시작-전-준비`,children:`시작 전 준비`}),_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.a,{href:`https://app.befailproof.ai`,children:`Failproof AI 대시보드`}),`를 열고 계정을 생성하거나 업무용 이메일로 로그인하세요.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`관리 → 키`}),`로 이동하여 `,_jsx(_components.code,{children:`events:add`}),`와 `,_jsx(_components.code,{children:`policies:pull`}),` 권한을 가진 키를 생성하세요.`]}),`\n`,_jsxs(_components.li,{children:[`일회성 시크릿을 복사한 후, 대상 머신의 셸로 읽어 들이세요. `,_jsx(_components.code,{children:`read -s`}),`는 에코되지 않는 프롬프트에서 입력을 받으므로 명령어에 노출되지 않습니다:`]}),`\n`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`read`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -rs`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` FAILPROOFAI_KEY`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` \u0026\u0026 `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#569CD6`},children:`export`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:` FAILPROOFAI_KEY`})]}),`\n`]})})}),_jsx(Heading,{level:`2`,id:`설치`,children:`설치`}),_jsxs(Steps,{children:[_jsxs(Step,{title:`Failproof AI 설치 및 연결`,children:[_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`npm`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` install`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -g`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` failproofai`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`FAILPROOFAI_CLOUD_TOKEN`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#9CDCFE`},children:`$FAILPROOFAI_KEY`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` failproofai`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` config`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`이 단 하나의 명령으로 전체 설정이 완료됩니다. 로컬 데몬을 설치하고(루트 권한 한 번 필요), 발견된 모든 에이전트 CLI에 훅을 연결하며, 이 머신을 Cloud에 연결합니다. 키를 `,_jsx(_components.code,{children:`--token`}),`이 아닌 환경 변수로 전달하면 `,_jsx(_components.code,{children:`ps`}),`에서 노출되지 않습니다(머신의 모든 사용자가 명령의 인수를 볼 수 있기 때문). 단, 셸 히스토리에는 남을 수 있으므로, `,_jsx(_components.code,{children:`read -s`}),`로 읽어 들이는 것이 그것을 방지합니다. CI에서는 마스킹된 시크릿으로 주입하고 셸 추적(`,_jsx(_components.code,{children:`set -x`}),`)을 끄세요. 추적이 켜져 있으면 키가 출력됩니다.`]}),_jsxs(_components.p,{children:[`세션 트랜스크립트는 기본적으로 전송됩니다. 트랜스크립트 내용 없이 훅 활동과 정책 결정만 보고하려면 `,_jsx(_components.code,{children:`--no-transcripts`}),`를 추가하세요.`]}),_jsx(Warning,{children:_jsxs(_components.p,{children:[`여기서 `,_jsx(_components.code,{children:`failproofai config --connect \u003curl>`}),`을 사용하지 마세요. 이 플래그는 `,_jsx(_components.strong,{children:`이미`}),` 설정된 머신을 등록하고 바로 반환합니다. 데몬도, 훅도 설정되지 않으므로, 머신이 Cloud에는 나타나지만 실제로는 아무것도 수집하거나 적용하지 않게 됩니다.`]})}),_jsx(_components.p,{children:`이 머신에 이미 에이전트 기록이 있다면, 최근 7일치를 미리 보고 가져온 후 전달이 완료될 때까지 기다리세요. 새 머신이라면 이 단계를 건너뛰세요.`}),_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`failproofai`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` backfill`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --since`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 7d`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --dry-run`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`failproofai`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` backfill`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --since`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 7d`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`failproofai`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` flush`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --wait`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`Failproof AI에서 `,_jsx(_components.strong,{children:`세션`}),`을 열고 가져온 세션을 선택하세요.`]})]}),_jsxs(Step,{title:`하네스에 Failproof AI 연결`,children:[_jsxs(_components.p,{children:[`이전 단계에서 감지된 모든 에이전트 CLI에 이미 연결이 완료되었습니다. 필요할 때 특정 하네스에 대해 명시적으로 재실행하거나, 이후에 설치된 하네스를 추가할 때 사용하세요. 12개 모두 유효한 `,_jsx(_components.code,{children:`--cli`}),` 값입니다 — `,_jsx(_components.code,{children:`claude`}),`, `,_jsx(_components.code,{children:`codex`}),`, `,_jsx(_components.code,{children:`copilot`}),`, `,_jsx(_components.code,{children:`cursor`}),`, `,_jsx(_components.code,{children:`opencode`}),`, `,_jsx(_components.code,{children:`pi`}),`, `,_jsx(_components.code,{children:`hermes`}),`, `,_jsx(_components.code,{children:`openclaw`}),`, `,_jsx(_components.code,{children:`factory`}),`, `,_jsx(_components.code,{children:`devin`}),`, `,_jsx(_components.code,{children:`antigravity`}),`, `,_jsx(_components.code,{children:`goose`}),`.`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`failproofai`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` policies`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --install`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --cli`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` claude`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --scope`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` user`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # 코딩 CLI`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`failproofai`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` policies`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --install`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --cli`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` hermes`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --scope`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` user`}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:` # Slack/Telegram 게이트웨이`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`실행 전에 도구 호출을 차단하는 기능은 12개 모두에서 검증됩니다. 턴 종료 게이트는 8개에서 검증됩니다 — 하네스별 매트릭스는 `,_jsx(_components.a,{href:`/ko/reference/harnesses#%EC%A0%81%EC%9A%A9-%EA%B0%80%EB%8A%A5-%EB%B2%94%EC%9C%84`,children:`적용 기능`}),`을 참조하세요.`]})]}),_jsxs(Step,{title:`적용할 정책 선택`,children:[_jsx(_components.p,{children:`훅 연결 자체는 어떤 정책도 활성화하지 않습니다. 설정 시 정책을 의도적으로 선택하지 않습니다 — 그 결정은 여러분의 것입니다. 다음과 같이 팩을 가져오세요:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`failproofai`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` policies`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` add`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` FailproofAI/policies`})]}),`\n`]})})}),_jsx(_components.p,{children:`팩은 GitHub 릴리스에서 가져와 체크섬이 검증되고, 해석된 정확한 태그에 고정됩니다. 38개의 정책이 포함되어 있으며, 매니페스트에서 무인 활성화가 안전하다고 표시된 10개가 켜집니다. 이를 통해 Failproof AI가 세션을 감사하고 에이전트를 위한 정책을 작성하기 전에 로컬 정책 결정을 확인하고 적용을 시험해볼 수 있습니다.`}),_jsxs(_components.p,{children:[_jsx(_components.code,{children:`failproofai policies show \u003cowner>/\u003crepo>`}),`로 가져오기 전에 팩을 먼저 읽어보고, 일부만 가져오는 방법은 `,_jsx(_components.a,{href:`/ko/policies/packs`,children:`정책 팩`}),`을 참조하세요.`]}),_jsxs(_components.p,{children:[`이 단계가 실행되기 전까지는 `,_jsx(_components.code,{children:`block-failproofai-commands`}),`만 적용됩니다 — 이는 에이전트가 Failproof AI를 끄지 못하도록 막는 항상 켜져 있는 가드입니다. `,_jsx(_components.code,{children:`failproofai policies`}),`로 현재 활성화된 정책을 확인할 수 있습니다.`]})]}),_jsx(Step,{title:`동작 감사`,children:_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/ko/start/first-audit`,children:`첫 번째 실패 검사 실행`}),`을 따르세요. “에이전트가 접근 방식을 변경하지 않고 실패한 도구를 재시도한 세션 찾기”와 같이 구체적인 목표를 사용하세요.`]})}),_jsx(Step,{title:`실패 방지`,children:_jsxs(_components.p,{children:[_jsx(_components.a,{href:`/ko/start/first-policy`,children:`정책으로 첫 번째 실패 방지`}),`를 따르세요. 관찰 모드에서 시작하여 매칭을 검사한 후, 검토된 버전을 적용하세요.`]})})]}),_jsx(Check,{children:_jsxs(_components.p,{children:[_jsx(_components.code,{children:`failproofai config --status`}),`를 실행하세요. 정상적인 설정은 클라우드 연결, 데몬 상태, 적용(enforcement) 일시 중지 여부를 보고합니다.`]})})]})]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"빠른 시작","description":"에이전트 세션을 캡처하고, 실패를 찾고, 이를 방지하기 시작하세요.","icon":"zap","href":"/ko/start/quickstart"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"시작 전 준비","slug":"시작-전-준비","depth":2,"children":[],"tabId":"%EC%88%98%EB%8F%99-%EC%84%A4%EC%A0%95"},{"title":"설치","slug":"설치","depth":2,"children":[],"tabId":"%EC%88%98%EB%8F%99-%EC%84%A4%EC%A0%95"}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/exosphere/86fd84cc0563b6f3/stars.js","/_mintlify/custom/exosphere/3e9809a158d7fc0b/reo.js"],"subdomain":"exosphere","siteName":"Failproof AI","title":"빠른 시작 - Failproof AI","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/start/quickstart","matchLevel":1},"zh":{"href":"/zh/start/quickstart","matchLevel":1},"ja":{"href":"/ja/start/quickstart","matchLevel":1},"ko":{"href":"/ko/start/quickstart","matchLevel":0},"es":{"href":"/es/start/quickstart","matchLevel":1},"pt-BR":{"href":"/pt-br/start/quickstart","matchLevel":1},"de":{"href":"/de/start/quickstart","matchLevel":1},"fr":{"href":"/fr/start/quickstart","matchLevel":1},"ru":{"href":"/ru/start/quickstart","matchLevel":1},"hi":{"href":"/hi/start/quickstart","matchLevel":1},"tr":{"href":"/tr/start/quickstart","matchLevel":1},"vi":{"href":"/vi/start/quickstart","matchLevel":1},"it":{"href":"/it/start/quickstart","matchLevel":1},"ar":{"href":"/ar/start/quickstart","matchLevel":1},"he":{"href":"/he/start/quickstart","matchLevel":1}}},"lastModified":"2026-09-15T05:52:36.412Z","originalFileLocation":"ko/start/quickstart.mdx","locale":"ko"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"에이전트 세션을 캡처하고, 실패를 찾고, 이를 방지하기 시작하세요.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Failproof AI\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"빠른 시작 - Failproof AI\">\u003cmeta data-mint-head property=\"og:description\" content=\"에이전트 세션을 캡처하고, 실패를 찾고, 이를 방지하기 시작하세요.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Failproof AI\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.befailproof.ai/ko/start/quickstart\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://exosphere.mintlify.site/_mintlify/api/og/v2?division=Start+here\u0026amp;title=%EB%B9%A0%EB%A5%B8+%EC%8B%9C%EC%9E%91\u0026amp;description=%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8+%EC%84%B8%EC%85%98%EC%9D%84+%EC%BA%A1%EC%B2%98%ED%95%98%EA%B3%A0%2C+%EC%8B%A4%ED%8C%A8%EB%A5%BC+%EC%B0%BE%EA%B3%A0%2C+%EC%9D%B4%EB%A5%BC+%EB%B0%A9%EC%A7%80%ED%95%98%EA%B8%B0+%EC%8B%9C%EC%9E%91%ED%95%98%EC%84%B8%EC%9A%94.\u0026amp;theme=cebdc1f0592da2cd408854e5\u0026amp;signature=1aa31ddc959191f4ef9e7dba67b92e3a6185ec099e95d0e2458917a52d26d183\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"빠른 시작 - Failproof AI\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"에이전트 세션을 캡처하고, 실패를 찾고, 이를 방지하기 시작하세요.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://exosphere.mintlify.site/_mintlify/api/og/v2?division=Start+here\u0026amp;title=%EB%B9%A0%EB%A5%B8+%EC%8B%9C%EC%9E%91\u0026amp;description=%EC%97%90%EC%9D%B4%EC%A0%84%ED%8A%B8+%EC%84%B8%EC%85%98%EC%9D%84+%EC%BA%A1%EC%B2%98%ED%95%98%EA%B3%A0%2C+%EC%8B%A4%ED%8C%A8%EB%A5%BC+%EC%B0%BE%EA%B3%A0%2C+%EC%9D%B4%EB%A5%BC+%EB%B0%A9%EC%A7%80%ED%95%98%EA%B8%B0+%EC%8B%9C%EC%9E%91%ED%95%98%EC%84%B8%EC%9A%94.\u0026amp;theme=cebdc1f0592da2cd408854e5\u0026amp;signature=1aa31ddc959191f4ef9e7dba67b92e3a6185ec099e95d0e2458917a52d26d183\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/exosphere/jZWjNNy57lpILUrG/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Failproof AI\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#c92251\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.befailproof.ai/ko/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/ko/start/quickstart.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ko\" href=\"https://docs.befailproof.ai/ko/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.befailproof.ai/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"zh\" href=\"https://docs.befailproof.ai/zh/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ja\" href=\"https://docs.befailproof.ai/ja/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"es\" href=\"https://docs.befailproof.ai/es/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"pt-BR\" href=\"https://docs.befailproof.ai/pt-br/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"de\" href=\"https://docs.befailproof.ai/de/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.befailproof.ai/fr/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ru\" href=\"https://docs.befailproof.ai/ru/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"hi\" href=\"https://docs.befailproof.ai/hi/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"tr\" href=\"https://docs.befailproof.ai/tr/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"vi\" href=\"https://docs.befailproof.ai/vi/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"it\" href=\"https://docs.befailproof.ai/it/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"ar\" href=\"https://docs.befailproof.ai/ar/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"he\" href=\"https://docs.befailproof.ai/he/start/quickstart\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.befailproof.ai/start/quickstart\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.befailproof.ai/#organization\",\"name\":\"Failproof AI\",\"url\":\"https://docs.befailproof.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/exosphere/63Tp--IVddVBndpp/logo/Failproof_AI_logo_light.png?fit=max\u0026auto=format\u0026n=63Tp--IVddVBndpp\u0026q=85\u0026s=5231ac600a18d7ad299834e4a880f6e0\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.befailproof.ai#website\",\"name\":\"Failproof AI\",\"url\":\"https://docs.befailproof.ai\",\"publisher\":{\"@id\":\"https://docs.befailproof.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.befailproof.ai/ko/start/quickstart#webpage\",\"url\":\"https://docs.befailproof.ai/ko/start/quickstart\",\"name\":\"빠른 시작\",\"description\":\"에이전트 세션을 캡처하고, 실패를 찾고, 이를 방지하기 시작하세요.\",\"dateModified\":\"2026-09-15T05:52:36.412Z\",\"isPartOf\":{\"@id\":\"https://docs.befailproof.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.befailproof.ai/ko/start/quickstart#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.befailproof.ai/ko/start/quickstart#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Start here\",\"item\":\"https://docs.befailproof.ai/ko\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"빠른 시작\",\"item\":\"https://docs.befailproof.ai/ko/start/quickstart\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.befailproof.ai/ko/start/quickstart#article\",\"headline\":\"빠른 시작\",\"name\":\"빠른 시작\",\"description\":\"에이전트 세션을 캡처하고, 실패를 찾고, 이를 방지하기 시작하세요.\",\"url\":\"https://docs.befailproof.ai/ko/start/quickstart\",\"mainEntityOfPage\":{\"@id\":\"https://docs.befailproof.ai/ko/start/quickstart#webpage\"},\"dateModified\":\"2026-09-15T05:52:36.412Z\",\"publisher\":{\"@id\":\"https://docs.befailproof.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.befailproof.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Failproof AI\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Failproof AI\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/ko/start/quickstart.md","siteName":"Failproof AI","nav":{"global":{"anchors":[{"anchor":"Support","icon":"mail","href":"mailto:support@befailproof.ai"}]},"languages":[{"language":"en","pages":[{"title":"en","href":"/start/quickstart"}]},{"language":"zh","pages":[{"title":"zh","href":"/zh/start/quickstart"}]},{"language":"ja","pages":[{"title":"ja","href":"/ja/start/quickstart"}]},{"language":"ko","tabs":[{"tab":"Start","icon":"rocket","groups":[{"group":"Start here","pages":[{"title":"에이전트를 안전하게 만드세요","description":"에이전트가 실행되는 모든 환경에 대한 가시성과 제어 — 코딩 CLI, 채팅 게이트웨이, 자체 호스팅 어시스턴트, 그리고 직접 계측한 에이전트까지.","icon":"shield-check","href":"/ko"},{"title":"빠른 시작","icon":"zap","href":"/ko/start/quickstart"},{"title":"에이전트 하네스","description":"지원되는 12개의 에이전트 하네스 전반에서 세션을 캡처하고 정책을 적용합니다.","icon":"plug-zap","href":"/ko/reference/harnesses"},{"title":"Failproof Assistant","icon":"message-square-text","href":"/ko/sessions/assistant"},{"title":"첫 번째 실패 검사 실행","icon":"scan-search","href":"/ko/start/first-audit"},{"title":"정책으로 첫 번째 실패를 방지하세요","icon":"shield-check","href":"/ko/start/first-policy"},{"title":"설정 방식 선택","icon":"waypoints","href":"/ko/start/setup"},{"title":"핵심 개념","icon":"boxes","href":"/ko/start/concepts"},{"group":"Starter templates","expanded":false,"pages":[{"title":"커스텀 에이전트","icon":"code","href":"/ko/start/quickstarts/custom-agents"},{"title":"LangChain and LangGraph","icon":"https://mintlify.s3.us-west-1.amazonaws.com/exosphere/images/frameworks/langchain.svg","href":"/ko/start/quickstarts/langchain"},{"title":"CrewAI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/exosphere/images/frameworks/crewai.svg","href":"/ko/start/quickstarts/crewai"},{"title":"LlamaIndex","icon":"https://mintlify.s3.us-west-1.amazonaws.com/exosphere/images/frameworks/llamaindex.svg","href":"/ko/start/quickstarts/llamaindex"},{"title":"Pydantic AI","icon":"https://mintlify.s3.us-west-1.amazonaws.com/exosphere/images/frameworks/pydantic-ai.svg","href":"/ko/start/quickstarts/pydantic-ai"}]}]}]},{"tab":"Trace","icon":"route","pages":[{"title":"Trace","href":"/ko/sessions/overview"}]},{"tab":"Analyse","icon":"scan-search","pages":[{"title":"Analyse","href":"/ko/evaluations/overview"}]},{"tab":"Fix","icon":"shield-check","pages":[{"title":"Fix","href":"/ko/policies/overview"}]},{"tab":"Settings","icon":"settings-2","pages":[{"title":"Settings","href":"/ko/admin/overview"}]},{"tab":"Integrations and reference","icon":"braces","pages":[{"title":"Integrations and reference","href":"/ko/reference/overview"}]}]},{"language":"es","pages":[{"title":"es","href":"/es/start/quickstart"}]},{"language":"pt-BR","pages":[{"title":"pt-BR","href":"/pt-br/start/quickstart"}]},{"language":"de","pages":[{"title":"de","href":"/de/start/quickstart"}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/start/quickstart"}]},{"language":"ru","pages":[{"title":"ru","href":"/ru/start/quickstart"}]},{"language":"hi","pages":[{"title":"hi","href":"/hi/start/quickstart"}]},{"language":"tr","pages":[{"title":"tr","href":"/tr/start/quickstart"}]},{"language":"vi","pages":[{"title":"vi","href":"/vi/start/quickstart"}]},{"language":"it","pages":[{"title":"it","href":"/it/start/quickstart"}]},{"language":"ar","pages":[{"title":"ar","href":"/ar/start/quickstart"}]},{"language":"he","pages":[{"title":"he","href":"/he/start/quickstart"}]}]},"basePath":"","title":"빠른 시작 - Failproof AI","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":[],"chunks":[]}