OpenShell
iPhone에서 Claude·로컬·API 원격 운용
Free · Designed for iPad. Not verified for macOS.
OpenShell — a unified AI client for your iPhone: local LLMs, cloud APIs, and remote coding over SSH, all in one app.
Chat with Ollama, MLX, and LM Studio local models; OpenAI, xAI Grok, and Nous Hermes cloud APIs; or drive Claude Code on a remote Mac over SSH. Pick the backend you want and work in the same app — from quick questions to code reviews, file edits, and builds, straight from your iPhone.
more This update focuses on connection reliability.
- Messages that fail to reach your Mac are now resent automatically
- You can send a new message while a previous response is still being recovered (no more "Another request is in progress")
- Responses interrupted mid-stream are recovered on reconnect, without duplicates
- The error badge clears automatically once the connection is back
- Fixed an issue where every message after the first would fail on Macs with a newer Claude CLI installation
- The connection helper (daemon) now reports errors immediately instead of failing silently
1.2.1 1 day ago
- Automatic response recovery — if your connection drops (screen lock, network switch), reopening the session restores any response that finished while you were away (no lost replies)
- Auto-reconnect — a dropped connection recovers on its own when you wake the screen or switch networks (no manual reconnect)
- SSH key authentication — connect securely with an SSH key instead of a password (password login still supported)
- Connection status badge — when a connection fails, see the cause at a glance (network, Mac, or authentication)
- Tap a completion notification to jump right in — opens the exact session that finished
- Session management — rename sessions, confirm before deleting, and remember permission mode per session
1.2.0 9 Jul
- Full English localization — the entire app UI is now in English (some screens previously showed Korean)
- Task-completion push notifications — get alerted the moment a remote task finishes, even when the app is closed or locked (KR/EN automatic)
- Background daemon installs automatically when you add a new host — no manual setup
- App renamed: ClaudeShell → OpenShell
- Connection guide expanded for local models and external APIs
- Drag-reorderable host list and improved IP display
- VoiceOver accessibility — chat message content now reads correctly
- Clearer Claude authentication and stabilized response status indicator
1.1.0 4 Jun
- 작업 완료 푸시 알림 — 원격 작업이 끝나면 앱이 꺼져 있거나 잠금 상태여도 바로 알림 (한/영 자동)
- 새 호스트 추가 시 백그라운드 데몬 자동 설치 — 수동 셋업 불필요
- 앱 이름 변경: ClaudeShell → OpenShell
- 연결 가이드 보강: 로컬 모델·외부 API 연결 안내
- 호스트 목록 드래그 정렬 및 IP 주소 표시 개선
- Claude 인증 안내 명확화 및 응답 상태 표시 안정화
1.0.8 1 Jun
- 앱 이름 변경: ClaudeShell → OpenShell
- 연결 가이드 보강: 로컬 모델·외부 API 연결 안내 추가
- 호스트 목록 순서 변경(드래그) 및 IP 주소 표시 개선
- Claude 인증 안내 명확화
- 응답 상태 표시 안정화
1.0.7 21 May
- 호스트 이름 수정 시 대화창 우측 상단·사이드바·세션 목록 호스트 이름이 즉시 반영되도록 수정
1.0.6 19 May
- 외부 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 19 May
- 외부 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 19 May
- OpenAI, xAI Grok, Nous Hermes 등 외부 OpenAI 호환 API 직접 연동 지원 — Bearer 인증 API Key 입력
- 앱 재시작 후 외부 API 호스트의 인증 헤더 누락으로 발생하던 401 오류 수정
- Tailscale 호스트(100.x CGNAT 대역) 접속 차단 문제 수정
- 호스트 추가 화면에 로컬 서버·외부 API 기본 주소 및 인증 방법 안내 추가
- 첫 실행 안내(Onboarding)에 OpenAI 호환 backend 페이지 추가
1.0.3 19 May
아이폰에서 Claude Code로 원격 개발하세요. SSH 터미널 + AI 채팅 + 파일 관리.
1.0.2 15 May
- 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 15 May
채팅에 ClaudeShell만의 시그니처를 더했습니다.
Claude가 응답할 때 민트빛 펄스가 잔잔히 흐르고, 메시지를 보내는 순간 입력창 위로 가는 띠 한 줄이 흘러갑니다. 메시지가 좌우에서 자연스럽게 슬라이드해 들어옵니다.
더 부드러워진 스트리밍.
응답 중 글자가 흔들리거나 키보드 뒤로 사라지던 현상을 해결했습니다. 스크롤은 필요한 순간에만 부드럽게 동작합니다.
호스트 추가가 한 번에 끝납니다.
새 호스트를 추가할 때 Claude Daemon을 자동으로 설치하고, 완료되면 바로 채팅창으로 들어갑니다. 비밀번호 없이 접속과 자동 시작 등록까지 한 흐름으로 처리됩니다.
1.0.0 7 May
스트리밍 응답 UX 대폭 개선:
• Bash, Read 등 도구 실행을 채팅에서 실시간 표시 ( Bash 실행 중...)
• 텍스트가 도착하는 대로 화면이 부드럽게 따라감
• 답변 끝까지 자동 스크롤
• 시각적 중복 표시 정리
0.1.3 2 May
워크스페이스별 채팅 분리
한 세션 안에서 워크스페이스를 바꿔도 각 워크스페이스의 대화 기록이 별도로 유지됩니다. 예전에는 워크스페이스를 바꾸면 채팅이 섞여 보였는데, 이제 워크스페이스마다 흐름을 따로 관리합니다.
워크스페이스 선택창 빠르게
선택창을 열 때 SSH 재연결을 하지 않고 기존 연결을 재사용하도록 변경했습니다. 이전 검색 결과는 캐시에 저장돼 두 번째 진입부터 즉시 표시되며, 백그라운드에서 조용히 갱신됩니다. 우상단 새로고침 버튼으로 강제 갱신할 수 있습니다.
메시지 전체 드래그 선택 지원
어시스턴트 응답을 길게 눌러 드래그 핸들로 메시지 전체에 걸쳐 자유롭게 선택하고 복사할 수 있습니다. 코드 블록은 모노스페이스 폰트와 회색 배경으로 강조됩니다.
대화창 진입 시 자동 스크롤
호스트를 눌러 대화창을 열 때 기존 대화가 있으면 자동으로 가장 최근 메시지가 보이는 위치로 이동합니다.
0.1.2 28 Apr
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 23 Apr
iPad 완벽 지원
- NavigationSplitView 기반 iPad 전용 레이아웃
- 화면 크기에 따라 Split View / Tab View 자동 전환
- iPad 멀티태스킹 전체 지원
새로운 기능
- 요청 중지 버튼 — 긴 작업 도중에도 취소 가능
- 세션 영속화 — 앱 재시작해도 세션 목록 유지
- 채팅 기록 자동 저장 — 세션별 대화 내용 보존
- 응답 소요 시간 표시
- localhost URL 감지 → Safari 바로 열기
UX 개선
- 대화창 탭하면 키보드 내려감
- 키보드 올라올 때 최신 메시지로 자동 스크롤
- 엔터 = 줄바꿈, 전송은 버튼으로
- Ask / Plan / Auto 3단계 권한 모드
버그 수정
- iPad 세션 삭제 시 발생하던 크래시 해결
- 워크스페이스 전환 버그 수정
- 마크다운 렌더링 안정성 개선
0.0.3 21 Apr
• Claude Code Desktop 2.0 기능 모바일 적용
- 멀티세션 지원
- Permission Mode (Ask/Auto/Plan) 전환
- Plan UI (단계별 계획 표시)
• Ask 모드: 승인 요청 채팅 버블 + 탭 응답
• 마크다운 렌더링 가독성 개선
• localhost URL 감지 시 Safari 열기 버튼
• 상태 뱃지/스크롤 떨림 등 UI 버그 수정
• 성능 최적화
0.0.2 17 Apr
This update focuses on connection reliability.
- Messages that fail to reach your Mac are now resent automatically
- You can send a new message while a previous response is still being recovered (no more "Another request is in progress")
- Responses interrupted mid-stream are recovered on reconnect, without duplicates
- The error badge clears automatically once the connection is back
- Fixed an issue where every message after the first would fail on Macs with a newer Claude CLI installation
- The connection helper (daemon) now reports errors immediately instead of failing silently
more Version 1.2.1 1 day ago
Data Not Collected The developer does not collect any data from this app.