내 샌드박스
내 샌드박스에서는 개인 실행 환경의 상태, 리소스 사용량, 작업 디렉터리, 터미널을 보여 주며 필요한 샌드박스 작업 진입점을 제공합니다.
대상 독자: 개인 실행 환경을 확인하는 사용자.
검색 키워드: My sandbox, Sandbox, 샌드박스, 작업 디렉터리, 터미널.
해결할 수 있는 문제
내 샌드박스는 현재 계정에 대응하는 개인 실행 환경을 확인하고 사용하는 곳입니다. 격리된 환경에서 명령과 스크립트를 실행하고 프로젝트 파일을 저장할 수 있으며, 리소스 사용량을 점검하고 사용 가능한 도구를 확인하여 터미널이나 스크립트 실행 문제를 해결할 수도 있습니다.
프로젝트별로 파일과 명령을 구분해야 한다면 작업 디렉터리를 여러 개 만들고, 디렉터리마다 Skill, MCP, 모델을 선택할 수 있습니다.
이 문서에서 워크스페이스는 샌드박스 안의 프로젝트 디렉터리를 가리키며, 아래에서는 작업 디렉터리로 통일해 부릅니다. 이는 내비게이션의 개인/공유 워크스페이스와 다릅니다. 비즈니스 공간 생성, 공간 멤버 및 권한 관리, 공간 기능 설정은 새 공간 생성하기를 참고하십시오.
샌드박스 진입 및 상태 확인
사용자 메뉴를 열고 내 샌드박스를 선택합니다. 페이지에 샌드박스 정보, CPU 및 메모리 사용 현황, 작업 디렉터리 목록, 터미널 영역이 표시됩니다.
상태 확인. 샌드박스 정보 영역에는 이름, 실행 상태, 마지막 접속 시간이 표시됩니다. 이 영역의 새로 고침 버튼을 클릭하면 상태를 다시 가져옵니다. 작업 디렉터리 목록의 새로 고침은 디렉터리를 다시 스캔하는 데 사용합니다.
시작 및 재시작. 샌드박스가 실행되지 않은 상태에서 페이지에 시작이 표시되면 시작을 클릭하고 상태가 실행 중으로 바뀔 때까지 기다립니다. 실행 중이거나 시작 중일 때는 재시작 진입점이 표시됩니다. 재시작하기 전에 한 번 더 확인해야 하며, 작업 중에는 상태가 업데이트될 때까지 기다리고 반복해서 클릭하지 마십시오.
재시작하면 현재 샌드박스에서 실행 중인 터미널과 프로세스가 중단됩니다. 터미널에 다시 연결한다고 해서 중단된 작업이 복구되는 것은 아니므로, 먼저 작업 상태를 확인한 후 다시 실행할지 결정하십시오.
리소스 확인. CPU에는 사용 중인 코어 수, 전체 코어 수, 사용률이 표시되고, 메모리에는 사용 중인 용량, 전체 용량, 사용률이 표시됩니다. 진행률 표시줄로 현재 리소스 사용량이 높은지 낮은지 판단할 수 있습니다.
리소스에 샘플 없음, 리소스 지표를 사용할 수 없습니다 또는 시작 후 리소스 지표를 볼 수 있습니다가 표시되면 일시적으로 표시할 지표가 없다는 뜻이며, 사용량이 0이라는 의미는 아닙니다. CPU나 메모리 사용량이 오랫동안 높으면 먼저 계속 실행 중인 작업을 점검한 후 재시작이 필요한지 판단하십시오.
개인 샌드박스가 바인딩되지 않았거나 샌드박스가 비활성화된 경우 먼저 관리자에게 처리를 요청하십시오. 샌드박스가 실행되지 않은 동안에는 작업 디렉터리를 생성하거나 새로 고치거나 열 수 없습니다.
작업 디렉터리 생성 및 관리
작업 디렉터리 목록에는 디렉터리 이름, 경로, 사용 가능 여부가 표시됩니다. 개인 샌드박스가 실행 중 상태인지 먼저 확인한 후 디렉터리 작업을 진행하십시오.
- 워크스페이스 영역에서 새로 만들기를 클릭하고 이름을 입력합니다.
- 생성 창에서 필요한 Skill, MCP, 워크스페이스 모델을 선택하고, 미리 선택된 항목이 현재 작업에 맞는지 확인합니다.
- 생성을 클릭합니다. 시스템이 이름을 기준으로 디렉터리를 생성합니다. 생성에 성공하면 목록에서 디렉터리와 경로를 확인합니다.
새로 고침 및 이름 변경. 목록의 새로 고침을 클릭하면 샌드박스 안의 작업 디렉터리를 다시 스캔합니다. 디렉터리 이름 옆의 이름 바꾸기로 수정되는 것은 표시 이름뿐이며, 샌드박스 안의 폴더 이름을 바꾸거나 실제 경로를 변경하지 않습니다.
터미널 열기 또는 파일 탐색. 디렉터리 카드를 클릭하면 해당 디렉터리의 터미널을 열거나 그 터미널로 전환합니다. 카드의 파일 버튼을 클릭하면 파일 패널을 펼치거나 접습니다. 두 가지는 서로 다른 진입점입니다.
파일 패널에서는 하위 디렉터리 진입, 경로 내비게이션을 통한 상위 디렉터리 이동, 텍스트 파일 미리보기, 파일 다운로드, 파일 업로드, 새 폴더 생성을 지원합니다. 미리보기가 잘리거나 파일을 미리 볼 수 없으면 다운로드한 후 확인하십시오.
파일이나 디렉터리를 삭제하기 전에 확인이 필요합니다. 디렉터리를 삭제하면 그 안의 내용도 함께 삭제되며 복구할 수 없으므로, 보관해야 할 파일은 먼저 저장하십시오. 잘 모르는 디렉터리, 설정 파일 또는 시스템이 제공하는 Skill 내용은 함부로 삭제하지 마십시오.
디렉터리 기능 구성
대상 디렉터리 카드의 구성을 클릭하고 Skills, MCP, 워크스페이스 모델에서 현재 디렉터리의 기능을 조정한 후 저장을 클릭합니다. 옵션만 선택하고 저장하지 않으면 이번 변경 사항은 제출되지 않습니다.
Skill 및 MCP. 창에서 선택할 수 있는 기능 중 필요한 항목을 체크합니다. 이 설정은 현재 작업 디렉터리에만 적용되며, 개인/공유 워크스페이스의 기능 설정을 변경하는 것이 아니고 다른 디렉터리에 일괄 적용되지도 않습니다.
모델. 디렉터리를 새로 만들거나 모델을 다시 선택하면 해당 디렉터리가 고정적으로 사용할 구체적인 모델이 저장되며, 전역 기본 모델이 바뀌어도 따라 바뀌지 않습니다. 일부 기존 디렉터리에는 전역 기본 모델(상속) 항목이 표시될 수 있습니다. 구체적인 모델로 변경하고 저장하면 그때부터 선택한 모델을 사용합니다.
기존에 구성한 모델이 사용 불가로 표시되면 사용 가능한 모델을 다시 선택한 후 저장하십시오. 사용 가능한 모델이 없거나 모델 목록을 불러오지 못하면 먼저 안내에 따라 처리하십시오. 관리자가 모델을 구성하거나 활성화해야 한다면 시스템 관리를 참고하십시오.
저장에 실패하면 오류 상세 정보를 확인하고 수정한 후 다시 시도하십시오. 생성 시 실패 메시지가 표시되었는데 목록에 디렉터리가 나타났다면, 다시 생성하지 말고 먼저 해당 디렉터리의 구성을 열어 확인한 후 추가로 저장하십시오.
터미널 사용 및 도구 확인
터미널 영역에서는 브라우저에서 샌드박스 명령줄을 직접 조작할 수 있습니다. 터미널에서 자주 쓰는 명령을 실행하거나, 스크립트를 실행하거나, 파일을 확인하거나, 개발 작업을 시작할 수 있습니다.
작업 디렉터리 선택. 먼저 디렉터리 카드를 클릭하여 터미널을 엽니다. 같은 디렉터리를 다시 클릭하면 이미 열려 있는 해당 탭으로 전환됩니다. 현재 디렉터리에서 독립된 터미널을 하나 더 열려면 터미널 영역의 + 버튼을 클릭합니다. 디렉터리를 선택하지 않은 상태에서는 터미널 탭을 바로 새로 만들 수 없습니다.
전환 및 전체 화면. 여러 터미널 탭 사이를 전환할 수 있으며, 터미널 하단에 샌드박스 이름과 열린 탭 수가 표시됩니다. 전체 화면 버튼을 클릭하면 작업 영역이 넓어지고, 종료 버튼을 클릭하거나 Esc를 누르면 돌아갑니다.
다시 연결. 터미널이 종료되었거나 연결이 끊겼거나 서비스를 사용할 수 없을 때는 페이지 안내에 따라 샌드박스와 모델 상태를 점검한 후 다시 연결을 클릭합니다. 다시 연결했다고 해서 원래 프로세스나 작업이 복구된 것으로 간주하지 마십시오.
도구 보기. 샌드박스가 실행 중일 때 도구를 클릭하면 사용 가능한 도구의 이름, 설명, 버전, 명령을 확인할 수 있습니다. 이 목록은 읽기 전용이며 도구를 설치하거나 도구 설정을 변경하는 데 사용하지 않습니다. 불러오지 못하면 다시 로드를 클릭하십시오.
샌드박스 재시작, 스크립트 실행, 파일 삭제 등의 작업은 현재 작업에 영향을 줄 수 있으므로, 실행 중인 중요한 작업이 없는지 확인한 후 진행하십시오.
자주 묻는 질문 및 다음 단계
| 발생한 문제 | 권장 조치 |
|---|---|
| 개인 샌드박스 미바인딩 또는 비활성화 | 관리자에게 개인 샌드박스 바인딩 또는 활성화를 요청하십시오. 작업 디렉터리를 새로 만들어 해결할 수 있는 문제가 아닙니다. |
| 디렉터리가 목록에 남아 있으나 폴더가 삭제되었다는 메시지 표시 | 먼저 새로 고쳐 디렉터리 상태를 확인하십시오. 목록에 기록이 있다고 폴더가 아직 존재하는 것은 아니며, 표시 이름을 바꿔 파일을 복구할 수도 없습니다. 내용을 복구해야 하면 관리자에게 문의하십시오. |
| 디렉터리 상태 알 수 없음 또는 가져오기 실패 | 먼저 샌드박스가 실행 중인지 확인한 후 디렉터리 목록을 새로 고치십시오. 점검이 성공하기 전에는 디렉터리가 삭제되었다고 단정하지 마십시오. |
| 터미널에 모델을 사용할 수 없다는 메시지 표시 | 현재 디렉터리의 구성을 열어 사용 가능한 모델을 다시 선택하고 저장하십시오. 전역 기본 모델이 없거나 사용할 수 없다는 메시지가 표시되면 관리자에게 문의하십시오. |
| 상태, 도구 또는 파일 목록 로드 실패 | 해당 영역의 새로 고침, 다시 로드 또는 다시 시도 진입점을 사용하십시오. 계속 실패하면 관리자에게 페이지 메시지와 작업 시간을 알려 주십시오. |
다음 목표에 따라 해당 문서를 바로 참고하십시오.
- 관리자가 샌드박스나 모델 설정을 처리해야 하는 경우: 시스템 관리.
- 개인/공유 비즈니스 공간을 만들고 멤버 권한을 설정해야 하는 경우: 새 공간 생성하기.
- 환경을 준비한 후 비즈니스 대화로 돌아가 작업을 계속하는 경우: 대화.
- 명령줄 사용 방법을 알아보려는 경우: CLI.
소속 목차: 플랫폼 및 설정. 위의 관련 페이지에서 바로 이어서 읽을 수 있습니다.