==============================================================
  FALCON — 처음 하시는 분을 위한 안내
  이 종이 한 장만 따라 하시면 됩니다.  (2026-09-26)
==============================================================

■ 0. 이것부터 아셔야 합니다
--------------------------------------------------------------
  - 영상은 «이 컴퓨터»에서 만들어집니다. 서버로 올라가지 않습니다.
  - 그래서 Python 과 ffmpeg 가 필요합니다. 아래 2번이 다 깔아 줍니다.
  - 완성된 영상은 바탕화면「FALCON 작업」폴더에 들어옵니다.

  🔴 목소리·그림 서비스 열쇠(Typecast 등)는 «본인 것»을 쓰십니다.
     서버는 갖고 있지 않고 받지도 않습니다. 무료 요금제로 시작하실 수 있습니다.
     설치할 때는 넣지 «않습니다» — 첫 영상을 만들기 직전에 Claude 가 물어봅니다.


■ 1. 받고 풀기
--------------------------------------------------------------
  아래 주소로 들어가 내려받기 단추를 누르세요.

        https://falcon-friend-guide.pages.dev/

  받은 ZIP 을 «바탕화면»에 풀어 주세요.

  🔴 ZIP 안에서 바로 실행하지 마십시오. 반드시 «풀고» 나서 실행합니다.
     안 풀고 실행하면 파일을 못 찾아 중간에 멈춥니다.


■ 2. 「1_필수설치.cmd」를 더블클릭 — 이것 하나면 됩니다
--------------------------------------------------------------
  풀어 놓은 폴더에서 「1_필수설치.cmd」를 더블클릭하세요.
  다섯 가지를 «알아서» 합니다. 몇 분 걸립니다.

        1  필수 프로그램 설치 (Python · ffmpeg · Claude Code)
        2  Claude Code 확인
        3  FALCON 서버 등록
        4  상태 재점검
        5  바탕화면 바로가기 · 권한 파일 배치

  [이때 화면에] 줄마다 결과가 붙습니다.
                🔴 중간에 «빨간 줄이 보여도 괜찮습니다». 아직 안 만든 것을
                   먼저 재기 때문이고, 뒤 단계에서 만든 뒤 다시 잽니다.
                중간에 「installer\ui\index.html 을 새로고침하세요」가 지나가도
                지금은 그냥 두셔도 됩니다 (9번에서 설명합니다).
  [끝나면]      실패 0건.
                이제 VS Code 를 엽니다...
                → 🔴 VS Code 가 «저절로» 열립니다. 3번으로 가세요.

  [「로그인이 필요합니다」가 나오면]
        검은 창에 claude 라고 한 번 치고 로그인하신 뒤,
        「1_필수설치.cmd」를 «다시» 더블클릭하세요.
        여러 번 실행하셔도 안전합니다.

  [실패가 있으면]
        화면의 -> 표시가 무엇을 하라고 알려 줍니다.
        고치신 뒤 「1_필수설치.cmd」를 다시 실행하시면 됩니다.

  ※ 「권한 파일」이 함께 놓입니다.
     이것이 없으면 영상 한 편 만드는 동안 확인 창이 «수십 번» 뜹니다.
     무엇을 허락하는지는 같은 폴더의「권한파일_읽어보세요.txt」에 다 적혀 있습니다.
     허락한 것은 여덟 가지뿐입니다 —
     py · python · python3 · python.exe · ffmpeg · ffprobe · curl · certutil · FALCON 서버.
     불안하시면 지우셔도 됩니다. 확인 창이 다시 뜰 뿐입니다.
     지우는 자리: C:\Users\<내이름>\FalconWork\.claude\settings.local.json

  🔴 1_ 을 «돌리기 전부터» Claude Code 를 열어 두셨다면, 그 창은 껐다 켜 주세요.
     Claude 는 시작할 때 권한 파일을 읽습니다.
     (1_ 이 열어 주는 새 창은 그대로 쓰시면 됩니다)


■ 3. VS Code 가 열리면 — 여기서부터 «사람 차례»입니다
--------------------------------------------------------------

  🔴 처음 열릴 때 VS Code 가 두 가지를 묻습니다. «둘 다 허용»하셔야
     Claude 가 저절로 뜹니다.

        ① 「이 폴더에 있는 파일의 작성자를 신뢰하시겠습니까?」
           → 「예, 작성자를 신뢰합니다」

        ② 「이 작업 영역에 자동으로 실행되는 작업이 있습니다」
           → 「허용 및 실행 (Allow and Run)」

     둘 다 «처음 한 번»만 묻습니다. 다음부터는 안 묻습니다.
     🔴 허용하지 않으시면 VS Code 만 열리고 Claude 가 안 뜹니다.

  🔴 Claude 가 «옛 대화»를 되살려 놓았으면 «새 대화»로 시작해 주세요.
     이어서 쓰시면 예전에 받아 둔 낡은 답을 그대로 쓰게 됩니다.

  Claude 가 뜨면 할 일은 둘입니다.

  ── 첫째. 접속 ──
     Claude 에게 이렇게 말해 주세요.

           falcon MCP 로 준비됐는지 봐줘

     «브라우저 창이 저절로 열립니다». 그 창의 「승인 링크」 칸에
     받으신 10자리 접속코드를 넣으시면 됩니다.

     🔴 접속코드는 «브라우저에만» 넣으십시오.
        검은 창이나 채팅창에 붙여넣지 «마세요».
     🔴 처음 한 번만 합니다. 다음부터는 안 묻습니다.

  ── 둘째. 실행기 받기 ──
     인증이 끝나면 Claude 에게 이렇게 말해 주세요.

           falcon_setup 으로 실행기를 받아 저장해줘

     Claude 가 받아서 저장하고, 제대로 왔는지 대조까지 합니다.

  여기까지 하시면 준비 끝입니다.


■ 4. 🔴 반드시 「falcon」이라고 말해 주세요
--------------------------------------------------------------
  Claude 에게 시키실 때 «falcon» 을 꼭 넣어 주세요.

        [O]  falcon MCP 로 명화관 영상 만들어 줘
        [X]  영상 만들어 줘                    ← 다른 데로 갑니다

  이 말이 빠지면 Claude 가 엉뚱한 곳으로 가서 아무것도 안 됩니다.


■ 5. 첫 영상 만들기
--------------------------------------------------------------
        falcon MCP 로 명화관 영상 만들어 줘

  그다음은 Claude 가 시키는 대로만 하시면 됩니다.
  중간에 소재(영상 파일이나 링크)를 달라고 합니다.

  🔴 소재는 «영상 파일»이나 «유튜브 링크»로 주십시오.
     특히 「군림보」와 「강석주」는 글(텍스트)로 시작하시면 그림을 찾지 못해
     같은 자리를 계속 돕니다. 영상이나 유튜브 링크로 시작해 주세요.

  다음에 다시 하실 때는 바탕화면의 「FALCON MCP 시작」 아이콘을 누르세요.

  🔴 만드는 도중에 「python 을 찾을 수 없다」·「ffmpeg 를 찾을 수 없다」가
     나오면, 창을 «모두 닫고» 바탕화면 아이콘으로 다시 시작해 주세요.
     방금 깐 프로그램은 «새로 연 창»에서만 인식됩니다. (10번에도 적어 두었습니다)


■ 6. 🔴 열쇠 — 첫 영상 만들기 «직전»에 한 번
--------------------------------------------------------------
  채널을 고르시면 Claude 가 «열쇠를 물어봅니다».
  그때 대화창에 붙여넣으시면 Claude 가 알아서 저장합니다.

  🔴 따로 뜨는 입력 창은 «없습니다». 대화창이 전부입니다.
  🔴 한 번만 넣으시면 다음부터는 안 묻습니다.

  ── 채널별로 필요한 열쇠 ──
  (이 표는 서버가 내려 주는 값 그대로입니다)

      인물형          없음           ← 열쇠 없이 되는 «유일한» 채널입니다
      명화관          Typecast
      웃긴버거         Typecast
      어랍숏          Typecast
      린박스          Typecast
      강석주          Typecast · 받아쓰기
      군림보          EvoLink · Typecast · 받아쓰기
      쇼핑           EvoLink · Typecast · 받아쓰기
      인물형 롱폼      EvoLink · Serper · Typecast · 네이버 이미지검색(ID·Secret) · Speechmatics

      준비 중         뇌전구 · 정치 · 3D쇼츠

  🔴 처음이시면 «인물형»이나 «명화관»으로 시작하시길 권합니다.
     인물형은 열쇠가 아예 필요 없고, 명화관은 Typecast 하나면 됩니다.

  🔴 「군림보」·「강석주」는 소재를 «영상이나 유튜브 링크»로 주셔야 합니다.
     글(텍스트)로 시작하시면 그림을 찾지 못해 같은 자리를 계속 돕니다.

  ── 열쇠 받는 곳 ──
      Typecast       https://typecast.ai  가입 → API → 키 발급
                     무료 요금제 월 3만 자 — 처음엔 돈이 안 듭니다
      받아쓰기        본인 키가 없으면 로컬 Whisper 로 대신할 수 있습니다

  🔴 열쇠는 «본인 것»입니다. 본인 계정에서 발급받아 본인 컴퓨터에만 저장됩니다.


■ 7. 완성된 영상은 어디에
--------------------------------------------------------------
      바탕화면 \ FALCON 작업 \ <채널폴더> \ <프로젝트명>

  같은 이름으로 또 만드셔도 덮어쓰지 않습니다 (_002, _003 으로 늘어납니다).


■ 8. 나머지 두 파일은 «언제» 쓰나
--------------------------------------------------------------
  평소에는 쓰실 일이 없습니다. 아래 경우에만 쓰십니다.

      2_권한설정과_바로가기.cmd
          바탕화면 아이콘이 없거나, 확인 창이 자꾸 뜰 때 다시 돌리세요.

      3_시스템점검.cmd
          「뭔가 안 되는 것 같다」 싶을 때 돌려 보세요.
          16줄이 나오고 ==== 로 끝납니다.
          🔴 «빨간 줄이 하나도 없으면» 된 것입니다.
             검은 창에 「합격」이라는 한 줄은 따로 없습니다 — 정상입니다.


■ 9. 점검 결과를 «보기 좋게» 보려면 (선택)
--------------------------------------------------------------
  꼭 하실 필요는 없습니다. 화면으로 보고 싶으실 때만 하세요.

      푼 폴더에서  installer \ ui \ index.html  을 더블클릭하면
      점검 결과가 초록/빨강으로 보입니다.

  🔴 이미 열어 두셨다면 «새로고침(F5)» 을 하셔야 새 결과가 보입니다.
     이 화면은 «열 때 한 번만» 읽습니다.
     점검을 돌려도 새로고침하지 않으시면 화면은 그대로입니다 — 고장이 아닙니다.


■ 10. 이러면 이렇게 — 막히는 자리
--------------------------------------------------------------

  [확인 창이 자꾸 뜹니다 / 「인터넷에서 받은 코드를 실행」]
      권한 파일이 아직 안 먹은 것입니다.
      → 「2_권한설정과_바로가기.cmd」를 돌리시고, Claude 를 껐다 켜 주세요.

  [바탕화면 아이콘을 눌렀더니 「FALCON MCP 등록이 필요합니다」가 뜹니다]
      2번(1_필수설치.cmd)을 아직 안 하셨거나 중간에 멈춘 것입니다.
      🔴 바탕화면 아이콘은 «등록을 하지 않습니다» — 됐는지 확인만 합니다.
      → 「1_필수설치.cmd」를 먼저 끝까지 돌려 주세요.

  [VS Code 는 열렸는데 Claude 가 안 뜹니다]
      첫 열림에 묻는 두 가지를 허용하지 않으신 것입니다.
      → VS Code 를 닫고 바탕화면의 「FALCON MCP 시작」을 다시 누르신 뒤
        「신뢰합니다」와 「허용 및 실행」을 모두 눌러 주세요.

  [접속코드를 넣었는데 아무 일도 안 일어납니다]
      설치 안내 화면에는 코드를 넣는 칸이 없습니다.
      → 3번을 보세요. 코드는 «저절로 열리는 브라우저 창»에 넣습니다.

  [Claude 가 엉뚱한 걸 합니다]
      「falcon」이라고 말씀하지 않으신 것입니다.
      → 「falcon MCP 로 …」 로 다시 말해 주세요.

  [「로그인이 필요합니다」에서 멈췄습니다]
      → 검은 창에 claude 라고 치고 로그인하신 뒤
        「1_필수설치.cmd」를 다시 실행하세요. 여러 번 해도 안전합니다.

  [「프로그램을 찾을 수 없습니다」 — 설치 도중]
      방금 깐 프로그램은 «새로 연 창»에서만 인식됩니다.
      → 창을 모두 닫고 「1_필수설치.cmd」를 다시 실행하세요.
        그래도 안 되면 한 번 재부팅하세요.

  [제작 중에 python 또는 ffmpeg 를 찾을 수 없다고 나옵니다]
      같은 까닭입니다 — 창을 열어 둔 채로 설치하셨을 때 생깁니다.
      → 열려 있는 창(VS Code 포함)을 «모두 닫고»
        바탕화면의 「FALCON MCP 시작」 아이콘으로 다시 시작해 주세요.
        그래도 같으면 Windows 를 한 번 재부팅하세요.

  [「없는 모듈이 있습니다」가 나옵니다 — brotli · psutil · scrapling 같은 것]
      🟢 괜찮습니다. 그것들이 없어도 준비는 «끝난 것»으로 판정됩니다.
      함께 안내되는 설치 명령(pillow · numpy · opencv-python)과 목록이
      서로 다른 것도 원래 그렇습니다 — 고치실 «필요가 없습니다».
      그대로 다음으로 넘어가시면 됩니다.

  [검은 창에서 파이썬이 글자 깨짐 오류를 냅니다]
      (UnicodeEncodeError · cp949 같은 말이 보일 때)
      → 명령 «앞»에 이것을 붙여 주세요.

            PYTHONIOENCODING=utf-8

  [글씨체를 못 받았다고 나옵니다 / 서울한강체]
      → 저희 쪽에서 고치는 중입니다. 그 화면을 알려 주시면 됩니다.
        글씨체는 저희가 갖고 있어서, 서버에서 내려 드리도록 바꾸고 있습니다.

  [영상이 안 만들어집니다]
      마지막에 화면에 뜬 «메시지»를 그대로 알려 주세요.
      무엇이 없어서 멈췄는지 한국어로 적혀 있습니다.


■ 11. 🔴 이것만은 보내지 마세요
--------------------------------------------------------------
      - 열쇠 · 토큰 원문 (Typecast · EvoLink · 받아쓰기)
      - .env 파일 · 개인 인증서 · 로그인 정보
      - 홈 폴더의 .wetube · .volcano 폴더

  보내 주실 것은 «화면에 뜬 오류 메시지»와 «스크린샷»뿐입니다.
  (스크린샷에 열쇠가 찍혔으면 가려 주세요)

==============================================================
  막히시면 10번을 먼저 보시고, 그래도 안 되면 편하게 물어보세요.
==============================================================
