> ## 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 › Workspace: 개요, 시크릿과 환경 변수, 프로젝트

> 워크스페이스 설정: 개요, 시크릿과 변수(프로젝트 수준과 모든 프로젝트 공유, 일괄 추가), 프로젝트 목록과 프로젝트 설정 진입점을 설명합니다.

**워크스페이스**는 프로젝트, 세션, 시크릿, 환경 변수가 속하는 범위입니다. **Settings** 탐색의 **Workspace** 그룹에는 **Overview**, **Machines**, **Secrets & variables**, **Projects**, **Archived chats** 가 있습니다. 이 페이지는 Overview, Secrets & variables, Projects를 다룹니다. Machines는 [실행 환경: 내 기기와 클라우드 서버](https://docs.aihubmix.com/ko/cloud/projects/run-environment.md)를, Archived chats는 [보관된 채팅](https://docs.aihubmix.com/ko/cloud/settings/archived.md)을 참고하세요.

## 적용 범위

데스크톱 앱, 웹 앱, 모바일 웹에서 지원됩니다. 모바일 웹에서는 설정 탐색이 세부 화면을 여는 그룹 목록으로 바뀝니다.

## 찾는 위치

계정 메뉴 › **Settings**, 왼쪽 탐색의 **Workspace** 그룹.

## 개요

| 행 | 표시 내용 | 작업 |
| - | - | - |
| 워크스페이스 이름 | 현재 이름, 이름이 없으면 **Untitled** | **Edit** |
| 프로젝트 | **N projects** | **View** 는 **Settings › Workspace › Projects** 를 엽니다 |
| 멤버 | 개인 워크스페이스에는 **Just you · owner**, 팀 워크스페이스에는 **Team workspace · member management coming soon** 이 표시됩니다 | 없음 |

이름을 변경할 때 이름은 1\~64자이며 비워 둘 수 없습니다.

### 클라우드 서버 관리자 권한

**Overview** 아래에는 **Admin access on cloud server** 스위치(켜면 에이전트가 클라우드 서버에서 소프트웨어를 설치하고 시스템 설정을 변경할 수 있음, 기본값 켜짐)와 현재 상태가 있습니다. [클라우드 서버 관리자 권한](https://docs.aihubmix.com/ko/cloud/cloud-host/admin-permission.md)을 참고하세요.

## 시크릿과 변수

페이지는 두 부분으로 구성됩니다.

* **Projects**: 프로젝트마다 그룹 하나가 있으며, 프로젝트 이름, 소스, 요약(예: **2 variables · 1 secret**)이 표시됩니다.
* **All projects**: 워크스페이스 수준이며 모든 프로젝트에 적용됩니다.

규칙:

* 이름이 같으면 프로젝트의 값이 우선합니다. **All projects** 의 값은 프로젝트에 같은 이름의 항목이 없을 때만 사용됩니다. 프로젝트 그룹에서 워크스페이스 항목을 재정의하는 항목에는 **Overrides workspace** 라벨이, 워크스페이스 그룹에서 프로젝트가 재정의한 항목에는 **Overridden in N projects** 라벨이 붙습니다.
* 시크릿은 암호화되어 저장되며 AI는 원래 값을 볼 수 없습니다. 시크릿 값은 인터페이스에서 점으로 표시됩니다.
* 각 그룹 오른쪽 위에는 **Bulk add** 와 **Add secret or variable** 이 있습니다. 각 행에는 편집 및 삭제 버튼이 있습니다. 삭제할 때 확인을 묻지 않습니다.

### 추가 또는 편집

| 필드 | 설명 |
| - | - |
| Name | 자동으로 대문자로 변환되며 공백은 밑줄로 바뀝니다. 예: `API_BASE_URL`. 편집할 때는 변경할 수 없습니다 |
| Value | 필수입니다. 편집할 때는 원래 값이 숨겨지며, 새 값을 입력하여 대체합니다 |
| Type | **Variable**(기본값) 또는 **Secret** |

### 일괄 추가

**Bulk add** 를 클릭하고 한 줄에 하나씩 `KEY=value` 를 입력합니다. `.env` 파일의 내용을 바로 붙여 넣을 수 있으며, 같은 이름의 항목은 대체됩니다.

* KEY, TOKEN, SECRET 또는 PASSWORD가 포함된 이름은 시크릿으로 저장됩니다. 그 외에는 모두 변수로 저장됩니다.
* 빈 줄과 `#` 으로 시작하는 줄은 무시됩니다. `export KEY=value` 형식도 사용할 수 있습니다. 값을 감싸는 짝이 맞는 따옴표는 제거됩니다.
* 이름에는 영문자, 숫자, 밑줄만 사용할 수 있으며, 숫자로 시작할 수 없고 최대 64자입니다. 값은 비워 둘 수 없습니다. 같은 이름이 두 줄에 나타날 수 없습니다.
* 잘못된 줄은 **Line N: 이유** 표시와 함께 텍스트 상자에 남습니다. 나머지 줄은 정상적으로 저장됩니다.

### 시크릿이 사용되는 곳

* 클라우드 서버의 프로젝트 환경: 값은 위의 같은 이름 우선순위 규칙을 따릅니다.
* 내 기기에서 실행할 때: 기기의 **Allowed secrets** 에 따라 해당 컴퓨터에 제공되는 워크스페이스 시크릿이 정해집니다. [실행 환경: 내 기기와 클라우드 서버](https://docs.aihubmix.com/ko/cloud/projects/run-environment.md)를 참고하세요.
* AI가 환경을 구성하는 중에 누락된 시크릿과 변수를 발견하면 [환경 확인](https://docs.aihubmix.com/ko/cloud/projects/environment-setup.md) 중에 입력하도록 요청하며, 결과는 여기에도 저장됩니다.

## 프로젝트

**Settings › Workspace › Projects** 에는 워크스페이스의 모든 프로젝트가 나열됩니다. 각 행에는 이름, 소스(GitHub 저장소 또는 폴더), 상태(예: **Environment not set up**, **Setup failed**, **This computer only**), 변수 개수가 표시됩니다. 행을 클릭하면 프로젝트 페이지가 열리고, 행 끝의 톱니바퀴를 클릭하면 프로젝트 설정이 바로 열립니다. 각 상태의 의미는 [프로젝트 환경](https://docs.aihubmix.com/ko/cloud/projects/environment-setup.md)과 [프로젝트](https://docs.aihubmix.com/ko/cloud/projects/projects.md)를 참고하세요.

## 프로젝트 설정

개별 프로젝트의 설정은 프로젝트 목록의 톱니바퀴, 프로젝트 페이지 오른쪽 위의 **Project settings**, 프로젝트 메뉴의 **Edit** 에서 열 수 있습니다.

| 영역 | 내용 | 변경 사항이 적용되는 시점 |
| - | - | - |
| 프로젝트 정보 | 이름, 설명, 저장소 또는 소스 폴더, 기준 브랜치, 커밋 방식, 커밋 작성자, 추가로 복제하는 저장소 | **Save** 를 클릭한 후. **Discard** 할 수 있습니다 |
| 환경 | 설정 스크립트, 시작 명령 | 다시 실행하고 게시한 후 |
| 시크릿과 변수 | 프로젝트 수준의 항목과 **Inherited from workspace** 항목 | 삭제는 즉시 적용됩니다. 항목 추가와 편집은 **Settings › Workspace › Secrets & variables** 에서 합니다 |
| 프로젝트 삭제 | **Delete project…** | 확인한 즉시 |
| 프로젝트 내보내기 | **Download project archive** | 클릭하면 다운로드가 시작됩니다 |

자세한 내용은 [프로젝트](https://docs.aihubmix.com/ko/cloud/projects/projects.md)와 [프로젝트 환경](https://docs.aihubmix.com/ko/cloud/projects/environment-setup.md)을 참고하세요.

## 자주 묻는 질문

### 프로젝트와 워크스페이스에 같은 이름의 변수가 있으면 어느 것이 사용되나요?

프로젝트의 값이 사용됩니다. **All projects** 의 값은 프로젝트에 같은 이름의 항목이 없을 때만 적용됩니다.

### 입력한 시크릿을 AI가 볼 수 있나요?

아니요. 시크릿은 암호화되어 저장됩니다. 인터페이스와 채팅에는 이름만 표시되며, 값은 실행 시 환경에 제공됩니다.

## 관련 문서

* [프로젝트](https://docs.aihubmix.com/ko/cloud/projects/projects.md)
* [프로젝트 환경](https://docs.aihubmix.com/ko/cloud/projects/environment-setup.md)
* [실행 환경: 내 기기와 클라우드 서버](https://docs.aihubmix.com/ko/cloud/projects/run-environment.md)
* [클라우드 서버 관리자 권한](https://docs.aihubmix.com/ko/cloud/cloud-host/admin-permission.md)
* [보관된 채팅](https://docs.aihubmix.com/ko/cloud/settings/archived.md)


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