그대로인 것
- 편집기와 확장
- 브라우저 새 탭에서 엽니다. 탭을 여러 개 열어도 됩니다.
- 터미널
- 탭을 닫아도 돌던 작업은 계속되고, 다시 열면 같은 터미널로 돌아옵니다(화면은 최근 100줄까지).
- 코딩 에이전트
- Claude Code(명령줄 도구와 VS Code 확장)가 설치되어 있습니다. 내 Claude 계정을 한 번 연결하면 모든 작업공간에서 씁니다.
- 패키지 설치
- 파이썬은
pip install --user, 시스템 패키지는sudo apt-get install. 작업 환경을 다시 만들어도 남습니다. - 오래 걸리는 작업
- 학습처럼 오래 걸리는 작업은 터미널의
tmux,screen안에 띄워 둡니다. IDE가 다시 시작되어도 이어집니다. - GPU
- 여러 작업공간이 함께 씁니다. 작업공간마다 관리자가 정한 GPU 메모리 상한이 있고, 넘으면 가장 큰 프로세스가 끝납니다.
- SSH
- 관리자가 허용하면, 내 컴퓨터의 터미널이나 데스크톱 VS Code(Remote-SSH)로 켜져 있는 내 작업공간에 접속합니다. 화면에 나오는 접속 명령을 복사해 씁니다. Windows와 macOS에서 모든 접속 명령을 확인하는 일은 아직 남아 있습니다.
브라우저 IDE는 VS Code 호환 편집기인 code-server입니다. 확장은 Open VSX에서 받으므로 Microsoft 전용 확장(예: Pylance)은 없을 수 있고, 인터넷 규칙이 「Claude만」이면 확장을 받을 수 없습니다.
새로 하는 일은 두 가지
쓸 데이터 고르기
새 작업공간을 만들 때 이 작업공간에서 쓸 데이터를 고릅니다. 처음에는 내 데이터 전체가 골라져 있습니다. 고르는 동안 이 작업공간의 결과를 볼 수 있는 사람이 몇 명인지 바로 보이고, 더하면 그 수가 줄어드는 데이터는 미리 알려 줍니다. 필요한 만큼만 고르세요.
데이터는 나중에 더할 수 있지만, 한 번 더한 데이터는 뺄 수 없습니다. 그 데이터로 만든 파일이 이미 작업 폴더에 있을 수 있기 때문입니다. 빼려면 새 작업공간을 만듭니다.
이 작업공간에서 쓸 데이터
- (일부 고름)내 데이터 전체
- (고름)
/images/ct_20241,248개 - (고름)
/tables/patients4개 - (고르지 않음) (미리 보는 중)
/tables/labs4개
보이는 파일1,252개
이 작업공간의 결과를 볼 수 있는 사람
4명 (전체 31명 중)
관리자는 항상 볼 수 있습니다
이 데이터를 더하면 4명에서 2명으로 줄어듭니다: /tables/labs
필요한 권한 ct_research또는imaging_all중 하나 그리고 ehr_basic또는ehr_full중 하나
누르면 실행할 명령
ws create kim --data /images/ct_2024 /tables/patients 결과 내보내기
결과를 나눌 때 작업공간에서 결과 내보내기를 누르고, 내보낼 파일과 재현 명령 파일을 적습니다. 내보낸 결과는 이 작업공간의 결과를 볼 수 있는 사람만 봅니다.
결과를 다시 만드는 데 필요한 재료, 곧 그 순간의 작업 폴더와 작업 환경, 쓴 데이터도 함께 저장됩니다. 다시 실행해 확인하는 기능은 계획되어 있습니다.
- 작업공간
ws-0012- 볼 수 있는 사람
- 4명 (전체 31명 중)
내보낸 결과는 이 작업공간의 결과를 볼 수 있는 사람만 볼 수 있습니다.
project/outputs/model.pt project/outputs/roc_curve.png 작업 폴더 기준 경로를 적습니다. 폴더를 적으면 폴더 안 파일을 모두 내보냅니다. project/reproduce.sh 결과를 다시 만드는 명령을 적은 파일입니다. 지금은 파일이 있는지만 확인하고 실행하지 않습니다. 누르면 실행할 명령
release create --workspace ws-0012 --outputs project/outputs/model.pt project/outputs/roc_curve.png --reproduce project/reproduce.sh 작업공간 안에서
~/project에, 내 데이터는 /data에 있습니다./data- 내 데이터. 고른 데이터 가운데 내가 볼 수 있는 파일만 있고, 읽기만 할 수 있습니다.
~/project- 내 작업. 코드를 여기에 둡니다. 작업 환경을 다시 만들어도 남습니다.
~/project/outputs- 내보낼 결과를 두는 곳.
~/project/reproduce.sh- 결과를 처음부터 다시 만드는 명령.
/data/tables/<표>/table.yaml- 표의 설명: 열의 뜻, 코드 체계, 단위, 결측값 규칙.
~/.synapse/data.duckdb- 표마다 바로 질의할 수 있게 만들어 둔 DuckDB 파일 (읽기 전용).
코딩 에이전트는 작업공간 규칙을 받습니다. 데이터는 /data에서 읽고, 코드는 ~/project에, 결과는 ~/project/outputs에 두고, 랜덤 시드를 고정하고, 다시 만드는 명령을 ~/project/reproduce.sh에 적으라는 규칙입니다. 에이전트가 규칙대로 했는지는 결과를 내보내기 전에 재현 명령 파일을 열어 확인하세요.
내 데이터 화면에 나오는 「작업공간 안 경로」(예: /data/images/ct_2024)를 그대로 에이전트에게 알려 주면 됩니다.
인터넷은 관리자가 작업공간마다 정한 곳으로만 나갑니다. 기본은 Claude와 패키지 저장소(PyPI, Ubuntu apt, VS Code 확장)입니다. 막힌 요청은 인터넷 접속 기록에 남으니, 필요한 주소를 관리자에게 알려 주세요.
EXPLORER
outputsreproduce.shtrain.pyimages/ct_2024tables/patients작업공간 터미널에서
pip install --user scikit-imagesudo apt-get install -y graphviztmux new -s trainsynapse help 에이전트가 요청하면, 결정은 내가 합니다
승인 화면에서 무엇이 바뀌는지(보이는 파일 수, 결과를 볼 수 있는 사람 수)를 보고 「승인하고 실행」을 누르면, 그 명령이 내 이름으로 한 번 실행됩니다. 요청한 뒤 파일이 바뀌면 실행하지 않으니, 고친 다음 다시 요청하게 하세요.
코드를 짜고 실행하는 일, /data에 있는 데이터를 읽는 일, 허용된 인터넷 주소를 쓰는 일에는 승인이 필요 없습니다. 내가 포털에서 직접 누른 데이터 더하기와 결과 내보내기도 바로 실행됩니다.
데이터 더하기 요청 a-0031
Claude가 이 작업공간에 데이터를 더하려고 합니다.
- 요청한 곳
ws-0012- 더할 데이터
/tables/labs(4개)
| 언제 | 보이는 파일 | 볼 수 있는 사람 |
|---|---|---|
| 지금 | 1,252개 | 4명 (전체 31명 중) |
| 승인하면 | 1,256개 | 2명 (전체 31명 중) |
실행할 명령
ws add-data ws-0012 /tables/labs 승인하면 위 명령이 kim 이름으로 한 번 실행됩니다.
요청한 뒤 파일이 바뀌거나 더해지면 승인해도 실행하지 않습니다.
링크 하나로 나눕니다
권한이 없는 사람에게는 필요한 권한이 보이고, 관리자에게 요청할 수 있습니다. 권한이 있는 사람에게는 미리 보기와 요약, 결과 출처가 나옵니다.
동료가 그 링크를 자기 작업공간의 에이전트에게 붙여 넣으면, 내 결과를 동료의 작업공간에 데이터로 더하는 요청이 됩니다. 동료가 승인하면 동료 작업공간의 /data/releases 아래에 읽기 전용으로 나타납니다.
고친 결과는 새로 내보내면서 「대체할 결과」로 이전 결과를 고릅니다. 그러면 이전 결과의 공유 화면이 새 결과를 가리킵니다.
project/outputs/gradcam_017.png이미지project/outputs/roc_curve.png이미지project/outputs/model.pt가중치project/outputs/metrics.json지표
요약
- 만든 사람
kim- 작업공간
ws-0012- 쓴 데이터
/images/ct_2024,/tables/patients- 볼 수 있는 사람
- 4명 (전체 31명 중)
- 재현 명령
project/reproduce.sh
아직 다시 실행해 확인하지 않았습니다. 재현 명령과 당시 환경은 저장되어 있습니다.
내려받기는 기록됩니다
내 작업은 그대로 남습니다
정지해도 작업 폴더와 설치한 패키지는 남고, 다시 시작하면 이어서 합니다. 작업 환경이 끝나면 끝난 까닭(예: 메모리가 모자라 끝남)이 남습니다.
쓰지 않는 작업공간은 보관합니다. 보관하면 GPU를 돌려주고 작업공간 개수 상한에서 빠집니다. 작업 폴더와 기록, 내보낸 결과는 그대로 남고, 보관을 풀 수 있습니다.
작업 폴더마다 용량 상한이 있고, 80% 이상이면 「거의 찼음」으로 알려 줍니다. 한 사람이 켜 둘 수 있는 작업공간 수는 기관이 정합니다.
ws stop ws-0012 Stopped workspace: ws-0012The work folder stays as it is. ws archive ws-0012 Archived workspace: ws-0012The work folder, records and releases stay. 안 될 때는 까닭과 고칠 방법을 알려 줍니다
예시는 결과 폴더 안에 심볼릭 링크가 있고, 그 링크가 /data 안을 가리킬 때입니다. 원본이 링크를 타고 결과에 섞여 나가지 않게, 내보내기 전에 막습니다.
결과를 내보내지 못했습니다. 심볼릭 링크인 경로가 있습니다.
사유: 심볼릭 링크: project/outputs/ct (가리키는 곳 /data/images/ct_2024). 실제 파일로 바꾼 다음 다시 하세요.
release create --workspace ws-0012 --outputs project/outputs --reproduce project/reproduce.sh Could not release the outputs. A path is a symbolic link.reason: Symbolic link: project/outputs/ct -> /data/images/ct_2024. Replace it with the real file, then try again. 내 작업을 볼 수 있는 사람
- 내보낸 결과
- 이 작업공간의 결과를 볼 수 있는 사람과 관리자.
- 작업공간과 IDE
- IDE는 작업공간 주인만 엽니다. 작업공간을 다른 사람과 함께 쓰는 기능은 없고, 결과는 내보내서 나눕니다.
- 결과와 함께 저장된 작업 폴더와 작업 환경
- 나와 관리자. 에이전트와 나눈 대화 기록(
~/.claude)도 작업 폴더에 들어 있습니다. - 관리자
- 기관의 모든 데이터와 결과를 볼 수 있습니다.
- 에이전트가 읽은 내용
- 내 Claude 계정으로 모델 제공사(Anthropic)에 전송됩니다. 대화를 모델 학습에 쓰는지 같은 조건은 내 Claude 계정 설정을 따르고, 기관이 정할 수 없습니다. 연결하기 전에 Claude 계정의 개인정보 설정을 확인하세요.
- 기록
- 로그인, 화면과 API와 작업공간에서 실행한 명령, 결과 열람과 내려받기, 편집기에서 내려받은 파일은 기록됩니다. 터미널 화면 내용은 기록하지 않습니다.