> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aihubmix.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 설정

> Settings의 모든 항목을 섹션별로 기능, 기본값, 변경 방법과 함께 설명하고, 별도 페이지가 있는 섹션의 위치를 안내합니다.

**Settings** 에는 계정, 알림, 화면 스타일, 연동, 워크스페이스 설정이 모여 있습니다. `⌘,`(Windows: `Ctrl+,`)를 누르거나 계정 메뉴에서 **Settings** 를 클릭해 엽니다. 명령 메뉴 `⇧⌘P`(Windows: `Ctrl+Shift+P`)에서 "Settings"와 섹션 이름을 검색하면 해당 섹션으로 바로 이동합니다. 변경 사항은 즉시 저장됩니다.

> [!NOTE]
>
> 모바일 웹에서는 먼저 카테고리를 선택한 다음 세부 항목을 열며, Keyboard shortcuts 섹션이 없습니다. 웹 앱에는 Keep in the menu bar 항목과 Updates 항목이 없습니다.

## 개인

### 계정, 사용량, 보안

* **Account**: 프로필, Plus, 모델 소스, 결제 내역, 워크스페이스 데이터 삭제입니다. [계정과 보안](https://docs.aihubmix.com/ko/cloud/account/account-and-security.md)을 참고하세요.
* **Usage**: 모델 호출의 토큰과 추정 비용입니다. [Plus 요금제와 사용량](https://docs.aihubmix.com/ko/cloud/account/plus.md)을 참고하세요.
* **Security**: 로그인 방법과 로그아웃입니다. [계정과 보안](https://docs.aihubmix.com/ko/cloud/account/account-and-security.md)을 참고하세요.

### 일반

| 설정 | 기본값 | 설명 |
| - | - | - |
| Default permission on this computer | Full access | 세션이 내 기기에서 실행을 시작할 때 사용하는 권한입니다. Ask for approval, Approve for me, Full access 중 하나입니다. Full access로 전환하려면 확인이 필요합니다. 클라우드 서버의 세션은 항상 Full access를 사용합니다. 입력창에서 세션마다 변경할 수도 있습니다. [세션 시작하기](https://docs.aihubmix.com/ko/cloud/sessions/start-a-session.md)를 참고하세요 |
| Messages sent mid-turn | Queue | 에이전트가 실행 중일 때 보낸 메시지를 처리하는 방식입니다. Queue: 현재 작업이 끝난 후 순서대로 전송됩니다(대기열). Steer: 작업 중인 에이전트에 즉시 전달됩니다(끼어들기). Steer는 Claude Code와 Codex만 지원합니다. 그 외에는 자동으로 Queue로 처리됩니다. [에이전트와 함께 작업하기](https://docs.aihubmix.com/ko/cloud/sessions/work-with-agent.md)를 참고하세요 |
| Language | System | 중국어 간체 또는 영어입니다. 변경 사항은 즉시 적용됩니다. 한 번도 선택하지 않았다면 시스템 언어가 중국어일 때 중국어 간체를, 그 외에는 영어를 사용합니다 |
| Keep in the menu bar | On | 데스크톱 앱 전용입니다(Windows에서는 알림 영역). 켜져 있으면 메인 창을 닫아도 앱이 백그라운드에서 계속 실행되며 평소처럼 알림을 표시합니다. 완전히 종료하려면 macOS에서는 `⌘Q` 를 누르고, Windows에서는 File 메뉴의 Exit를 사용합니다 |
| Archive inactive chats | Never | After 7 days 또는 After 30 days를 선택할 수 있습니다. 워크스페이스 전체에 적용됩니다. 실행 중인 세션은 보관되지 않습니다 |

### 시스템 알림

**Settings › General** 의 System notifications 그룹에 있습니다.

| 설정 | 기본값 | 설명 |
| - | - | - |
| System notifications | On | 전체 스위치입니다. 끄면 배너가 표시되지 않으며, 아래 세 카테고리의 선택은 유지됩니다 |
| System permission | 없음 | 시스템 또는 브라우저가 알림을 허용하는지 표시합니다. 아직 요청하지 않았다면 **Allow notifications** 를 클릭합니다. 거부된 경우 **System Settings** 를 클릭합니다 |
| Task completed | On | 세션 또는 예약 작업이 완료되었습니다 |
| Needs your attention | On | 승인, 추가 정보, 또는 직접 조작이 필요합니다 |
| Task issues | On | 실패, 중단, 또는 예약 작업이 자동으로 일시 중지되었습니다 |

배너는 해당 페이지를 보고 있지 않을 때만 표시됩니다. 배너를 클릭하면 관련 세션이나 예약 작업이 열립니다. 데스크톱 앱은 처음 로그인한 후 알림 권한을 한 번 요청합니다. 웹 앱은 자동으로 요청하지 않으므로 여기에서 켜세요. 예약 작업이 결과를 알릴지는 해당 작업의 알림 설정에 따라서도 달라집니다. [예약 작업](https://docs.aihubmix.com/ko/cloud/automation/scheduled-tasks.md)을 참고하세요.

### 알림

앱 내 알림 목록입니다. 시스템 알림 스위치와는 별개이며, 시스템 알림을 꺼도 기록은 남습니다. `⌥⌘U`(Windows: `Ctrl+Alt+U`)를 누르거나 계정 메뉴의 **Notifications** 에서도 열 수 있습니다. All 또는 Unread로 필터링하거나, **Mark all read** 를 클릭하거나, 항목을 클릭해 관련 세션, 예약 작업, 프로젝트를 엽니다. 읽음 상태는 기기 간에 동기화됩니다.

### 화면 스타일

| 설정 | 기본값 | 설명 |
| - | - | - |
| Theme | Midnight | Warm Sand와 Iris Slate도 사용할 수 있습니다. 테마마다 라이트 버전과 다크 버전이 있습니다 |
| Display mode | System | Light, Dark, System 중 하나입니다. 테마와는 별개입니다 |

`⇧⌘L`(Windows: `Ctrl+Shift+L`)을 누르거나 계정 메뉴의 화면 스타일 행을 사용하면 표시 모드를 빠르게 전환할 수 있습니다. 테마는 바뀌지 않습니다. 화면 스타일과 알림 설정은 현재 기기 또는 브라우저에만 저장됩니다.

### 업데이트

데스크톱 앱 전용이며, **Settings › General** 의 Updates 그룹에 있습니다. 웹 앱에서는 페이지를 새로 고치면 최신 버전을 사용할 수 있습니다.

| 설정 | 기본값 | 설명 |
| - | - | - |
| Automatically check for updates | On | 끄면 앱이 새 버전을 확인하지 않으며, 자동 다운로드도 사용할 수 없습니다 |
| Automatically download updates | On | 새 버전을 백그라운드에서 다운로드하고, 완료되면 재시작을 안내합니다 |

계정 메뉴에서 **Check for updates** 를 클릭해 직접 확인할 수도 있습니다. 다운로드가 끝나면 **Restart to update** 를 클릭합니다. 이 컴퓨터에서 로컬 작업이 아직 실행 중이면 **Restart after tasks** 를 선택해 작업이 끝난 후 자동으로 재시작할 수 있습니다. 클라우드 세션은 재시작의 영향을 받지 않습니다.

### 키보드 단축키

모든 단축키를 나열하며, `⌘/` 빠른 참조 패널과 내용이 같습니다. [키보드 단축키](https://docs.aihubmix.com/ko/cloud/reference/keyboard-shortcuts.md)를 참고하세요.

## 연동

* **Connectors**: GitHub, Gmail 등 서비스의 인증입니다. [커넥터](https://docs.aihubmix.com/ko/cloud/integrations/connectors.md)를 참고하세요.
* **Plugins**: 플러그인, MCP, Skills입니다. [플러그인, MCP, Skills](https://docs.aihubmix.com/ko/cloud/integrations/plugins-mcp-skills.md)를 참고하세요.
* **Import sessions**: 다른 도구나 다른 계정의 세션을 가져와 이어서 진행합니다. 원래 세션은 영향을 받지 않습니다. **Import from .cshare file** 을 클릭해 파일을 선택합니다(최대 50 MB). 데스크톱 앱에는 이 컴퓨터의 Claude Code 및 Codex 세션도 표시됩니다. 세션을 선택하고 **Import** 를 클릭합니다. 가져오기 전에 내 기기에서 세션 기록의 민감한 정보가 제거되며, 하루 가져오기 한도가 있습니다.

## 워크스페이스

| 섹션 | 내용 |
| - | - |
| Overview | 워크스페이스 이름(1자에서 64자), 프로젝트 수와 멤버, 클라우드 서버 관리자 권한 스위치(기본값은 켜짐이며, 켜져 있으면 에이전트가 클라우드 서버에 소프트웨어를 설치하고 시스템 설정을 변경할 수 있습니다)입니다. [클라우드 서버](https://docs.aihubmix.com/ko/cloud/environments/cloud-host.md)를 참고하세요 |
| Machines | 데스크톱 앱에 로그인한 컴퓨터와 클라우드 서버, 그리고 각 컴퓨터의 실행 허용 여부, 권한 상한, 사용할 수 있는 시크릿입니다. [내 기기에서 실행](https://docs.aihubmix.com/ko/cloud/environments/your-device.md)을 참고하세요 |
| Secrets & variables | 단일 프로젝트용이거나 모든 프로젝트가 공유하는 변수와 시크릿입니다. 이름이 같으면 프로젝트의 값이 우선합니다. 하나씩 추가하거나 **Bulk add** 로 `.env` 내용을 붙여 넣습니다. 시크릿은 암호화되어 저장되며 AI는 원래 값을 볼 수 없습니다. [프로젝트와 환경 구성](https://docs.aihubmix.com/ko/cloud/environments/projects.md)을 참고하세요 |
| Projects | 워크스페이스의 모든 프로젝트입니다. 행 끝의 톱니바퀴를 클릭하면 프로젝트 설정이 열립니다. [프로젝트와 환경 구성](https://docs.aihubmix.com/ko/cloud/environments/projects.md)을 참고하세요 |
| Archived chats | 보관된 세션입니다. 열어서 보거나, **Restore** 로 사이드바에 복원하거나, 영구 삭제할 수 있습니다. [세션 관리](https://docs.aihubmix.com/ko/cloud/sessions/manage-sessions.md)를 참고하세요 |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.