#채팅과 내 에이전트

CutZal은 AI 모델을 직접 두지 않아요. 내가 이미 쓰는 Claude Code나 Codex를 연결하면, 그 구독으로 채팅과 컷 자동 완성이 돌아가요. 사용량은 내 구독에서 차감되고, CutZal이 따로 청구하지 않아요. 연결하지 않아도 기본 컷, 키보드 검토, 내보내기는 모두 쓸 수 있어요.

#연결하기

1. 터미널에서 Claude Code나 Codex를 설치하고 로그인해요. Claude Code는 Claude 유료 구독(Pro 이상) 계정으로, Codex는 ChatGPT 계정으로 로그인해야 해요. 무료 Claude 요금제로는 Claude Code를 쓸 수 없고, API 키 연결은 지원하지 않아요.
2. CutZal 설정의 에이전트에서 연결 상태를 확인해요. 설정을 열면 바로 확인하고, 연결되면 "구독 연결됨"처럼 표시돼요. 연결이 안 됐으면 채팅 입력창 아래에 안내와 설정 열기가 보여요. 한 번 연결되면 다음에 CutZal을 켤 때는 채팅이 알아서 다시 확인하므로 다시 할 일이 없어요.
3. 설치가 안 됐거나 버전이 낮거나 로그인이 필요하면 그 이유와 함께 설치, 업데이트, 로그인 명령을 보여 줘요. 명령 복사로 복사해 터미널에 붙여 넣으세요. 더 자세한 설치 방법은 설치 안내가 공식 문서를 열어요.

CutZal은 내 로그인 정보나 키를 받지 않아요. 터미널에서 내가 로그인한 프로그램을 그대로 구동할 뿐이에요. 연결 확인은 영상이나 전사를 보내지 않아요.

#제공사 약관과 내 계정

채팅과 컷 자동 완성은 내 Claude나 ChatGPT 요금제로 돌아가요. 그래서 각 회사의 약관이 그대로 적용돼요.

• 사용량은 내 요금제의 사용 한도에서 차감돼요. CutZal이 대신 결제하거나 사용량을 되팔지 않아요.
• Claude Code에는 Anthropic의 소비자 이용약관과 이용 정책이, Codex에는 OpenAI의 이용약관과 이용 정책이 적용돼요. Anthropic은 Pro와 Max 요금제의 사용 한도가 개인의 일반적인 사용을 전제로 정해져 있다고 안내해요.
• 로그인은 각 회사의 공식 로그인 화면에서만 끝나요. CutZal 화면에서 Claude나 ChatGPT 계정 정보를 입력하라고 하는 일은 없어요.

#왜 CutZal에는 로그인 창이 없나요

Anthropic의 법률·규정 안내는 다른 회사의 앱이 Claude 계정 로그인을 직접 받거나 로그인 정보를 보관하는 것을 허용하지 않아요. 같은 안내는 사용자가 수정하지 않은 Claude Code에 자기 구독으로 로그인해 쓰는 것은 막지 않는다고 적고 있어요. 그래서 CutZal은 로그인을 공식 프로그램에 맡기고, 내가 로그인해 둔 프로그램을 고치지 않고 그대로 실행해요. Codex도 같은 방식으로 연결해요.

#제공사 정책이 바뀌면

• 지금 방식으로 연결할 수 없게 되면 CutZal은 업데이트로 그 연결을 끄고, 설정의 에이전트와 채팅 입력창 아래에 이유를 보여 줘요.
• 연결이 꺼져도 기본 컷, 키보드 검토, 내보내기는 그대로 쓸 수 있어요. 다른 쪽 연결이 있으면 그 모델로 채팅을 이어 갈 수 있어요. 컷 자동 완성은 Claude로만 돌아요.
• 계정에 대한 조치는 각 회사의 약관을 따라요.

#채팅으로 편집 맡기기

채팅 패널에 하고 싶은 일을 적어 보내요. 예를 들면 "선택한 구간의 반복 설명을 줄이고 완성된 문장은 남겨 줘" 같은 지시예요.

• 범위: 전사 줄이나 타임라인 블록을 고른 뒤 보내면 그 구간만 다루고, 아무것도 고르지 않으면 영상 전체를 다뤄요. 입력창 위 칩에 전체 영상이나 고른 구간이 보여요. 완성본 타임라인 블록의 오른쪽 클릭 메뉴에서 이 구간을 채팅에 첨부로 넣을 수도 있어요.
• 맡길 수 있는 일: 자르기와 되살리기, 효과음 배치, 화면 구성 바꾸기, 모션 그래픽 만들기, 체크포인트로 되돌리기예요. 전사, 내보내기, 로그인은 채팅이 하지 못해요.
• 모델: 입력창 아래 모델 칩에서 골라요. Claude 묶음은 Claude로, GPT 묶음은 연결한 Codex로 돌아가고, 묶음마다 추천 모델에 표시가 있어요. 옆의 사고 깊이 칩에서 얼마나 깊게 생각할지 정해요. 새 대화는 모델마다 정해진 기본 깊이로 시작하고, 모델을 바꾸면 그 모델의 기본 깊이로 바뀌어요. 한 세션은 처음 보낸 모델의 제공자로 정해지니, 바꾸려면 새 세션을 열어요.
• 이미지와 자료: 첨부의 이미지 첨부로 참고 이미지를 4장까지 함께 보낼 수 있어요. 입력창에 끌어 놓거나 붙여 넣어도 돼요. 참고자료 연결로 기획안 같은 파일이나 폴더를 대화에 연결하면 AI가 읽을 수 있어요.
• 긴 지시: 입력창의 펼치기 버튼을 누르면 같은 입력창이 화면 가운데에 넓게 열려 전체를 보며 고칠 수 있어요. 쓰던 글과 첨부, 범위는 그대로이고, Esc나 같은 버튼, 바깥을 누르면 원래 자리로 돌아가요. 펼친 채 보내면 보낸 뒤 접혀요. 지시는 2,000자까지 쓸 수 있고 펼친 입력창에 글자 수가 보여요.

입력창 아래 줄에 어느 구독을 쓰는지 보이고, 무엇을 어디로 보내는지는 채팅 머리 더 보기의 세션 정보에 있어요. 대화는 프로젝트 폴더에 저장돼서 앱을 다시 열어도 이어져요.

#여러 곳을 모아 한 번에 보내기

검토하다 보면 고칠 곳이 여기저기 생겨요. 곳마다 따로 보내지 않고 보낼 목록에 모았다가 한 번에 보낼 수 있어요.

1. 고칠 곳을 고르고 C를 눌러요. 전사 줄, 타임라인 구간, 트랙 클립을 고르면 그곳이, 아무것도 고르지 않으면 재생 위치가 담겨요. 떨어진 곳을 여러 개 골라 누르면 곳마다 따로 담겨요.
2. 입력창 위 목록에 메모 칸이 열려요. "이 문장 살려 줘"처럼 짧게 적고 Enter를 누르면 보던 곳으로 돌아가요. 메모는 나중에 써도 돼요.
3. 다 모았으면 보내기를 눌러요. 입력창에 적은 글은 목록 전체에 대한 지시가 되고, 비워도 돼요. 한 번에 10곳까지 한 요청으로 보내요.

• 앞에서 컷을 바꿔도 담은 곳은 같은 말을 가리켜요. 그곳이 모두 잘렸으면 목록에 "잘림"으로 보여요.
• 눈 모양 버튼을 켜면 AI가 그 시각의 화면도 보고 처리해요. 캠 크기처럼 화면을 봐야 하는 메모에 켜요.
• 결과는 곳마다 "완료"나 "못 함"과 이유로 돌아와요. 못 한 곳은 이유와 함께 목록 맨 앞에 다시 담겨서, 메모를 고쳐 다시 보낼 수 있어요. 요청이 실패하거나 중단되면 보낸 곳이 모두 돌아와요.
• 두 메모가 같은 곳을 건드리면 나중에 담은 메모를 따라요.
• 채팅이 일하는 동안에도 다음 곳을 담고 메모할 수 있어요. 보내기는 지금 요청이 끝난 뒤에 해요.
• 자르기나 되살리기처럼 키 한 번에 끝나는 일은 목록에 담지 말고 바로 하는 편이 빨라요. 목록은 효과음, 화면 구성, 살릴지 판단처럼 AI에게 맡길 일에 써요.

#확인하고 적용하기

채팅의 제안을 언제 반영할지는 입력창 아래 권한 칩으로 정해요.

• Plan mode: AI가 화면과 자료를 확인하고 계획과 제안만 답해요. 편집을 바꾸거나 모션을 만들지 않아요. 제안은 변경사항 적용으로 직접 넣을 수 있고, 계획대로 맡기려면 모드를 바꾼 뒤 "이대로 진행해"처럼 보내요.
• Always ask: 새 세션은 늘 이 모드로 시작해요. AI가 바꿀 내용을 먼저 보여 주고, 내가 변경사항 적용을 눌러야 편집에 들어가요. 제안을 본 뒤 내가 편집을 바꾸면 그 제안은 적용할 수 없게 되니, 같은 요청을 다시 보내요.
• Accept edits: 삭제, 복원, 효과음 배치를 바로 적용해요.

Always ask에서 에이전트가 모션 작업물을 배치할 때는 배치할 작업물 목록으로 한 번 물어요. 줄을 고르면 오른쪽에서 그 작업물이 재생되고, 위아래 화살표로 옮겨 가며 볼 수 있어요. 넣지 않을 작업물은 체크를 풀고(Space) 나머지를 배치해요. 폰에서는 제목을 누르면 그 줄 아래에서 미리 볼 수 있어요. 그 창에서 이 대화에서는 배치를 묻지 않기를 켜면 그 대화의 배치는 더 묻지 않고, 컷이나 복원 같은 다른 편집은 그대로 물어요. 다시 묻게 하려면 권한 칩 메뉴의 작업물 배치에서 이 대화에서는 배치를 묻지 않기를 꺼요.

#진행 보기

채팅이 일하는 동안 에이전트의 설명과 도구 실행이 대화에 차례로 쌓여요. 도구 줄을 누르면 그 도구가 받은 요청과 결과 원문이 펼쳐지고, 모델, 토큰, 예상 금액은 턴 아래 작업 상세에 접혀 있어요. AI의 생각 과정은 보이지 않아요. 설명과 답의 굵은 글씨, 목록, 표, 코드는 읽기 좋게 보이고, 링크를 누르면 기본 브라우저에서 열려요.

맨 아래를 보고 있으면 새 내용을 따라가요. 위로 올려 읽거나 무언가를 펼쳐 읽는 동안에는 그 자리에 머물고, 아래 화살표 버튼을 누르거나 맨 아래까지 내리면 다시 따라가요.

채팅이나 컷 자동 완성이 살펴보는 구간은 타임라인의 이름표와 윤곽, 전사의 테두리로 보여요. 완성본에서 이미 잘린 구간도 연결 지점과 접힌 삭제 줄에 표시돼요. 진행 위치가 바뀌어도 내가 보고 있는 화면은 움직이지 않아요. 작업 위치로 가려면 타임라인 도구줄의 상태 문구를 눌러요. 설정의 편집 · 단축키에서 에이전트 작업 위치로 이동에 원하는 키를 지정할 수도 있어요.

실제로 적용된 컷과 복원은 바뀐 곳에 잠깐 표시돼요. 움직임 줄이기를 켜 두면 이 반짝임은 꺼지고 작업 위치만 보여요. 이어서 보낼 지시가 있으면 상태 줄에 대기 개수도 나타나요.

#채팅이 일하는 동안

외부 에이전트가 편집 작업을 선언하면 상태 줄에 이름·작업과 마지막 요청 시각이 보여요. 직접 고치기로 넘겨받으면 에이전트는 기다리고, 내가 고친 뒤 에이전트에게 돌려주기를 누르면 같은 작업에 변경 내용을 전달해요. 더 이어가지 않으려면 외부 작업 끝내기를 눌러요. 연속 에이전트 편집은 실행 취소 한 번으로 되돌리고, 중간에 내가 고친 내용은 별도 이력으로 남아요.

채팅이 일하는 동안에는 편집이 잠겨요. 내가 고친 내용과 AI가 바꾸는 내용이 부딪히면 채팅 요청 전체가 실패하기 때문이에요. 재생, 구간 선택, 원본 듣기, 다음 지시 쓰기는 그대로 할 수 있어요.

• 잠긴 동안에는 타임라인 도구줄 가운데에 채팅 모델, 지금 단계, 걸린 시간과 편집 잠김이 보이고, 타임라인에 빗금이 쳐져요. 그 옆에 직접 고치기와 중단 버튼이 있어요. 잠긴 동안 자르기, 되살리기, 실행 취소 같은 편집을 하면 이유와 함께 직접 고치기 버튼이 한 번 더 떠요.
• 편집 제어권을 에이전트가 쥐고 있으면 창 가장자리에 테두리가 켜져요. 직접 고치기를 누르면 꺼지고, 폰의 진행·채팅 화면에도 에이전트가 기다린다고 보여요. 기다리는 동안 폰에서도 대본을 고칠 수 있어요.
• 직접 고치기를 누르면 채팅이 멈추고 바로 편집할 수 있어요. 채팅은 끝나지 않고 기다려요. 도구줄에는 직접 고치는 중과 기다리는 채팅 모델, 걸린 시간이 보여요. 채팅이 적용하던 편집이 있으면 그것이 끝날 때까지 버튼이 넘겨받는 중으로 바뀌어 기다려요.
• 다 고쳤으면 도구줄의 에이전트에게 돌려주기를 눌러요. 채팅이 같은 대화에서 앞 요청을 이어 가고, 내가 고친 곳은 사람이 정한 것으로 알고 되돌리지 않아요. 기다리던 대화의 입력창에 글을 써서 보내도 돌려주기가 되고, 쓴 글은 덧붙인 말로 함께 가요. 돌려준 요청 위에는 에이전트에게 돌려줌과 내가 고친 곳의 목록이 남아요.
• 이어 가지 않으려면 끝내기를 눌러요. 기다리던 동안 멈춘 대기열은 그대로 남고, 이어서 보내기로 다시 보낼 수 있어요. 새 지시를 따로 보내거나 컷 자동 완성을 시작해도 기다림은 끝나요.
• 중단은 채팅을 멈추기만 하고 기다리지 않아요. 멈추는 동안 버튼은 중단하는 중이에요. 어느 쪽이든 채팅이 이미 적용한 편집은 남고, 체크포인트로 되돌릴 수 있어요.
• 폰과 터미널 에이전트의 편집도 채팅이 끝날 때까지 받지 않아요. 폰의 대본 화면은 그대로 보이고, 자르기와 확인 버튼만 이유와 함께 꺼져요.
• 컷 자동 완성이 도는 동안에는 미디어와 컷 설정만 잠겨요. 먼저 나온 컷을 들으며 되살리는 일은 그대로 할 수 있어요. 미디어나 설정을 바꾸려면 컷 자동 완성 멈추기를 눌러요.

채팅이 적용한 편집은 타임라인 도구줄의 실행 취소나 ⌘Z로 되돌릴 수 있어요. 적용할 때마다 직전 시점이 체크포인트로 남아서, 이 작업 전으로 되돌리기로도 돌아갈 수 있어요. 지난 체크포인트는 채팅 머리 더 보기의 체크포인트에서 골라요. 그 뒤에 내가 직접 고친 내용까지 함께 되돌아가는 경우에는 먼저 확인을 받아요.

권한 모드와 상관없이 늘 사람이 직접 누르는 일이 있어요. 돈이나 사용량이 들거나 되돌리기 어려운 일이에요.

• 전사 시작 (전사 고르기)
• 컷 자동 완성 시작 (검토 루프와 AI 컷 등급)
• AI 효과음 만들기: 약관 동의와 만들기 버튼
• 모션 그래픽 작업물을 타임라인에 놓기
• 내보내기 (내보내기)

#첫 화면에서 지시하고 시작하기

첫 화면 입력칸에 하고 싶은 일을 적고 영상 파일을 붙여 보내기를 누르면, 미디어 가져오기 창이 열려요. 가져온 뒤 전사까지 끝나면 적어 둔 지시가 채팅으로 한 번 전송돼요. 이때도 내 Claude Code가 연결돼 있어야 하고 구독 사용량이 차감돼요. 보내지 않으려면 대기 중인 지시의 지시 빼기를 눌러요.

#내 터미널의 에이전트로 쓰기

터미널의 Claude Code나 Codex가 cutzal 명령으로 CutZal 프로젝트를 읽고 고치게 할 수도 있어요. 자동화나 여러 프로젝트를 한꺼번에 다룰 때 좋아요.

1. 설정의 에이전트에서 외부 에이전트 연결 (CLI·Skill)을 찾아요.
2. 명령과 Skill 설치에서 cutzal 명령, Claude Code Skill, Codex Skill을 설치해요. 누를 때만 ~/.local/bin/cutzal, ~/.claude/skills/cutzal, ~/.codex/skills/cutzal에 링크를 만들고, 같은 이름의 다른 파일은 건드리지 않아요.
3. CutZal을 켜 둔 채로 에이전트에게 맡기려면 외부 에이전트 연결 (CLI·Skill) 옆 스위치를 켜요.

연결을 켜면 에이전트의 편집이 실행 중인 CutZal을 거쳐 들어와서, 사람의 편집과 똑같이 실행 취소와 체크포인트로 되돌릴 수 있어요. CutZal이 그 프로젝트를 열고 있는데 연결이 꺼져 있으면 에이전트의 편집은 거절돼요. 두 쪽이 같은 파일을 덮어쓰지 않게 하기 위해서예요. CutZal이 꺼져 있을 때는 에이전트가 프로젝트를 직접 고쳐요.

에이전트는 cutzal changes --since로 마지막으로 본 뒤 누가 무엇을 고쳤는지 읽을 수 있어요. 편집이 바뀌어서 요청이 거절될 때도 변경 내역을 함께 받아요. 공식 Skill은 사람이 직접 고치거나 폰에서 되살린 구간을 확인하고, 그 수정을 보존하며 계획을 다시 세우도록 안내해요. 오래됐거나 빠진 기록이 있으면 현재 프로젝트를 다시 확인해야 해요.

에이전트가 할 수 없거나 사람 확인을 거치는 일도 있어요.

• 내보내기를 요청하면 CutZal의 내보내기 창이 열리고, 사람이 내보내기 시작을 눌러야 해요.
• 내가 직접 고친 내용까지 되돌리는 요청이면 외부 에이전트가 요청한 되돌리기 창이 떠요. 되돌리기나 거절을 골라요.
• 크레딧 전사, 전사 모델 받기, AI 효과음 만들기는 에이전트가 시작할 수 없어요.

에이전트에게는 https://cutzal.ai/llms.txt 주소 하나만 알려 주면 돼요. 명령과 작업 순서는 AI 에이전트로 CutZal 쓰기(영어)에 있어요. CutZal 앱을 다른 폴더로 옮겼다면 다시 설치를 눌러 링크를 고쳐요.

#Skill로 편집 설정 저장하기

자주 쓰는 편집 설정은 Skill로 저장해 두고 다른 프로젝트에 적용할 수 있어요. 설정의 Skills · 플러그인 · MCP에서 만들고, 채팅 패널의 프로젝트에 Skill 적용에서 설정 적용 미리보기로 바뀌는 점을 본 뒤 Skill 설정 적용을 눌러요. 지금은 무음 컷 기준과 자료 표시 방식이 적용되고, 함께 적어 둔 편집 지시는 저장만 돼요.