Condux 사용 가이드

처음 쓰는 분을 위한 안내입니다. 순서대로 따라 하면 10분 안에 첫 대화를 보낼 수 있습니다.

1. Condux 는 무엇인가요

여러 AI(Codex, Claude, GPT)를 한 화면에서 쓰는 Mac 앱입니다. 터미널을 몰라도 됩니다. AI 에게 질문하고, 사진·PDF 를 보여 주고, 프로젝트 폴더를 맡겨 코드를 고치게 하고, 한 AI 가 만든 것을 다른 AI 가 검토하게 할 수 있습니다.

세 가지 약속이 있습니다.

• 계정과 키는 사용자의 것입니다. 앱은 로그인 정보를 저장하지 않고, API 키는 이 Mac 의 키체인에만 둡니다.
• 돈이 드는 일은 미리 알려 줍니다. API 대화는 대화마다 예산(기본 1달러)이 있고, 다 쓰면 멈춥니다. 구독이 끝났다고 몰래 유료 API 로 바꾸지 않습니다.
• 고치거나 실행할 때는 먼저 묻습니다. 파일을 바꾸거나 명령을 실행하기 전에 허용을 묻고, 바꾼 파일은 되돌릴 수 있습니다.

2. 두 가지 버전

아래 3~5장은 두 버전 공통이고, 6~8장은 직접 설치판 이야기입니다.

3. 처음 설정

API 키 만들기 (5분)

1. Claude 를 쓰려면 https://platform.claude.com 에 가입하고 API Keys 메뉴에서 키를 만듭니다. OpenAI 는 https://platform.openai.com 에서 같은 방법으로 만듭니다.
2. 키는 sk- 로 시작하는 긴 글자입니다. 만든 직후 한 번만 보여 주니 바로 복사합니다.
3. 결제 수단을 등록하고 사용 한도를 작게(예: 월 5달러) 걸어 두면 안심입니다.
4. Condux 왼쪽 아래 연결 상태를 눌러 연결 관리를 열고, Claude API 또는 OpenAI API 줄의 키 넣기에서 키를 붙여 넣은 뒤 저장을 누릅니다. 저장되면 사이드바에 ‘키 설정됨’이 보입니다.

키는 다시 보여 주지 않습니다. 잃어버리면 사이트에서 새로 만들어 넣으면 됩니다.

직접 설치판: 구독으로 쓰기

• Codex: 연결 관리의 Codex 줄에서 ‘브라우저로 로그인’을 누르고 ChatGPT 계정으로 로그인합니다.
• Claude 구독: 연결 관리의 Claude 줄에서 ‘로그인 명령 복사’를 누른 뒤, 터미널(응용 프로그램 ▸ 유틸리티 ▸ 터미널)을 열어 붙여 넣고 Return 을 누릅니다. 브라우저가 열리면 로그인하고, 앱에서 ‘다시 확인’을 누릅니다.

두 CLI(명령줄 도구)가 미리 설치돼 있어야 합니다. 없으면 각 회사의 안내대로 설치합니다.

뭘 골라야 할지 모르겠다면 연결 관리 맨 위의 추천 설정 적용을 누르세요. 키·로그인·폴더는 바꾸지 않습니다. 화면 언어는 연결 관리 ▸ 일반 ▸ 언어에서 바꿉니다.

밝은 화면과 어두운 화면은 오른쪽 위의 해·달 버튼으로 바꿉니다. 연결 관리 ▸ 일반 ▸ 화면에서 Mac 설정을 따르게 할 수도 있습니다.

4. 첫 대화

1. 왼쪽 위 새 대화를 누릅니다. 가운데 입력창 오른쪽에서 어떤 AI 로 시작할지 고를 수 있습니다.
2. 입력창에 질문을 쓰고 Enter 를 누릅니다. 줄을 바꾸려면 Shift+Enter 를 누릅니다.
3. 답이 길면 ‘중단’(⌘.)으로 멈출 수 있습니다.

빈 대화에는 예시 질문이 떠 있습니다. 누르면 입력창에 들어갑니다. 막히면 ⌘? 를 눌러 ‘빠른 안내’를 열어 보세요.

5. 사진·파일 주고받기

• 붙이기: 입력창의 + 를 누르거나, 파일을 창 안에 끌어다 놓거나, 복사한 스크린샷을 ⌘⇧V 로 붙입니다. PNG·JPEG·PDF·ZIP 이 됩니다.
• 붙인 사진은 말풍선 안에 작게 보이고, 누르면 크게 열립니다.
• 받기: AI 가 파일을 돌려주면 대화에 ‘받은 파일’ 항목이 생깁니다. 열기 · Finder에서 보기 · 저장… 을 누르면 됩니다. 이미지는 바로 미리보기가 뜹니다.

6. 프로젝트 폴더에서 코드 고치기 (직접 설치판)

1. 새 대화 화면 입력창의 폴더 칩이나 연결 관리의 작업 폴더 줄에서 프로젝트 폴더를 고릅니다. 그 뒤 만드는 새 대화가 이 폴더에서 일합니다. 이미 만든 Claude 대화에는 오른쪽 클릭 ▸ ‘작업 폴더 연결…’ 으로 붙일 수 있습니다.
2. “빌드 오류를 찾아서 고쳐 줘” 처럼 시킵니다.
3. AI 가 파일을 고치거나 명령을 실행하려 하면 승인 카드가 뜹니다. 빨간 줄이 지워지고 초록 줄이 들어갑니다. 내용을 보고 허용 또는 거부를 누릅니다.
   • 파일 변경은 허용하기 직전에 원본을 백업합니다. 아래 ‘변경된 파일’ 목록에서 되돌리기를 누르면 원래대로 돌아옵니다.
   • 명령 실행으로 바뀐 파일은 되돌리기 대상이 아닙니다. 모르는 명령이면 거부해도 괜찮습니다.
4. 입력창의 폴더 칩을 눌러 빌드 실행을 누르면 Xcode 프로젝트나 Swift 패키지를 자동으로 알아보고 빌드합니다. 실패하면 오류를 AI에게 보내기로 오류 목록을 입력창에 채워 고쳐 달라고 할 수 있습니다.

파일 수정을 매번 묻는 게 번거로우면 폴더 칩 안의 ‘파일 수정 자동 허용’을 켭니다. 명령 실행은 그래도 항상 묻습니다.

7. 자동 릴레이

한 AI 가 만들고, 다른 AI 가 검토해서 고칠 점을 돌려주는 일을 자동으로 반복합니다.

1. 검토자로 쓸 API 키(Claude 또는 OpenAI)가 저장돼 있어야 합니다.
2. 입력창에 작업 지시를 쓰고 입력창의 릴레이 칩 ▸ 이 내용으로 릴레이 시작을 누릅니다.
3. 구현 → 검토 → 수정 요청이 자동으로 돌고, 검토자가 ‘APPROVED’ 라고 하거나 최대 횟수(기본 3회)에 닿으면 멈춥니다. 작업 폴더 대화에서는 라운드마다 빌드를 먼저 확인해 실패하면 오류를 바로 돌려보냅니다.
4. 검토 비용은 같은 대화의 예산에 합산됩니다. 예산이 다 되면 멈춥니다.

‘자동 수정’을 끄면 검토 의견만 받아 입력창에 넣고 멈춥니다. 보낼지는 직접 정합니다.

8. Figma·Mobbin·Xcode 도구 연결 (MCP, 직접 설치판)

1. 연결 관리의 ‘도구 (MCP)’ ▸ 추가 에서 Figma, Mobbin, Xcode 프리셋을 고릅니다.
2. Figma·Mobbin 같은 원격 서버는 로그인이 필요합니다. 서버 옆 ⋯ ▸ 로그인 명령 복사 를 누르고 터미널에 붙여 넣어 실행합니다. 브라우저에서 허용하면 끝입니다.
3. 켜 둔 서버는 다음 전송부터 Claude 대화에서, ‘다시 연결’을 누른 뒤 Codex 대화에서 쓸 수 있습니다.
4. 읽기만 하는 서버(Figma, Mobbin)는 ⋯ ▸ ‘도구 자동 허용’을 켜 두면 매번 묻지 않습니다.

8-1. 로컬 AI (시험 기능, 직접 설치판)

API 키 없이 이 Mac 안에서 글로 대화합니다. 설정의 ‘로컬 AI’에서 약 1GB 모델을 내려받은 뒤 ‘로컬 새 대화’를 누릅니다. 끊겨도 ‘이어서 받기’로 계속할 수 있습니다. 작은 시험용 모델이라 답이 부정확할 수 있고, 첨부·릴레이·프로젝트 폴더 작업은 되지 않습니다. 자세한 내용은 앱 저장소의 로컬 AI 안내 문서를 보세요.

9. 비용과 예산

• API 대화 아래에는 “예상 비용 $0.01 / 예산 $1.00” 처럼 보입니다. 공식 요율표로 계산한 추정치라 실제 청구와 다를 수 있습니다.
• 예산이 다 되면 전송이 막히고, 예산 +$1 을 눌러야만 올라갑니다.
• 구독(Codex, Claude) 대화는 달러로 계산하지 않고, Claude 는 5시간·7일 사용률만 보여줍니다.
• 요금은 앱이 아니라 Anthropic·OpenAI 가 사용자에게 직접 청구합니다. 앱 안에 결제는 없습니다.

GitHub 와 다른 프로그램 부리기 (직접 설치판)

GitHub

1. 연결 관리 ▸ 이 Mac 에서 ▸ GitHub 에서 상태를 봅니다. 로그인이 안 되어 있으면 로그인 명령 복사를 눌러 터미널에서 실행합니다.
2. 새 대화에서 프로젝트 폴더를 고릅니다.
3. “이번 변경을 커밋하고 PR 을 만들어 줘”처럼 시킵니다. 명령마다 승인 카드가 뜹니다. 앱은 GitHub 토큰을 읽지 않습니다.

Chrome 과 다른 앱

• 제어 대화: 연결 관리 ▸ 이 Mac 에서 ▸ 다른 프로그램 제어 ▸ 제어 대화 시작 을 누르고 “Safari 로 example.com 을 열어 줘”처럼 시킵니다. Claude 구독 로그인이 필요합니다. 처음 다른 앱을 조작할 때 macOS 가 권한을 묻습니다.
• Chrome 도구: 연결 관리 ▸ 도구 (MCP) ▸ 추가 ▸ chrome 을 고르면 AI 가 Chrome 을 열어 페이지를 읽고 누를 수 있습니다. Node 가 필요하고, 평소 프로필과 분리된 Chrome 창에서 돌아갑니다.

명령과 도구 호출은 자동으로 실행되지 않습니다. 모르는 명령은 거절하세요.

웹 검색

API 대화에서는 AI 가 웹을 검색하고 사용자가 준 링크를 읽은 뒤, 답변 아래에 출처를 보여 줍니다. 검색 1회당 약 $0.01 과 결과 토큰 비용이 대화 예산에 더해집니다. 연결 관리 ▸ 일반 ▸ 웹 검색에서 끌 수 있습니다. 앱스토어판은 Chrome 같은 다른 앱을 조작할 수 없습니다. 직접 설치판은 연결 관리 ▸ 도구 (MCP) 에서 Chrome 도구를 추가할 수 있습니다.

사용량과 컨텍스트

입력창 위의 작은 버튼에 이 대화의 컨텍스트가 얼마나 찼는지 표시합니다. 누르면 주고받은 토큰, API 예상 비용, 구독 한도 사용률을 볼 수 있습니다. 구독은 달러 비용을 표시하지 않습니다.

10. 단축키

11. 문제가 생기면

키를 넣었는데 ‘키 없음’이라고 나옵니다. 설정 창에서 키를 붙여 넣고 창을 닫거나 저장을 누르면 저장됩니다. 사이드바에 ‘키 설정됨’이 보이면 된 것입니다.

“예산을 다 썼습니다”가 뜹니다. 하단의 ‘예산 +$1’ 을 누르거나 새 대화를 만듭니다.

Claude 가 ‘로그인되어 있지 않습니다’라고 합니다. 터미널에서 claude auth login 을 실행하고 앱에서 ‘다시 확인’을 누릅니다.

빌드 실행이 실패합니다. 입력창의 폴더 칩 안에 있는 빌드 명령 칸을 확인하세요. iPhone 전용 프로젝트는 -destination 'generic/platform=iOS Simulator' 를 명령 끝에 붙여야 할 수 있습니다.

알림이 안 옵니다. 첫 알림 때 macOS 가 권한을 묻습니다. 시스템 설정 ▸ 알림 ▸ Condux 에서 켤 수 있습니다. 앱이 앞에 있을 때는 알림을 띄우지 않습니다.

대화 기록이 사라졌습니다. 앱을 켤 때 하루 한 번 기록을 복사해 둡니다. 앱 데이터 폴더(~/Library/Application Support/VibeStudio/)의 conversation-history에 최근 7개가 있습니다. 앱이 못 읽은 기록은 같은 폴더의 conversations.unreadable-…json에 남습니다. 도움이 필요하면 문의해 주세요.

대화를 지웠는데 복구하고 싶습니다. 앱 목록에서만 지워집니다. Codex 대화는 Codex 쪽 기록이, 받은 파일과 백업은 앱 데이터 폴더(~/Library/Application Support/VibeStudio/)에 남아 있습니다.

12. 개인정보

대화 기록, 첨부 복사본, 받은 파일, 변경 백업은 모두 이 Mac 안에만 있습니다. 메시지는 사용자가 고른 AI 회사(Anthropic, OpenAI, 또는 구독 CLI)로만 전송됩니다. 자세한 내용은 개인정보 처리방침을 보세요.