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 18 hr 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 18 hr ago
Data Not Collected The developer does not collect any data from this app.