@siteboon/claude-code-ui 1.25.2 → 1.26.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (43) hide show
  1. package/README.de.md +239 -0
  2. package/README.ja.md +115 -230
  3. package/README.ko.md +116 -231
  4. package/README.md +2 -1
  5. package/README.ru.md +75 -54
  6. package/README.zh-CN.md +121 -238
  7. package/dist/assets/index-BenyXiE2.css +32 -0
  8. package/dist/assets/{index-DF_FFT3b.js → index-dyw-e9VE.js} +249 -237
  9. package/dist/index.html +2 -2
  10. package/dist/sw.js +102 -27
  11. package/package.json +3 -2
  12. package/server/claude-sdk.js +106 -62
  13. package/server/cli.js +10 -7
  14. package/server/cursor-cli.js +59 -73
  15. package/server/database/db.js +142 -1
  16. package/server/database/init.sql +28 -1
  17. package/server/gemini-cli.js +46 -48
  18. package/server/gemini-response-handler.js +12 -73
  19. package/server/index.js +82 -55
  20. package/server/middleware/auth.js +2 -2
  21. package/server/openai-codex.js +43 -28
  22. package/server/projects.js +1 -1
  23. package/server/providers/claude/adapter.js +278 -0
  24. package/server/providers/codex/adapter.js +248 -0
  25. package/server/providers/cursor/adapter.js +353 -0
  26. package/server/providers/gemini/adapter.js +186 -0
  27. package/server/providers/registry.js +44 -0
  28. package/server/providers/types.js +119 -0
  29. package/server/providers/utils.js +29 -0
  30. package/server/routes/agent.js +7 -5
  31. package/server/routes/cli-auth.js +38 -0
  32. package/server/routes/codex.js +1 -19
  33. package/server/routes/gemini.js +0 -30
  34. package/server/routes/git.js +48 -20
  35. package/server/routes/messages.js +61 -0
  36. package/server/routes/plugins.js +5 -1
  37. package/server/routes/settings.js +99 -1
  38. package/server/routes/taskmaster.js +2 -2
  39. package/server/services/notification-orchestrator.js +227 -0
  40. package/server/services/vapid-keys.js +35 -0
  41. package/server/utils/plugin-loader.js +53 -4
  42. package/shared/networkHosts.js +22 -0
  43. package/dist/assets/index-WNTmA_ug.css +0 -32
package/README.ko.md CHANGED
@@ -1,12 +1,23 @@
1
1
  <div align="center">
2
- <img src="public/logo.svg" alt="Claude Code UI" width="64" height="64">
2
+ <img src="public/logo.svg" alt="CloudCLI UI" width="64" height="64">
3
3
  <h1>Cloud CLI (일명 Claude Code UI)</h1>
4
+ <p><a href="https://docs.anthropic.com/en/docs/claude-code">Claude Code</a>, <a href="https://docs.cursor.com/en/cli/overview">Cursor CLI</a>, <a href="https://developers.openai.com/codex">Codex</a>, <a href="https://geminicli.com/">Gemini-CLI</a> 용 데스크톱 및 모바일 UI입니다.<br>로컬 또는 원격에서 실행하여 어디서나 활성 프로젝트와 세션을 확인하세요.</p>
4
5
  </div>
5
6
 
7
+ <p align="center">
8
+ <a href="https://cloudcli.ai">CloudCLI Cloud</a> · <a href="https://cloudcli.ai/docs">문서</a> · <a href="https://discord.gg/buxwujPNRE">Discord</a> · <a href="https://github.com/siteboon/claudecodeui/issues">버그 신고</a> · <a href="CONTRIBUTING.md">기여 안내</a>
9
+ </p>
6
10
 
7
- [Claude Code](https://docs.anthropic.com/en/docs/claude-code), [Cursor CLI](https://docs.cursor.com/en/cli/overview) 및 [Codex](https://developers.openai.com/codex)를 위한 데스크톱 및 모바일 UI입니다. 로컬 또는 원격으로 사용하여 Claude Code, Cursor 또는 Codex의 활성 프로젝트와 세션을 확인하고, 어디서든(모바일 또는 데스크톱) 변경할 수 있습니다. 어디서든 작동하는 적절한 인터페이스를 제공합니다.
11
+ <p align="center">
12
+ <a href="https://cloudcli.ai"><img src="https://img.shields.io/badge/☁️_CloudCLI_Cloud-Try_Now-0066FF?style=for-the-badge" alt="CloudCLI Cloud"></a>
13
+ <a href="https://discord.gg/buxwujPNRE"><img src="https://img.shields.io/badge/Discord-Join%20Community-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord 커뮤니티"></a>
14
+ <br><br>
15
+ <a href="https://trendshift.io/repositories/15586" target="_blank"><img src="https://trendshift.io/api/badge/repositories/15586" alt="siteboon%2Fclaudecodeui | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
16
+ </p>
8
17
 
9
- <div align="right"><i><a href="./README.md">English</a> · <a href="./README.ru.md">Русский</a> · <b>한국어</b> · <a href="./README.zh-CN.md">中文</a> · <a href="./README.ja.md">日本語</a></i></div>
18
+ <div align="right"><i><a href="./README.md">English</a> · <a href="./README.ru.md">Русский</a> · <a href="./README.de.md">Deutsch</a> · <b>한국어</b> · <a href="./README.zh-CN.md">中文</a> · <a href="./README.ja.md">日本語</a></i></div>
19
+
20
+ ---
10
21
 
11
22
  ## 스크린샷
12
23
 
@@ -15,14 +26,14 @@
15
26
  <table>
16
27
  <tr>
17
28
  <td align="center">
18
- <h3>데스크톱 뷰</h3>
19
- <img src="public/screenshots/desktop-main.png" alt="Desktop Interface" width="400">
29
+ <h3>데스크톱 보기</h3>
30
+ <img src="public/screenshots/desktop-main.png" alt="데스크톱 인터페이스" width="400">
20
31
  <br>
21
32
  <em>프로젝트 개요와 채팅을 보여주는 메인 인터페이스</em>
22
33
  </td>
23
34
  <td align="center">
24
35
  <h3>모바일 경험</h3>
25
- <img src="public/screenshots/mobile-chat.png" alt="Mobile Interface" width="250">
36
+ <img src="public/screenshots/mobile-chat.png" alt="모바일 인터페이스" width="250">
26
37
  <br>
27
38
  <em>터치 내비게이션이 포함된 반응형 모바일 디자인</em>
28
39
  </td>
@@ -30,316 +41,190 @@
30
41
  <tr>
31
42
  <td align="center" colspan="2">
32
43
  <h3>CLI 선택</h3>
33
- <img src="public/screenshots/cli-selection.png" alt="CLI Selection" width="400">
44
+ <img src="public/screenshots/cli-selection.png" alt="CLI 선택" width="400">
34
45
  <br>
35
- <em>Claude Code, Cursor CLI, Codex 중 선택</em>
46
+ <em>Claude Code, Gemini, Cursor CLI Codex 중 선택</em>
36
47
  </td>
37
48
  </tr>
38
49
  </table>
39
50
 
40
-
41
-
42
51
  </div>
43
52
 
44
53
  ## 기능
45
54
 
46
- - **반응형 디자인** - 데스크톱, 태블릿, 모바일에서 원활하게 작동하여 모바일에서도 Claude Code, Cursor 또는 Codex를 사용할 수 있습니다
47
- - **대화형 채팅 인터페이스** - Claude Code, Cursor 또는 Codex와 원활하게 소통하는 내장 채팅 인터페이스
48
- - **통합 셸 터미널** - 내장 셸 기능을 통한 Claude Code, Cursor CLI 또는 Codex 직접 접근
49
- - **파일 탐색기** - 구문 강조 및 실시간 편집이 가능한 대화형 파일 트리
50
- - **Git 탐색기** - 변경사항 보기, 스테이징 및 커밋. 브랜치 전환도 가능
51
- - **세션 관리** - 대화 재개, 여러 세션 관리 기록 추적
52
- - **TaskMaster AI 통합** *(선택사항)* - AI 기반 작업 계획, PRD 분석 워크플로우 자동화를 통한 고급 프로젝트 관리
53
- - **모델 호환성** - Claude Sonnet 4.5, Opus 4.5 GPT-5.2 지원
54
-
55
+ - **반응형 디자인** - 데스크톱, 태블릿, 모바일을 아우르는 매끄러운 경험으로 어디서든 Agents를 사용할 수 있습니다
56
+ - **대화형 채팅 인터페이스** - 내장된 채팅 UI를 통해 에이전트와 자연스럽게 소통
57
+ - **통합 셸 터미널** - 셸 기능을 통해 Agents CLI 직접 접근
58
+ - **파일 탐색기** - 구문 강조 및 실시간 편집을 갖춘 인터랙티브 파일 트리
59
+ - **Git 탐색기** - 변경 사항 보기, 스테이징 및 커밋. 브랜치 전환 기능 포함
60
+ - **세션 관리** - 대화를 재개하고, 여러 세션을 관리하며 기록을 추적
61
+ - **플러그인 시스템** - 커스텀 탭, 백엔드 서비스, 통합을 추가하여 CloudCLI 확장. [직접 빌드 →](https://github.com/cloudcli-ai/cloudcli-plugin-starter)
62
+ - **TaskMaster AI 통합** *(선택사항)* - AI 중심의 작업 계획, PRD 파싱, 워크플로 자동화를 통한 고급 프로젝트 관리
63
+ - **모델 호환성** - Claude, GPT, Gemini 모델 계열에서 작동 (`shared/modelConstants.js`에서 전체 지원 모델 확인)
55
64
 
56
65
  ## 빠른 시작
57
66
 
58
- ### 사전 요구사항
67
+ ### CloudCLI Cloud (추천)
59
68
 
60
- - [Node.js](https://nodejs.org/) v22 이상
61
- - [Claude Code CLI](https://docs.anthropic.com/en/docs/claude-code) 설치 및 구성, 그리고/또는
62
- - [Cursor CLI](https://docs.cursor.com/en/cli/overview) 설치 및 구성, 그리고/또는
63
- - [Codex](https://developers.openai.com/codex) 설치 및 구성
69
+ 가장 빠르게 시작하는 방법 — 로컬 설정 없이도 가능합니다. 웹, 모바일 앱, API 또는 선호하는 IDE에서 이용할 수 있는 완전 관리형 컨테이너화된 개발 환경을 제공합니다.
64
70
 
65
- ### 원클릭 실행 (권장)
71
+ **[CloudCLI Cloud 시작하기](https://cloudcli.ai)**
66
72
 
67
- 설치 없이 바로 실행:
73
+ ### 셀프 호스트 (오픈 소스)
74
+
75
+ **npx**로 즉시 CloudCLI UI를 실행하세요 (Node.js v22+ 필요):
68
76
 
69
77
  ```bash
70
78
  npx @siteboon/claude-code-ui
71
79
  ```
72
80
 
73
- 서버가 시작되면 `http://localhost:3001` (또는 설정한 PORT)에서 접근할 수 있습니다.
74
-
75
- **재시작**: 서버를 중지한 후 동일한 `npx` 명령을 다시 실행하면 됩니다
76
- ### 전역 설치 (정기적 사용 시)
77
-
78
- 자주 사용하는 경우 한 번만 전역 설치:
81
+ **정기적으로 사용한다면 전역 설치:**
79
82
 
80
83
  ```bash
81
84
  npm install -g @siteboon/claude-code-ui
85
+ cloudcli
82
86
  ```
83
87
 
84
- 간단한 명령으로 시작:
85
-
86
- ```bash
87
- claude-code-ui
88
- ```
89
-
90
-
91
- **재시작**: Ctrl+C로 중지한 후 `claude-code-ui`를 다시 실행합니다.
92
-
93
- **업데이트**:
94
- ```bash
95
- cloudcli update
96
- ```
97
-
98
- ### CLI 사용법
99
-
100
- 전역 설치 후 `claude-code-ui`와 `cloudcli` 명령을 사용할 수 있습니다:
101
-
102
- | 명령 / 옵션 | 약어 | 설명 |
103
- |------------------|-------|-------------|
104
- | `cloudcli` 또는 `claude-code-ui` | | 서버 시작 (기본값) |
105
- | `cloudcli start` | | 서버 명시적 시작 |
106
- | `cloudcli status` | | 구성 및 데이터 위치 표시 |
107
- | `cloudcli update` | | 최신 버전으로 업데이트 |
108
- | `cloudcli help` | | 도움말 정보 표시 |
109
- | `cloudcli version` | | 버전 정보 표시 |
110
- | `--port <port>` | `-p` | 서버 포트 설정 (기본값: 3001) |
111
- | `--database-path <path>` | | 사용자 지정 데이터베이스 위치 설정 |
112
-
113
- **예시:**
114
- ```bash
115
- cloudcli # 기본 설정으로 시작
116
- cloudcli -p 8080 # 사용자 지정 포트로 시작
117
- cloudcli status # 현재 구성 표시
118
- ```
119
-
120
- ### 백그라운드 서비스로 실행 (프로덕션 권장)
121
-
122
- 프로덕션 환경에서는 PM2(Process Manager 2)를 사용하여 Claude Code UI를 백그라운드 서비스로 실행하세요:
123
-
124
- #### PM2 설치
125
-
126
- ```bash
127
- npm install -g pm2
128
- ```
129
-
130
- #### 백그라운드 서비스로 시작
131
-
132
- ```bash
133
- # 백그라운드에서 서버 시작
134
- pm2 start claude-code-ui --name "claude-code-ui"
135
-
136
- # 또는 짧은 별칭 사용
137
- pm2 start cloudcli --name "claude-code-ui"
138
-
139
- # 사용자 지정 포트로 시작
140
- pm2 start cloudcli --name "claude-code-ui" -- --port 8080
141
- ```
142
-
143
-
144
- #### 시스템 부팅 시 자동 시작
145
-
146
- 시스템 부팅 시 Claude Code UI를 자동으로 시작하려면:
147
-
148
- ```bash
149
- # 플랫폼에 맞는 시작 스크립트 생성
150
- pm2 startup
151
-
152
- # 현재 프로세스 목록 저장
153
- pm2 save
154
- ```
155
-
88
+ `http://localhost:3001`을 열면 기존 세션이 자동으로 발견됩니다.
156
89
 
157
- ### 로컬 개발 설치
90
+ 자세한 구성 옵션, PM2, 원격 서버 설정 등은 **[문서 →](https://cloudcli.ai/docs)**를 참고하세요
158
91
 
159
- 1. **리포지토리 클론:**
160
- ```bash
161
- git clone https://github.com/siteboon/claudecodeui.git
162
- cd claudecodeui
163
- ```
164
-
165
- 2. **의존성 설치:**
166
- ```bash
167
- npm install
168
- ```
169
-
170
- 3. **환경 구성:**
171
- ```bash
172
- cp .env.example .env
173
- # 원하는 설정으로 .env 파일 편집
174
- ```
175
-
176
- 4. **애플리케이션 시작:**
177
- ```bash
178
- # 개발 모드 (핫 리로드 포함)
179
- npm run dev
92
+ ---
180
93
 
181
- ```
182
- 애플리케이션은 .env에서 지정한 포트에서 시작됩니다
94
+ ## 어느 옵션이 적합한가요?
95
+
96
+ CloudCLI UI는 CloudCLI Cloud를 구동하는 오픈 소스 UI 계층입니다. 로컬 머신에서 직접 셀프 호스트하거나, CloudCLI Cloud(완전 관리형 클라우드 환경, 팀 기능, 심화 통합 제공)를 사용할 수 있습니다.
97
+
98
+ | | CloudCLI UI (셀프 호스트) | CloudCLI Cloud |
99
+ |---|---|---|
100
+ | **적합한 대상** | 로컬 에이전트 세션을 위한 전체 UI가 필요한 개발자 | 어디서든 접근 가능한 클라우드에서 에이전트를 운영하고자 하는 팀 및 개발자 |
101
+ | **접근 방법** | `[yourip]:port`를 통해 브라우저 접속 | 브라우저, IDE, REST API, n8n |
102
+ | **설정** | `npx @siteboon/claude-code-ui` | 설정 불필요 |
103
+ | **기기 유지 필요 여부** | 예 (머신 켜둬야 함) | 아니오 |
104
+ | **모바일 접근** | 네트워크 내 브라우저 | 모든 기기 (네이티브 앱 예정) |
105
+ | **세션 접근** | `~/.claude`에서 자동 발견 | 클라우드 환경 내 세션 |
106
+ | **지원 에이전트** | Claude Code, Cursor CLI, Codex, Gemini CLI | Claude Code, Cursor CLI, Codex, Gemini CLI |
107
+ | **파일 탐색기 및 Git** | UI에 통합됨 | UI에 통합됨 |
108
+ | **MCP 구성** | UI에서 관리, 로컬 `~/.claude` 설정과 동기화됨 | UI에서 관리 |
109
+ | **IDE 접근** | 로컬 IDE | 클라우드 환경에 연결된 모든 IDE |
110
+ | **REST API** | 예 | 예 |
111
+ | **n8n 노드** | 아니오 | 예 |
112
+ | **팀 공유** | 아니오 | 예 |
113
+ | **플랫폼 비용** | 무료, 오픈 소스 | 월 $7부터 |
114
+
115
+ > 둘 다 자체 AI 구독(Claude, Cursor 등)을 그대로 사용합니다 — CloudCLI는 환경만 제공합니다.
183
116
 
184
- 5. **브라우저 열기:**
185
- - 개발: `http://localhost:3001`
117
+ ---
186
118
 
187
- ## 보안 및 도구 설정
119
+ ## 보안 및 도구 구성
188
120
 
189
- **🔒 중요 공지**: 모든 Claude Code 도구는 **기본적으로 비활성화**되어 있습니다. 이는 잠재적으로 유해한 작업이 자동으로 실행되는 것을 방지합니다.
121
+ **🔒 중요 공지**: 모든 Claude Code 도구는 **기본적으로 비활성화**되어 있습니다. 이는 잠재적인 유해 작업이 자동 실행되는 것을 방지하기 위한 조치입니다.
190
122
 
191
123
  ### 도구 활성화
192
124
 
193
- Claude Code의 전체 기능을 사용하려면 수동으로 도구를 활성화해야 합니다:
194
-
195
- 1. **도구 설정 열기** - 사이드바의 톱니바퀴 아이콘을 클릭
196
- 2. **선택적으로 활성화** - 필요한 도구만 활성화
197
- 3. **설정 적용** - 환경설정은 로컬에 저장됩니다
125
+ 1. **도구 설정 열기** - 사이드바의 톱니바퀴 아이콘 클릭
126
+ 2. **선택적으로 활성화** - 필요한 도구만 켜기
127
+ 3. **설정 적용** - 선호도는 로컬에 저장됨
198
128
 
199
129
  <div align="center">
200
130
 
201
131
  ![도구 설정 모달](public/screenshots/tools-modal.png)
202
- *도구 설정 인터페이스 - 필요한 것만 활성화하세요*
132
+ *도구 설정 인터페이스 - 필요한 것만 켜세요*
203
133
 
204
134
  </div>
205
135
 
206
- **권장 접근법**: 기본 도구부터 활성화하고 필요에 따라 추가하세요. 언제든지 설정을 조정할 수 있습니다.
207
-
208
- ## TaskMaster AI 통합 *(선택사항)*
209
-
210
- Claude Code UI는 고급 프로젝트 관리 및 AI 기반 작업 계획을 위한 **[TaskMaster AI](https://github.com/eyaltoledano/claude-task-master)**(일명 claude-task-master) 통합을 지원합니다.
136
+ **권장 방법**: 기본 도구를 먼저 켜고 필요할 추가하세요. 언제든지 조정 가능합니다.
211
137
 
212
- 제공 기능
213
- - PRD(제품 요구사항 문서)에서 AI 기반 작업 생성
214
- - 스마트 작업 분해 및 의존성 관리
215
- - 시각적 작업 보드 및 진행 상황 추적
216
-
217
- **설정 및 문서**: 설치 지침, 구성 가이드 및 사용 예시는 [TaskMaster AI GitHub 리포지토리](https://github.com/eyaltoledano/claude-task-master)를 방문하세요.
218
- 설치 후 설정에서 활성화할 수 있습니다
138
+ ---
219
139
 
140
+ ## 플러그인
220
141
 
221
- ## 사용 가이드
142
+ CloudCLI는 커스텀 탭과 선택적 Node.js 백엔드가 포함된 플러그인 시스템을 제공합니다. Settings > Plugins에서 Git 저장소에서 플러그인을 설치하거나 직접 빌드할 수 있습니다.
222
143
 
223
- ### 핵심 기능
144
+ ### 이용 가능한 플러그인
224
145
 
225
- #### 프로젝트 관리
226
- Claude Code, Cursor 또는 Codex 세션을 사용할 수 있을 때 자동으로 발견하고 프로젝트로 그룹화합니다
227
- - **프로젝트 작업** - 프로젝트 이름 변경, 삭제 정리
228
- - **스마트 내비게이션** - 최근 프로젝트 및 세션에 빠르게 접근
229
- - **MCP 지원** - UI를 통해 자체 MCP 서버 추가
146
+ | 플러그인 | 설명 |
147
+ |---|---|
148
+ | **[Project Stats](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** | 현재 프로젝트의 파일 수, 코드 수, 파일 유형 분포, 가장 큰 파일, 최근 수정 파일을 표시 |
230
149
 
231
- #### 채팅 인터페이스
232
- - **반응형 채팅 또는 Claude Code/Cursor CLI/Codex CLI 사용** - 적응형 채팅 인터페이스를 사용하거나 셸 버튼을 사용하여 선택한 CLI에 연결할 수 있습니다
233
- - **실시간 통신** - WebSocket 연결을 통해 선택한 CLI(Claude Code/Cursor/Codex)에서 응답 스트리밍
234
- - **세션 관리** - 이전 대화 재개 또는 새 세션 시작
235
- - **메시지 기록** - 타임스탬프 및 메타데이터가 포함된 전체 대화 기록
236
- - **다중 형식 지원** - 텍스트, 코드 블록 및 파일 참조
150
+ ### 직접 만들기
237
151
 
238
- #### 파일 탐색기 편집기
239
- - **대화형 파일 트리** - 확장/축소 내비게이션으로 프로젝트 구조 탐색
240
- - **실시간 파일 편집** - 인터페이스에서 직접 파일 읽기, 수정 및 저장
241
- - **구문 강조** - 다양한 프로그래밍 언어 지원
242
- - **파일 작업** - 파일 및 디렉토리 생성, 이름 변경, 삭제
152
+ **[Plugin Starter Template →](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** — 이 저장소를 포크하여 플러그인 구축. 프런트엔드 렌더링, 실시간 컨텍스트 업데이트, RPC 통신 예제 포함.
243
153
 
244
- #### Git 탐색기
154
+ **[플러그인 문서 →](https://cloudcli.ai/docs/plugin-overview)** — 플러그인 API, 매니페스트 포맷, 보안 모델 등을 설명.
245
155
 
156
+ ---
246
157
 
247
- #### TaskMaster AI 통합 *(선택사항)*
248
- - **시각적 작업 보드** - 개발 작업 관리를 위한 칸반 스타일 인터페이스
249
- - **PRD 파서** - 제품 요구사항 문서를 생성하고 구조화된 작업으로 변환
250
- - **진행 상황 추적** - 실시간 상태 업데이트 및 완료 추적
158
+ ## FAQ
251
159
 
252
- #### 세션 관리
253
- - **세션 지속성** - 모든 대화 자동 저장
254
- - **세션 정리** - 프로젝트 및 타임스탬프별 세션 그룹화
255
- - **세션 작업** - 대화 기록 이름 변경, 삭제 및 내보내기
256
- - **크로스 디바이스 동기화** - 모든 기기에서 세션 접근
160
+ <details>
161
+ <summary>Claude Code Remote Control과 어떻게 다른가요?</summary>
257
162
 
258
- ### 모바일
259
- - **반응형 디자인** - 모든 화면 크기에 최적화
260
- - **터치 친화적 인터페이스** - 스와이프 제스처 및 터치 내비게이션
261
- - **모바일 내비게이션** - 엄지 내비게이션을 위한 하단 탭 바
262
- - **적응형 레이아웃** - 접을 수 있는 사이드바 및 스마트 콘텐츠 우선순위
263
- - **홈 화면 바로가기 추가** - 홈 화면에 바로가기를 추가하면 앱이 PWA처럼 작동합니다
163
+ Claude Code Remote Control은 이미 로컬 터미널에서 실행 중인 세션으로 메시지를 전송합니다. 이 경우 기계가 켜져 있어야 하고 터미널을 열어 둬야 하며, 네트워크 연결 없이 약 10분 후 타임아웃됩니다.
264
164
 
265
- ## 아키텍처
165
+ CloudCLI UI와 CloudCLI Cloud는 Claude Code를 확장하며 별도로 존재하지 않습니다 — MCP 서버, 권한, 설정, 세션은 Claude Code에서 그대로 사용됩니다.
266
166
 
267
- ### 시스템 개요
167
+ - **모든 세션을 다룬다** — CloudCLI UI는 `~/.claude` 폴더에서 모든 세션을 자동 발견합니다. Remote Control은 단일 활성 세션만 노출합니다.
168
+ - **설정은 그대로** — CloudCLI UI에서 변경한 MCP, 도구 권한, 프로젝트 설정은 Claude Code에 즉시 반영됩니다.
169
+ - **지원 에이전트가 더 많음** — Claude Code, Cursor CLI, Codex, Gemini CLI 지원.
170
+ - **전체 UI 제공** — 단일 채팅 창이 아닌 파일 탐색기, Git 통합, MCP 관리 및 셸 터미널 포함.
171
+ - **CloudCLI Cloud는 클라우드에서 실행** — 노트북을 닫아도 에이전트가 실행됩니다. 터미널을 계속 확인할 필요 없음.
268
172
 
269
- ```
270
- ┌─────────────────┐ ┌─────────────────┐ ┌─────────────────┐
271
- │ Frontend │ │ Backend │ │ Agent │
272
- │ (React/Vite) │◄──►│ (Express/WS) │◄──►│ Integration │
273
- │ │ │ │ │ │
274
- └─────────────────┘ └─────────────────┘ └─────────────────┘
275
- ```
173
+ </details>
276
174
 
277
- ### 백엔드 (Node.js + Express)
278
- - **Express 서버** - 정적 파일 제공이 포함된 RESTful API
279
- - **WebSocket 서버** - 채팅 및 프로젝트 새로고침을 위한 통신
280
- - **에이전트 통합 (Claude Code / Cursor CLI / Codex)** - 프로세스 생성 및 관리
281
- - **파일 시스템 API** - 프로젝트를 위한 파일 브라우저 노출
175
+ <details>
176
+ <summary>AI 구독을 별도로 결제해야 하나요?</summary>
282
177
 
283
- ### 프론트엔드 (React + Vite)
284
- - **React 18** - hooks를 사용한 현대적 컴포넌트 아키텍처
285
- - **CodeMirror** - 구문 강조를 지원하는 고급 코드 편집기
178
+ 네. CloudCLI는 환경만 제공합니다. Claude, Cursor, Codex, Gemini 구독 비용은 별도로 부과됩니다. CloudCLI Cloud는 관리형 환경을 월 $7부터 제공합니다.
286
179
 
180
+ </details>
287
181
 
182
+ <details>
183
+ <summary>CloudCLI UI를 휴대폰에서 사용할 수 있나요?</summary>
288
184
 
289
- ### 기여하기
185
+ 네. 셀프 호스트인 경우 기계에서 서버를 실행하고 네트워크의 아무 브라우저에서 `[yourip]:port`를 열면 됩니다. CloudCLI Cloud는 어떤 기기에서도 열 수 있으며, 네이티브 앱도 준비 중입니다.
290
186
 
291
- 기여를 환영합니다! 커밋 규칙, 개발 워크플로우, 릴리스 프로세스에 대한 자세한 내용은 [Contributing Guide](CONTRIBUTING.md)를 참조해주세요.
187
+ </details>
292
188
 
293
- ## 문제 해결
189
+ <details>
190
+ <summary>UI에서 변경하면 로컬 Claude Code 설정에 영향을 주나요?</summary>
294
191
 
295
- ### 일반적인 문제 해결 방법
192
+ 네, 셀프 호스트에서는 그렇습니다. CloudCLI UI는 Claude Code가 사용하는 동일한 `~/.claude` 설정을 읽고 씁니다. UI에서 추가한 MCP 서버가 Claude Code에 즉시 나타납니다.
296
193
 
194
+ </details>
297
195
 
298
- #### "Claude 프로젝트를 찾을 수 없음"
299
- **문제**: UI에 프로젝트가 없거나 프로젝트 목록이 비어 있음
300
- **해결 방법**:
301
- - [Claude Code](https://docs.anthropic.com/en/docs/claude-code)가 올바르게 설치되었는지 확인
302
- - 초기화를 위해 최소 하나의 프로젝트 디렉토리에서 `claude` 명령 실행
303
- - `~/.claude/projects/` 디렉토리가 존재하고 적절한 권한이 있는지 확인
196
+ ---
304
197
 
305
- #### 파일 탐색기 문제
306
- **문제**: 파일이 로드되지 않음, 권한 오류, 빈 디렉토리
307
- **해결 방법**:
308
- - 프로젝트 디렉토리 권한 확인 (터미널에서 `ls -la`)
309
- - 프로젝트 경로가 존재하고 접근 가능한지 확인
310
- - 자세한 오류 메시지는 서버 콘솔 로그 검토
311
- - 프로젝트 범위 밖의 시스템 디렉토리에 접근하지 않는지 확인
198
+ ## 커뮤니티 지원
312
199
 
200
+ - **[문서](https://cloudcli.ai/docs)** — 설치, 구성, 기능, 문제 해결 안내
201
+ - **[Discord](https://discord.gg/buxwujPNRE)** — 도움 및 커뮤니티 참여
202
+ - **[GitHub Issues](https://github.com/siteboon/claudecodeui/issues)** — 버그 보고 및 기능 요청
203
+ - **[기여 안내](CONTRIBUTING.md)** — 프로젝트 참여 방법
313
204
 
314
205
  ## 라이선스
315
206
 
316
- GNU General Public License v3.0 - 자세한 내용은 [LICENSE](LICENSE) 파일을 참조하세요.
207
+ GNU General Public License v3.0 - 자세한 내용은 [LICENSE](LICENSE) 파일 참조.
317
208
 
318
- 이 프로젝트는 오픈 소스이며 GPL v3 라이선스에 따라 자유롭게 사용, 수정 배포할 수 있습니다.
209
+ 이 프로젝트는 GPL v3 라이선스 하에 오픈 소스로 공개되어 있으며 자유롭게 사용, 수정, 배포할 수 있습니다.
319
210
 
320
211
  ## 감사의 말
321
212
 
322
213
  ### 사용 기술
323
- - **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** - Anthropic 공식 CLI
324
- - **[Cursor CLI](https://docs.cursor.com/en/cli/overview)** - Cursor 공식 CLI
214
+ - **[Claude Code](https://docs.anthropic.com/en/docs/claude-code)** - Anthropic 공식 CLI
215
+ - **[Cursor CLI](https://docs.cursor.com/en/cli/overview)** - Cursor 공식 CLI
325
216
  - **[Codex](https://developers.openai.com/codex)** - OpenAI Codex
217
+ - **[Gemini-CLI](https://geminicli.com/)** - Google Gemini CLI
326
218
  - **[React](https://react.dev/)** - 사용자 인터페이스 라이브러리
327
219
  - **[Vite](https://vitejs.dev/)** - 빠른 빌드 도구 및 개발 서버
328
220
  - **[Tailwind CSS](https://tailwindcss.com/)** - 유틸리티 우선 CSS 프레임워크
329
- - **[CodeMirror](https://codemirror.net/)** - 고급 코드 편집기
221
+ - **[CodeMirror](https://codemirror.net/)** - 고급 코드 에디터
330
222
  - **[TaskMaster AI](https://github.com/eyaltoledano/claude-task-master)** *(선택사항)* - AI 기반 프로젝트 관리 및 작업 계획
331
223
 
332
- ## 지원 및 커뮤니티
333
-
334
- ### 최신 정보 받기
335
- - 이 리포지토리에 **Star**를 눌러 지지를 표시하세요
336
- - **Watch**로 업데이트 및 새 릴리스를 확인하세요
337
- - 프로젝트를 **Follow**하여 공지사항을 받으세요
338
-
339
224
  ### 스폰서
340
225
  - [Siteboon - AI powered website builder](https://siteboon.ai)
341
226
  ---
342
227
 
343
228
  <div align="center">
344
- <strong>Claude Code, Cursor Codex 커뮤니티를 위해 정성껏 만들었습니다.</strong>
229
+ <strong>Claude Code, Cursor, Codex 커뮤니티를 위해 정성껏 제작되었습니다.</strong>
345
230
  </div>
package/README.md CHANGED
@@ -15,7 +15,7 @@
15
15
  <a href="https://trendshift.io/repositories/15586" target="_blank"><img src="https://trendshift.io/api/badge/repositories/15586" alt="siteboon%2Fclaudecodeui | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/></a>
16
16
  </p>
17
17
 
18
- <div align="right"><i><b>English</b> · <a href="./README.ru.md">Русский</a> · <a href="./README.ko.md">한국어</a> · <a href="./README.zh-CN.md">中文</a> · <a href="./README.ja.md">日本語</a></i></div>
18
+ <div align="right"><i><b>English</b> · <a href="./README.ru.md">Русский</a> · <a href="./README.de.md">Deutsch</a> · <a href="./README.ko.md">한국어</a> · <a href="./README.zh-CN.md">中文</a> · <a href="./README.ja.md">日本語</a></i></div>
19
19
 
20
20
  ---
21
21
 
@@ -153,6 +153,7 @@ CloudCLI has a plugin system that lets you add custom tabs with their own fronte
153
153
  | Plugin | Description |
154
154
  |---|---|
155
155
  | **[Project Stats](https://github.com/cloudcli-ai/cloudcli-plugin-starter)** | Shows file counts, lines of code, file-type breakdown, largest files, and recently modified files for your current project |
156
+ | **[Web Terminal](https://github.com/cloudcli-ai/cloudcli-plugin-terminal)** | Full xterm.js terminal with multi-tab support|
156
157
 
157
158
  ### Build Your Own
158
159