메인 콘텐츠로 건너뛰기
워크스페이스는 프로젝트, 세션, 시크릿, 환경 변수가 속하는 범위입니다. Settings 탐색의 Workspace 그룹에는 Overview, Machines, Secrets & variables, Projects, Archived chats 가 있습니다. 이 페이지는 Overview, Secrets & variables, Projects를 다룹니다. Machines는 실행 환경: 내 기기와 클라우드 서버를, Archived chats는 보관된 채팅을 참고하세요.

적용 범위

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

찾는 위치

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

개요

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

클라우드 서버 관리자 권한

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

시크릿과 변수

페이지는 두 부분으로 구성됩니다.
  • Projects: 프로젝트마다 그룹 하나가 있으며, 프로젝트 이름, 소스, 요약(예: 2 variables · 1 secret)이 표시됩니다.
  • All projects: 워크스페이스 수준이며 모든 프로젝트에 적용됩니다.
규칙:
  • 이름이 같으면 프로젝트의 값이 우선합니다. All projects 의 값은 프로젝트에 같은 이름의 항목이 없을 때만 사용됩니다. 프로젝트 그룹에서 워크스페이스 항목을 재정의하는 항목에는 Overrides workspace 라벨이, 워크스페이스 그룹에서 프로젝트가 재정의한 항목에는 Overridden in N projects 라벨이 붙습니다.
  • 시크릿은 암호화되어 저장되며 AI는 원래 값을 볼 수 없습니다. 시크릿 값은 인터페이스에서 점으로 표시됩니다.
  • 각 그룹 오른쪽 위에는 Bulk add 와 Add secret or variable 이 있습니다. 각 행에는 편집 및 삭제 버튼이 있습니다. 삭제할 때 확인을 묻지 않습니다.

추가 또는 편집

일괄 추가

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

시크릿이 사용되는 곳

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

프로젝트

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

프로젝트 설정

개별 프로젝트의 설정은 프로젝트 목록의 톱니바퀴, 프로젝트 페이지 오른쪽 위의 Project settings, 프로젝트 메뉴의 Edit 에서 열 수 있습니다. 자세한 내용은 프로젝트와 프로젝트 환경을 참고하세요.

자주 묻는 질문

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

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

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

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

관련 문서