FAQ

Valxe는 네이티브 Swift + SwiftUI로 작성되어 iOS API(WKWebView, 키체인, 파일, 앱 익스텐션)와 깊이 통합되어 있습니다. Android 계획은 없습니다. macOS 사용자는 그냥 VS Code를 직접 쓰면 됩니다. 이 앱은 단 하나의 통점, 즉 "iPad에서 진짜 개발 환경"을 해결하기 위해 존재합니다.

App Store 버전은 7일 무료 체험 + NT$60 / US$1.99 일회성 구매로 영구 잠금 해제입니다(한 번 구매, 구독 없음, 월 요금 없음, AI 사용 추가금 없음). 체험은 앱 안에서 "7일 무료 체험 시작"을 눌러야 시작되며 Apple ID당 1회입니다. 기록은 App Store가 보관하므로 다시 설치해도 초기화되지 않고, 끝나도 자동으로 결제되지 않습니다. 체험 기간에는 모든 기능이 동작하고, 체험을 시작하기 전이나 끝난 뒤 구매하지 않은 동안은 읽기 전용 모드입니다 — 파일을 열고 볼 수는 있지만 파일 편집 / 생성 / 삭제, 터미널, AI 도우미, Git, 테마 가져오기는 잠금 해제가 필요합니다.

12개 제공자: Anthropic Claude, OpenAI, Google Gemini, DeepSeek, Groq, xAI(Grok), Mistral, OpenRouter, Zhipu GLM, Minimax, 로컬 Ollama, 그리고 OpenAI 호환 사용자 정의 백엔드. 에이전트 모드에서는 AI가 파일을 직접 읽고/쓰고 터미널 명령을 실행할 수 있습니다(내장 도구 5개). 로컬 Ollama는 iPad에서 Mac으로의 LAN 연결을 지원합니다 — 어떤 데이터도 네트워크를 벗어나지 않습니다. API 키는 직접 준비하며, 우리는 요금을 청구하지 않습니다.

안정성은 Valxe가 가장 먼저 챙기는 부분입니다. 해결한 예: pull이 더 이상 커밋하지 않은 로컬 파일을 덮어쓰지 않음, TTY 없는 서버에서 SSH가 크래시되지 않음, 연속된 C/C++ 실행이 크래시되지 않음, 같은 파일을 다시 열어도 크래시되지 않음, Stage Commit 경쟁 상태 수정 등. 의존성과 UI 디테일도 개선했습니다. 버전별 변경 사항은 이 사이트의 "업데이트 기록" 페이지에서 볼 수 있습니다. 중요한 프로젝트는 외부 Git 원격 저장소에 정기적으로 push해 백업하길 권장합니다.

네, 하지만 경험은 훨씬 떨어집니다 — 화면이 너무 작고, 키보드가 에디터를 가리며, 터미널이 비좁습니다. iPad(특히 외장 키보드를 쓰는 iPad Air / Pro)를 강력히 권장합니다. M 시리즈 칩이 언어 런타임을 가장 매끄럽게 실행합니다. iPhone은 한두 줄 빠르게 수정하거나 Git diff를 확인하는 데만 적합합니다.

절대 아닙니다. 개인 키는 iOS 키체인에 있으며(시스템 암호화, 다른 앱이 읽을 수 없음), 앱 자체도 평문을 절대 보지 않습니다. 백엔드가 없으므로 어떤 호스트에 접속하는지조차 알지 못합니다. 키를 직접 생성했는지 여부도 우리에게는 보이지 않습니다.

번들: Python 3.9.2, Node.js 18.19.0, PHP 8.3.2, Clang 14.0.0(C/C++ + WebAssembly), OpenJDK 8(Java). Python은 pip 패키지를, Node는 npm 패키지를 설치할 수 있고, PHP는 Laravel artisan을 실행할 수 있습니다. 시뮬레이터 빌드(Valxe UI)는 제한되어 — 일부 런타임은 실제 기기에서만 동작합니다.

번들된 Python / Node / PHP / Clang / OpenJDK 런타임은 사전 컴파일된 xcframework로 — 이 바이너리만으로도 1GB에 가깝습니다(데스크톱에 전체 개발 툴체인을 설치하는 것과 비슷). 그 대가로 iPad에서 완전히 오프라인으로 동작하는 언어 런타임을 얻습니다. 개발자에게는 그만한 가치가 있지만, 코드만 읽는 사람에게는 너무 클 수 있습니다.

이 사이트의 문의 양식으로 알려 주세요. 버그라면 기기 모델, iOS / iPadOS 버전, Valxe 버전, 재현 단계를 함께 적어 주시면 원인을 더 빨리 찾을 수 있습니다. 기능 제안은 어떤 상황에서 쓰고 싶은지도 알려 주세요.

절대 아닙니다. 체험이 끝나면 앱이 읽기 전용 모드로 전환될 뿐입니다 — 모든 파일을 열어 보고, 내용을 복사하고, 설정을 확인할 수 있습니다. 차단되는 것은 파일 편집 / 생성 / 삭제, 터미널, AI 도우미, Git, 테마 가져오기입니다. 파일 자체는 절대 삭제, 변경, 잠금되지 않습니다. 구매하지 않더라도 iPad의 코드는 안전하게 그대로 남으며, 언제든 iOS 파일 / iCloud Drive / AirDrop으로 꺼낼 수 있습니다.

일반 채팅: 묻고 AI가 답합니다 — 파일 접근 없음. 에이전트 모드: AI가 5개 도구를 호출할 수 있습니다 — `read_file`, `write_file`, `list_dir`, `grep`, `run_terminal`. 파일 읽기, 폴더 목록, 검색은 AI가 알아서 하지만 무언가를 바꾸는 작업은 반드시 사용자의 허락이 필요합니다. AI가 파일을 쓰거나 터미널 명령을 실행하기 전에 확인 카드가 나타나며 "허용", "거부", "이번 작업 동안 모두 허용" 중에서 고를 수 있고, 거부하면 실행되지 않습니다. 중지를 누르거나 대화를 지워도 함께 취소됩니다. 경로 제한: 읽기와 쓰기는 지금 열린 작업 공간 안으로 제한되며 절대 경로, `../`, 작업 공간 밖을 가리키는 바로가기(심볼릭 링크)는 차단됩니다. 원격 SSH 작업 공간 경로에 심볼릭 링크가 있어도 차단됩니다. 샌드박스 한계: 에이전트는 열린 작업 공간에만 접근하며 iOS 앱 샌드박스 밖으로는 나갈 수 없습니다.

단계: (1) Mac에서 `OLLAMA_HOST=0.0.0.0 ollama serve`를 실행해 Ollama가 LAN에서 수신하도록 합니다. (2) Valxe → 설정 → AI에서 제공자 "Ollama"를 추가하고 서버 주소를 `http://<Mac LAN IP>:11434`로 설정합니다(예: `http://192.168.1.50:11434`). (3) 모델을 추가할 때 앱이 `/api/tags`를 호출해 확인하고 사용 가능한 모델을 나열합니다; 실패 시 명확한 메시지를 표시합니다. 장점: 데이터가 네트워크를 벗어나지 않고, 유료 모델을 무료 로컬 모델로 대체하며, 에이전트 도구 사용도 계속 동작합니다(qwen2.5-coder / llama / mistral 등 OpenAI function-calling 호환 모델). Mac이 꺼져 있으면 앱은 크래시 없이 우아하게 실패합니다.

실행되는 것: pip가 있는 Python 3.9.2(numpy, pandas, requests, flask 등), npm이 있는 Node 18.19, Composer가 있는 PHP 8.3.2, Clang 14(C/C++ 컴파일 + WebAssembly 출력), OpenJDK 8(Java + kotlinc를 통한 Kotlin). iPad에도 데스크톱의 제약이 적용됩니다: numpy 같은 Python C 확장은 설치하려면 iOS arm64 사전 빌드가 필요하고; 네이티브 Node 모듈(node-gyp 빌드가 필요한 것)은 동작하지 않으며; PHP에는 OS 수준 라이브러리가 필요한 GD / Imagick / pcntl 등의 확장이 없습니다. 시뮬레이터 빌드(Valxe UI)는 iOS 시뮬레이터 프레임워크 한계로 더 제한되어 — 일부 런타임은 실제 기기 빌드에서만 동작합니다.

SwiftGit2(libgit2 래퍼)는 큰 리포지토리를 잘 처리합니다; iPad의 RAM과 저장 공간이 병목입니다. 기본 iPad(8GB RAM)는 Linux 커널(~4GB) 클론에 어려움을 겪고; M 시리즈 iPad Pro(16GB+)는 훨씬 매끄럽습니다. 팁: (1) 모노레포는 `--depth=1` 얕은 클론으로 공간을 절약하세요. (2) `--single-branch`로 모든 브랜치 기록을 가져오지 않도록 하세요. (3) Git LFS 바이너리 자산은 iPad 저장 공간을 주시하고 `.gitattributes`로 제외하세요. Stage Commit 경쟁 상태(`tab` 경쟁)는 수정되어 일상적인 커밋이 충돌로 데이터를 잃는 일은 없습니다.

좋은 소식: Monaco는 VSCode와 동일한 엔진입니다 — 구문 강조, 자동완성, 멀티 커서, Emmet, 테마 JSON이 완전히 호환됩니다. VSCode 색상 테마 JSON을 앱에 그대로 넣으면 동작합니다. 주요 차이: (1) 확장 생태계 — VSCode 확장은 직접 설치되지 않지만, 앱은 "JS 인젝션 패치" 패턴을 사용해 Swift 계층이 기능을 동적으로 추가/제거할 수 있습니다. (2) 설정은 settings.json이 아니라 iOS 설정에 있습니다 — 하지만 대부분의 단축키는 그대로 이어집니다(:wq, Cmd+P, Cmd+Shift+F 모두 동작). (3) iPad 전용 장점: Stage Manager 듀얼 윈도, 27인치 외부 디스플레이, Apple Pencil 터치, 종일 가는 배터리. 지향점은 "iPad에서 데스크톱급"이지 "MacBook + VSCode를 대체"가 아닙니다.