DeeperAI
시리즈: DeeperAI로 Claude 사용하기
- Mac 편 (1): DeeperAI란? / DeeperAI와 Claude로 무엇을 할 수 있는가
Mac 편 (2): 설정 및 AI 구성 ← 현재 위치
Mac 편 (3): 조작 및 기능 (준비 중)
- iOS 편 (1): iPhone에서 DeeperAI 사용하기 (준비 중)
지난 Mac 편 (1)에서는 DeeperAI가 '주제를 트리 구조로 깊이 파고드는 앱'이라는 점, 트리의 계층이 Finder의 폴더와 대응한다는 점, 그리고 Claude를 앱 제공 API 키로 Anthropic과 계약하지 않고 사용할 수 있다는 것을 그림으로 살펴보았습니다.
이번에는 그 'AI가 사용 가능한 상태'까지 도달하는 절차만 작성합니다. 범위는 다음 3가지입니다.
- 설치
- 최초 설정 (1 화면에서 끝납니다)
- AI 설정 (우선 아무것도 할 필요가 없다는 내용과, Claude Code를 사용할 경우의 순서)
주제를 만들고 깊이 파고드는 조작이나 개별 기능 설명은 Mac 편 (3)으로 나누었습니다. 이 글을 읽으면 바로 (3)로 넘어갈 수 있는 상태가 되었을 것입니다.
DeeperAI는 Mac App Store에서 배포하고 있습니다. macOS 15 이상에서 작동합니다.
다운로드하여 실행하면, 처음에 '환영' 화면이 나옵니다. 다음 절은 이 화면에 대한 내용입니다.
최초 실행 시 나타나는 것은 오직 이 한 장뿐입니다. 위에서부터 순서대로 채워나가면 끝납니다.
화면 상단 쪽에 'AI 실행 방식'이라는 안내가 있습니다. 'Anthropic API 키 또는 로컬 CLI 연동 중 하나가 필요합니다'라고 쓰여 있어 조금 긴장할 수도 있습니다.
하지만, 무료 플랜에서는 앱 제공 API 키가 자동으로 사용되므로, 여기서 무언가를 준비할 필요는 없습니다. 설정 화면에도 'API 키는 플랜에 포함되어 있습니다. 설정이 불필요합니다.'라고 표시됩니다 (3절에서 화면을 보겠습니다).
DeeperAI의 데이터(트리 내용 및 메모)는 .dpai라는 하나의 파일에 모두 저장됩니다. 여기서 만드는 것이 그 파일입니다.
- 파일 이름: 기본값은 'DeeperAI'. 그대로 두셔도 됩니다 -
- 저장 위치: 처음에는 '미선택 (생성 시 선택)'으로 표시되어 있습니다. '데이터 파일 생성'을 누르면 저장할 곳을 고르는 다이얼로그가 열리므로, 거기서 결정합니다 -
- 샘플 데이터 포함: 기본적으로 켜져 있습니다. 처음이라면 켜진 상태를 추천합니다. (1)에서 본 'AI 활용' 같은 트리가 처음부터 들어있어 화면 보는 법을 바로 알 수 있습니다.
저장 위치는 iCloud Drive를 추천합니다. 동일한 .dpai 파일을 iPhone의 DeeperAI에서 열 수 있게 되기 때문입니다 (iOS 편에서 사용합니다).
생성하면, 경로 아래에 '이후부터는
즉, 설치를 완료하는 시점에서 Claude를 사용할 수 있습니다. 채팅이나 분해 제안을 사용해 보세요(작동 방법은 (3)에서 설명합니다).
무료 플랜은 25,000 토큰(평생 누적)입니다. '사용해 보기', '이 앱이 나에게 맞는지 확인하기'에는 충분한 양이지만, 본격적으로 사용하면 며칠 만에 소진됩니다. 토큰을 모두 사용하면 AI 기능이 중단되고 설정 화면에 'AI 체험 한도를 사용하셨습니다'라는 메시지가 표시됩니다. 이때의 선택지가 다음 3-2입니다.
DeeperAI에는 무료 플랜, 월간 플랜, 영구 구매 버전의 세 가지 플랜이 있으며, 어떤 플랜을 사용하느냐에 따라 'Anthropic API Key', 'Keyless CLI' 두 가지 실행 모드의 내용이 달라집니다. (1) 표를 DeeperAI의 플랜에 맞춰 재구성하면 다음과 같습니다.
| DeeperAI 플랜 | 결제 방식 | 실행 모드 'Anthropic API Key' | 실행 모드 'Keyless CLI' |
|---|
| 무료 | 없음 | 앱 제공 키 (25,000 토큰・평생 누적) | 최초 실행부터 30일간 체험 |
| 월간 플랜 | 인앱 결제 (매월) | 앱 제공 키 (1,000,000 토큰/월) | 계약 기간 중 |
| 영구 구매 버전 | 인앱 결제 (1회) | 본인 API 키 (Anthropic 콘솔에서 종량 과금) | 기한 없음 |
표를 읽는 방법은 다음 두 가지입니다.
- 'Anthropic API Key'는 두 가지 방식입니다. 무료/월간 플랜에서는 앱 제공 키(설정 불필요・토큰 상한 있음), 영구 구매 버전에서는 본인 키(설정 1줄・앱 측 상한 없음=Anthropic에 종량 과금)를 사용합니다. 영구 구매 버전에는 앱 제공 키가 없습니다.
- 'Keyless CLI'의 기한은 플랜에 따라 결정됩니다. 영구 구매 버전 = 기한 없음, 월간 플랜 = 계약 기간 중, 그 외(무료) = 최초 실행부터 30일간입니다. 어떤 플랜이든 별도로 Claude Pro / Max 등 CLI 측 계약과 Claude Code 설치가 필요합니다 (3-4).
무료 한도가 소진되었을 때(또는 30일이 지났을 때)의 분기는 다음 세 가지입니다.
- 월간 플랜: 계속해서 앱 제공 키로 사용할 수 있습니다 (1,000,000 토큰/월). 설정은 필요 없습니다. Keyless CLI도 계약 기간 동안 사용할 수 있습니다. API나 CLI 계약이 없는 사람에게 적합합니다. 가격은 App Store의 표시를 확인하세요.
- 영구 구매 버전: AI 실행 모드란에 키 입력란이 나타나므로, 본인 API 키를 붙여 넣습니다 (Anthropic과의 종량 과금・앱 측 토큰 상한 없음). Keyless CLI도 기한 없이 사용할 수 있습니다. 이미 Anthropic API를 사용하고 있는 사람에게 적합합니다.
- Keyless CLI: Claude의 월간 플랜(Pro/Max)을 이용하는 사람이 가장 저렴합니다. 무료 플랜으로도 30일 동안 시험해 볼 수 있으므로, 그 사이에 월간 플랜 또는 영구 구매 버전 중 결정할 수 있습니다. 절차는 3-4에서 설명합니다.
영구 구매 버전을 구매하면 'AI 실행 모드'를 'Anthropic API Key'로 유지한 채, 그 아래에 키 입력란(sk-ant-...)이 나타납니다. Anthropic 콘솔에서 발급받은 키를 붙여 넣으면 Keychain에 저장됩니다. 이제 '모델'만 선택하면 됩니다.
무료/월간 플랜에서는 이 입력란이 나타나지 않습니다(앱 제공 키가 사용되기 때문입니다). 여기는 간단히 넘어가 다음 Keyless CLI로 넘어갑니다.
'AI 실행 모드'를 'Keyless CLI'로 전환하면, 다음 요구 사항이 표시됩니다.
Keyless CLI를 사용하려면 사전에 ①Claude Code 등 대응하는 CLI 도구의 이용 플랜 계약, ②CLI 본체의 설치, ③아래 '설치' 버튼을 통한 로컬 CLI 연동이 필요합니다.
이 ①②③ 순서로 진행합니다. ①②는 Anthropic 측 이야기이므로, 이미 Claude Code를 사용하고 있는 사람은 ③부터 건너뛰어도 괜찮습니다.
Claude Code는 Anthropic의 Claude Pro / Max 등의 계약으로 사용할 수 있습니다 ((1) 표의 'CLI / IDE 확장' 경로). 어떤 플랜에서 무엇을 할 수 있는지는 달라질 수 있으므로, Anthropic 공식 웹사이트에서 확인해 주세요.
터미널에서 Claude Code를 설치하고 한 번 claude
를 실행하여 로그인합니다. 절차는 Claude Code의 공식 문서를 따르세요.
# 설치 (공식 문서의 방법 중 하나로)
npm install -g @anthropic-ai/claude-code
# 실행 → 브라우저에서 로그인
...
터미널에서 claude --version
이 통하는 상태가 되면, DeeperAI 쪽으로 돌아갑니다.
-
설정 › AI 설정 ›
AI 실행 모드를 「Keyless CLI」로 전환합니다. - 상태 표시줄이 「설치 안 됨」인 경우, 「설치…」 버튼을 누릅니다.
-
폴더 권한 패널이 열립니다.
위치는 고정되어 있으므로, 아무것도 변경하지 않고「허용」만 누르면 됩니다
왜 이 패널이 뜨는지: DeeperAI는 App Store 심사를 통과한 앱이므로 샌드박스 안에서 작동합니다. 그 안에서 터미널 명령어(Claude Code)를 호출하려면, macOS가 준비한 「사용자가 승인한 스크립트 보관소」에 연동 스크립트를 놓을 필요가 있으며, 이 승인이 바로 이 패널입니다. 한 번 허용하면 다음부터는 나타나지 않습니다.
- 상태 표시줄이 「설치됨 (v○)」으로 바뀝니다 - 「CLI 엔진」에서 「Claude Code」를 선택합니다. 없는 CLI는 「(미설치)」로 연한 색으로 나와 선택할 수 없습니다. ②의 설치 후에 돌아왔을 때는 「재감지」를 누르면 인식됩니다 - 「모델」을 선택합니다
이렇게 하면, 채팅이나 분해 제안이 Claude Code를 통해 작동하게 됩니다. Anthropic의 종량제는 발생하지 않으며, Claude Pro / Max 측의 이용 한도 범위 내에서 사용할 수 있습니다 (한도와 모델의 관계는 3-5).
무료 플랜으로 Keyless CLI를 사용할 수 있는 기간은 DeeperAI를 처음 실행한 날부터 30일입니다. 남은 시간이 적어지면 플랜란에 「체험 잔여 N 일」이라고 표시됩니다.
기한이 되면, AI 실행 모드는 자동으로 「Anthropic API Key」로 돌아가며, 「Keyless CLI의 무료 체험 기간이 종료되었습니다」라는 안내와 「플랜 보기」 버튼이 나타납니다. 조용히 작동하지는 않습니다. 월간 플랜이나 일회성 구매판에 등록하면 선택했던 Keyless CLI로 자동으로 돌아갑니다. 기한은 3-2 표와 같으며, 월간 플랜은 계약 기간 동안, 일회성 구매판은 기한이 없습니다.
- Keyless CLI는 Mac 버전에서만의 기능입니다 (iOS 편에서는 나타나지 않습니다) - CLI 엔진에는 Claude Code 외에 Codex・Gemini의 CLI도 선택할 수 있지만, 일부 기능(안테나의 웹 검색・기능별 모델 선택 등)은 Claude Code 전용입니다
「Anthropic API Key」「Keyless CLI」 둘 다 「모델」란이 있으며, Claude Opus (고성능) / Sonnet (표준・권장) / Haiku (경량) 중에서 선택할 수 있습니다. 고성능 모델일수록 1회당 소비가 크고, 한도가 빨리 줄어들기 때문에, 루트별로 무엇이 줄어드는지 파악해 두는 것이 좋습니다.
자신의 API 키 (일회성 구매판): 줄어드는 것은 Anthropic에 대한 청구액입니다. 같은 토큰 수라도 Opus는 Sonnet의 몇 배 단가이므로, 평소에는 Sonnet으로 하고 무거운 상담만 Opus로 전환하는 것이 안전합니다 -
Keyless CLI (Claude Pro / Max): 줄어드는 것은 Claude Pro / Max의 이용 한도입니다. 한도에는 5시간 간격의 한도와 **주간 한도(Weekly limit)**가 있으며, DeeperAI에서의 이용도 Claude Code나 claude.ai에서의 이용과 합산됩니다. Opus는 Sonnet의 약 5배 속도로 한도를 소비하는 기준이므로, 주 후반에 멈추고 싶지 않다면 Sonnet 중심으로 사용하는 것이 좋습니다 (한도의 자세한 내용은 Anthropic의 도움말을 확인해 주세요) -
앱 제공 키 (무료・월간): 줄어드는 것은 플랜란의 잔여 토큰(25,000 token / 1,000,000 token/월)입니다. DeeperAI는 모델에 상관없이 입출력의 토큰 수를 그대로 계산하므로, 모델을 바꿔도 1회당 줄어드는 방식은 변하지 않습니다 (줄어드는 것은 금액이 아니라 토큰 수이기 때문입니다)
헷갈리면 「Sonnet(권장)」으로만 충분합니다.
데이터 파일이나 루트 폴더를 바꾸고 싶다면 → 설정 › 데이터 파일 탭에서 언제든지 바꿀 수 있습니다.
CLI 엔진이 '미설치' 상태라면 → 터미널에서 claude --version
이 통하는지 확인한 후 '재검출'을 누르세요.
'설치...'에서 오류가 발생했다면 → 오류 문구에 CLI 이름(claude / codex / gemini)이 들어 있습니다. 그 CLI만의 문제이므로, 문구를 그대로 읽고 대처한 뒤 다시 '설치...'를 누르면 덮어쓰기 설치됩니다.
'AI 체험 공간을 다 사용했습니다'라고 표시되었다면 → 3-2의 분기로 가세요. Claude Code가 있다면, 설정 화면의 힌트대로 CLI 모드로 전환하는 것이 가장 빠릅니다.
사용법이 모르겠다면 → AI 채팅에 'DeeperAI 사용 방법'을 물어보셔도 됩니다. 도움말 내용을 바탕으로 답변해 드립니다.
'그리고 다음에 무엇을 해야 하나요?'에 대해서는 Mac편(3)에서 다룹니다.
여기까지로 DeeperAI에서 Claude를 사용할 수 있는 상태가 되었습니다. 요약하자면,
- 설치하고 '환영합니다' 화면을 한 장 채우기만 하면 바로 사용을 시작할 수 있습니다.
- 무료 플랜은 앱 제공 API 키로 작동하므로, AI 설정은 처음에는 아무것도 할 필요가 없습니다.
- 무료 공간을 다 사용했다면, 월간 플랜(앱 제공 키) 또는 구매판(자신의 API 키) 두 가지 옵션이 있습니다. Keyless CLI는 구매판 = 기한 없음 / 월간 = 계약 기간 중 / 무료 = 30일입니다.
- Claude의 월간 플랜(Pro/Max)을 이용하는 분은 '설치...' → '허용'의 2번 클릭으로 CLI 연동이 가능합니다.
다음 Mac편(3): 조작 및 기능에서는 이 상태에서 테마를 만들고, AI와 함께 깊이 있게 다듬어 나가는 실제 조작 방법을 설명할 예정입니다.
또한, 2-2에서 .dpai 파일을 iCloud Drive에 두는 것을 추천한 이유는 **iOS편(1)**에서 다룹니다. 같은 파일을 iPhone의 DeeperAI로 열어서 외출 중에도 이어서 할 수 있습니다.
