OpenShell
生產力
免費 · 專為 iPad 設計。尚未針對 macOS 驗證。
OpenShell — 로컬 LLM, 클라우드 API, SSH 원격 코딩까지. 다양한 AI 백엔드를 iPhone 하나로 쓰는 통합 AI 클라이언트.
Ollama·MLX·LM Studio 로컬 모델, OpenAI·xAI Grok·Nous Hermes 클라우드 API, 그리고 SSH로 연결한 원격 Mac의 Claude Code까지 — 원하는 백엔드를 골라 같은 앱에서 대화하고 작업하세요. 가벼운 질문부터 코드 리뷰·파일 수정·빌드 실행까지 iPhone에서 직접.
주요 기능
• 멀티 백엔드 — Ollama·MLX·LM Studio 로컬 서버와 OpenAI·xAI Grok·Nous Hermes 등 OpenAI 호환 API를 호스트 목록 하나로 자유 전환
• AI 채팅 — 로컬 모델·클라우드 API·Claude와 자연어 대화, 모델 즉시 전환
• SSH 원격 코딩 — 원격 Mac/Linux 접속, Claude Code 호출로 코드 수정·파일 관리·빌드 실행
• 사진·파일 첨부 / 사진 보관함 / 세션 유지 / 작업 완료 알림 / 라이트·다크 모드 / 한국어·영어
…(사용 방법·필요 환경·개인정보 동일 구조, 모드명만 갱신)
更多 [연결·사용성]
- 놓친 응답 자동 복구 — 폰 잠금·네트워크 전환으로 연결이 끊겨도, 세션에
다시 들어가면 그 사이 완료된 응답을 자동으로 이어받아 표시 (답을 잃지 않음)
- 자동 재연결 — 화면을 다시 켜거나 네트워크가 바뀌면 끊긴 연결을 스스로 복구
(수동 재연결 불필요)
- SSH 키 인증 — 비밀번호 대신 SSH 키로 안전하게 연결
(기존 비밀번호 방식도 그대로 지원)
- 연결 상태 표시 — 연결이 안 될 때 원인(네트워크·Mac·인증)을 구분해 안내
- 완료 알림 바로 열기 — 작업 완료 푸시를 누르면 해당 세션으로 곧장 진입
- 세션 관리 개선 — 세션 이름 변경, 삭제 전 확인, 권한 모드 세션별 기억
[보안]
- 접속 토큰 보관 방식 개선 — 데몬 접속 토큰을 기기 키체인에 안전하게 저장.
기존 토큰은 앱을 처음 열 때 자동으로 옮겨지며, 다시 입력할 필요 없음
- 네트워크 보안 정책 강화 — 앱이 평문으로 통신할 수 있는 범위를
홈 네트워크와 Tailscale 주소로 제한
- Claude 인증 정보 복사 기본 꺼짐 — 호스트 설정에서 이 옵션이 이제 기본으로
꺼져 있으며, 켤 때 인증 정보가 대상 기기에 파일로 복사된다는 안내가 표시됨
- 내장 데몬 갱신 — 최신 버전으로 업데이트하고, 접속 허용 범위와
실행 옵션 검증을 강화
[변경 안내]
- Tailscale에 IP 주소(100.x.x.x)를 직접 입력해 연결하던 경우, MagicDNS
호스트 이름(예: mymac.tail-xxxx.ts.net)으로 바꿔 입력해 주세요.
홈 네트워크 주소(192.168.x.x 등)는 그대로 사용할 수 있습니다.
1.2.2 7月31日
이번 업데이트는 연결 안정성에 집중했습니다.
- 연결이 끊겨 서버에 전달되지 못한 메시지를 자동으로 다시 보냅니다
- 이전 응답을 복구하는 중에도 새 메시지를 바로 보낼 수 있습니다 ("다른 요청이 진행 중" 차단 제거)
- 중간에 끊긴 응답은 재연결 시 중복 없이 이어서 복구합니다
- 연결이 돌아오면 오류 표시가 자동으로 사라집니다
- Claude CLI를 새 방식으로 설치한 Mac에서 두 번째 메시지부터 응답이 오지 않던 문제를 수정했습니다
- 연결 도우미(daemon)가 문제를 만나면 침묵하지 않고 즉시 오류를 표시합니다
1.2.1 7月22日
- 놓친 응답 자동 복구 — 폰 잠금·네트워크 전환으로 연결이 끊겨도, 세션에 다시 들어가면 그 사이 완료된 응답을 자동으로 이어받아 표시 (답을 잃지 않음)
- 자동 재연결 — 화면을 다시 켜거나 네트워크가 바뀌면 끊긴 연결을 스스로 복구 (수동 재연결 불필요)
- SSH 키 인증 — 비밀번호 대신 SSH 키로 안전하게 연결 (기존 비밀번호 방식도 그대로 지원)
- 연결 상태 표시 — 연결이 안 될 때 원인(네트워크·Mac·인증)을 구분해 안내
- 완료 알림 바로 열기 — 작업 완료 푸시를 누르면 해당 세션으로 곧장 진입
- 세션 관리 개선 — 세션 이름 변경, 삭제 전 확인, 권한 모드 세션별 기억
1.2.0 7月9日
- 영어 전면 지원 — 앱 전체 UI 영어 완역(이전엔 일부 화면이 한국어로 표시)
- 작업 완료 푸시 알림 — 원격 작업이 끝나면 앱이 꺼져 있거나 잠금 상태여도 바로 알림(한국어·영어 자동)
- 새 호스트 추가 시 백그라운드 데몬 자동 설치 — 수동 셋업 불필요
- 앱 이름 변경: ClaudeShell → OpenShell
- 로컬 모델·외부 API 연결 가이드 보강
- 호스트 목록 드래그 정렬 및 IP 표시 개선
- VoiceOver 접근성 개선 — 채팅 메시지 정확히 읽기
- Claude 인증 안내 명확화 및 응답 상태 안정화
1.1.0 6月4日
- 작업 완료 푸시 알림 — 원격 작업이 끝나면 앱이 꺼져 있거나 잠금 상태여도 바로 알림 (한/영 자동)
- 새 호스트 추가 시 백그라운드 데몬 자동 설치 — 수동 셋업 불필요
- 앱 이름 변경: ClaudeShell → OpenShell
- 연결 가이드 보강: 로컬 모델·외부 API 연결 안내
- 호스트 목록 드래그 정렬 및 IP 주소 표시 개선
- Claude 인증 안내 명확화 및 응답 상태 표시 안정화
1.0.8 6月1日
- 앱 이름 변경: ClaudeShell → OpenShell
- 연결 가이드 보강: 로컬 모델·외부 API 연결 안내 추가
- 호스트 목록 순서 변경(드래그) 및 IP 주소 표시 개선
- Claude 인증 안내 명확화
- 응답 상태 표시 안정화
1.0.7 5月21日
- 호스트 이름 수정 시 대화창 우측 상단·사이드바·세션 목록 호스트 이름이 즉시 반영되도록 수정
1.0.6 5月19日
- 외부 OpenAI 호환 API 직접 연동 — OpenAI, xAI Grok, Nous Hermes 등 Bearer 인증 API Key 입력 지원
- 호스트 카드 편집 기능 추가 — 리스트에서 오른쪽으로 밀어 이름·연결 정보·workspace 등 수정
- 호스트 카드 길게 눌러 편집·삭제 메뉴 진입 — 스와이프 외 보조 경로 추가
- 사이드바 상단에 "호스트 추가" 버튼 고정 — Mac Catalyst 툴바에서 누락되던 진입점 보강
- iPad·Mac 채팅 UX 를 iPhone 과 통일 — 단일 ChatView 로 일관성 강화
- iPad 사이드바 토글(>>) 동작 정상화 — 시스템 토글로 컬럼 가시성 전환 가능
- 첫 실행 안내(Onboarding)에 OpenAI 호환 backend 페이지 추가
- 호스트 추가 화면에 로컬 서버·외부 API 기본 주소 및 인증 방법 안내 추가
- 앱 재시작 후 외부 API 호스트의 인증 헤더 누락으로 발생하던 401 오류 수정
- Tailscale 호스트(100.x CGNAT 대역) 접속 차단 문제 수정
1.0.5 5月19日
- 외부 OpenAI 호환 API 직접 연동 — OpenAI, xAI Grok, Nous Hermes 등 Bearer 인증 API Key 입력 지원
- 호스트 카드 편집 기능 추가 — 리스트에서 오른쪽으로 밀어 이름·연결 정보·workspace 등 수정
- iPad·Mac 채팅 UX 를 iPhone 과 통일 — 단일 ChatView 로 일관성 강화
- 첫 실행 안내(Onboarding)에 OpenAI 호환 backend 페이지 추가
- 호스트 추가 화면에 로컬 서버·외부 API 기본 주소 및 인증 방법 안내 추가
- 앱 재시작 후 외부 API 호스트의 인증 헤더 누락으로 발생하던 401 오류 수정
- Tailscale 호스트(100.x CGNAT 대역) 접속 차단 문제 수정
1.0.4 5月19日
- OpenAI, xAI Grok, Nous Hermes 등 외부 OpenAI 호환 API 직접 연동 지원 — Bearer 인증 API Key 입력
- 앱 재시작 후 외부 API 호스트의 인증 헤더 누락으로 발생하던 401 오류 수정
- Tailscale 호스트(100.x CGNAT 대역) 접속 차단 문제 수정
- 호스트 추가 화면에 로컬 서버·외부 API 기본 주소 및 인증 방법 안내 추가
- 첫 실행 안내(Onboarding)에 OpenAI 호환 backend 페이지 추가
1.0.3 5月19日
아이폰에서 Claude Code로 원격 개발하세요. SSH 터미널 + AI 채팅 + 파일 관리.
1.0.2 5月15日
- HTML 미리보기 — Claude가 만든 HTML 페이지·URL·원격 파일을 앱 안에서 바로 미리보기 (Safari/WKWebView 통합 sheet)
- 응답 대기 시각화 — 칩에 elapsed 시간 상시 표시 + silence 기반 색상화 (10s 노랑 / 30s 주황 / 60s 빨강). 정상 응답엔 색 변화 안 함, 진짜 stuck만 alarm
- 자동 재확인 — Claude가 "N분 후 알림" 약속하면 ClaudeShell이 자동으로 N분 후 "[자동 확인]" 발화. 한국어/영어 패턴 + 최대 3회 재시도
- 응답 stuck 자동 해소 — daemon 응답 종료 race로 stuck되던 케이스 자동 cleanup
- 채팅 성능 — 송신 시 스크롤 위치 race 해결 + 메인스레드 freeze 해소 (정규식 캐싱 + view 캐시)
1.0.1 5月15日
채팅에 ClaudeShell만의 시그니처를 더했습니다.
Claude가 응답할 때 민트빛 펄스가 잔잔히 흐르고, 메시지를 보내는 순간 입력창 위로 가는 띠 한 줄이 흘러갑니다. 메시지가 좌우에서 자연스럽게 슬라이드해 들어옵니다.
더 부드러워진 스트리밍.
응답 중 글자가 흔들리거나 키보드 뒤로 사라지던 현상을 해결했습니다. 스크롤은 필요한 순간에만 부드럽게 동작합니다.
호스트 추가가 한 번에 끝납니다.
새 호스트를 추가할 때 Claude Daemon을 자동으로 설치하고, 완료되면 바로 채팅창으로 들어갑니다. 비밀번호 없이 접속과 자동 시작 등록까지 한 흐름으로 처리됩니다.
1.0.0 5月7日
스트리밍 응답 UX 대폭 개선:
• Bash, Read 등 도구 실행을 채팅에서 실시간 표시 ( Bash 실행 중...)
• 텍스트가 도착하는 대로 화면이 부드럽게 따라감
• 답변 끝까지 자동 스크롤
• 시각적 중복 표시 정리
0.1.3 5月2日
워크스페이스별 채팅 분리
한 세션 안에서 워크스페이스를 바꿔도 각 워크스페이스의 대화 기록이 별도로 유지됩니다. 예전에는 워크스페이스를 바꾸면 채팅이 섞여 보였는데, 이제 워크스페이스마다 흐름을 따로 관리합니다.
워크스페이스 선택창 빠르게
선택창을 열 때 SSH 재연결을 하지 않고 기존 연결을 재사용하도록 변경했습니다. 이전 검색 결과는 캐시에 저장돼 두 번째 진입부터 즉시 표시되며, 백그라운드에서 조용히 갱신됩니다. 우상단 새로고침 버튼으로 강제 갱신할 수 있습니다.
메시지 전체 드래그 선택 지원
어시스턴트 응답을 길게 눌러 드래그 핸들로 메시지 전체에 걸쳐 자유롭게 선택하고 복사할 수 있습니다. 코드 블록은 모노스페이스 폰트와 회색 배경으로 강조됩니다.
대화창 진입 시 자동 스크롤
호스트를 눌러 대화창을 열 때 기존 대화가 있으면 자동으로 가장 최근 메시지가 보이는 위치로 이동합니다.
0.1.2 4月28日
v0.1.0 — Mac 지원 추가
• Mac에서 ClaudeShell 사용 가능 (유니버설 앱)
• 호스트 삭제 버튼 추가 — 원클릭 삭제
• Mac 전용 단축키: Cmd+N (새 세션), Cmd+Shift+N (호스트 추가), Cmd+, (설정)
• 메뉴바/창 크기 등 Mac UX 개선
• 안정성 개선 및 버그 수정
같은 계정으로 iPhone/iPad/Mac 어디서나 사용하세요.
GitHub Release Notes
## v0.1.0 — Mac Catalyst 지원
### 신규 기능
**유니버설 앱 전환**
- iOS/iPadOS/macOS 모두 지원하는 단일 바이너리
- 같은 Apple ID로 모든 플랫폼에서 사용
- 홈 Mac을 서버로, 외부 Mac을 클라이언트로 쓰는 워크플로 지원
**Mac 전용 UX**
- 기본 창 크기 1280×860, 최소 900×640
- 메뉴바: "ClaudeShell 정보", Help → GitHub 링크
- 키보드 단축키
- Cmd+N — 새 세션
- Cmd+Shift+N — 호스트 추가
- Cmd+, — 설정
**호스트 관리 개선**
- 호스트 이름 옆 삭제 버튼으로 즉시 삭제 (iOS에도 적용)
- Mac Catalyst에서 swipe-to-delete 발견 어려움 해결
### 버그 수정
**Mac Catalyst Keychain 이슈** — 비밀번호 저장/로드 실패
- keychain-access-groups 엔타이틀먼트 추가
- Data Protection Keychain 명시적 사용
- errSecMissingEntitlement (-34018) 해결
### 알려진 제한
- Mac App Store 제출은 다음 버전에서 (샌드박스 작업 필요)
- WKWebView 시스템 로그(WebContent 관련) — 기능 영향 없는 노이즈
0.1.0 4月23日
iPad 완벽 지원
- NavigationSplitView 기반 iPad 전용 레이아웃
- 화면 크기에 따라 Split View / Tab View 자동 전환
- iPad 멀티태스킹 전체 지원
새로운 기능
- 요청 중지 버튼 — 긴 작업 도중에도 취소 가능
- 세션 영속화 — 앱 재시작해도 세션 목록 유지
- 채팅 기록 자동 저장 — 세션별 대화 내용 보존
- 응답 소요 시간 표시
- localhost URL 감지 → Safari 바로 열기
UX 개선
- 대화창 탭하면 키보드 내려감
- 키보드 올라올 때 최신 메시지로 자동 스크롤
- 엔터 = 줄바꿈, 전송은 버튼으로
- Ask / Plan / Auto 3단계 권한 모드
버그 수정
- iPad 세션 삭제 시 발생하던 크래시 해결
- 워크스페이스 전환 버그 수정
- 마크다운 렌더링 안정성 개선
0.0.3 4月21日
• Claude Code Desktop 2.0 기능 모바일 적용
- 멀티세션 지원
- Permission Mode (Ask/Auto/Plan) 전환
- Plan UI (단계별 계획 표시)
• Ask 모드: 승인 요청 채팅 버블 + 탭 응답
• 마크다운 렌더링 가독성 개선
• localhost URL 감지 시 Safari 열기 버튼
• 상태 뱃지/스크롤 떨림 등 UI 버그 수정
• 성능 최적화
0.0.2 4月17日
[연결·사용성]
- 놓친 응답 자동 복구 — 폰 잠금·네트워크 전환으로 연결이 끊겨도, 세션에
다시 들어가면 그 사이 완료된 응답을 자동으로 이어받아 표시 (답을 잃지 않음)
- 자동 재연결 — 화면을 다시 켜거나 네트워크가 바뀌면 끊긴 연결을 스스로 복구
(수동 재연결 불필요)
- SSH 키 인증 — 비밀번호 대신 SSH 키로 안전하게 연결
(기존 비밀번호 방식도 그대로 지원)
- 연결 상태 표시 — 연결이 안 될 때 원인(네트워크·Mac·인증)을 구분해 안내
- 완료 알림 바로 열기 — 작업 완료 푸시를 누르면 해당 세션으로 곧장 진입
- 세션 관리 개선 — 세션 이름 변경, 삭제 전 확인, 권한 모드 세션별 기억
[보안]
- 접속 토큰 보관 방식 개선 — 데몬 접속 토큰을 기기 키체인에 안전하게 저장.
기존 토큰은 앱을 처음 열 때 자동으로 옮겨지며, 다시 입력할 필요 없음
- 네트워크 보안 정책 강화 — 앱이 평문으로 통신할 수 있는 범위를
홈 네트워크와 Tailscale 주소로 제한
- Claude 인증 정보 복사 기본 꺼짐 — 호스트 설정에서 이 옵션이 이제 기본으로
꺼져 있으며, 켤 때 인증 정보가 대상 기기에 파일로 복사된다는 안내가 표시됨
- 내장 데몬 갱신 — 최신 버전으로 업데이트하고, 접속 허용 범위와
실행 옵션 검증을 강화
[변경 안내]
- Tailscale에 IP 주소(100.x.x.x)를 직접 입력해 연결하던 경우, MagicDNS
호스트 이름(예: mymac.tail-xxxx.ts.net)으로 바꿔 입력해 주세요.
홈 네트워크 주소(192.168.x.x 등)는 그대로 사용할 수 있습니다.
更多 版本1.2.2 7月31日
不收集資料 開發者不會從此 App 收集任何資料。