빠른 시작 | Synapse

포털 화면은 개발 중입니다. 화면의 낱말과 배치는 바뀔 수 있고, 단추가 실행하는 명령은 이미 만들어져 있습니다.

화면에서 단추를 누르면 화면 아래 명령 콘솔에 그 단추가 실행한 명령과 출력이 나옵니다. 단계마다 그 명령을 함께 적었습니다. 콘솔의 명령은 복사해 다시 실행할 수 있습니다. 아이디, 경로, 수, 역할 이름은 모두 예시입니다.

1단계: 로그인하고 비밀번호 정하기

포털 주소를 열고 「아이디」와 「비밀번호」에 안내문의 아이디와 임시 비밀번호를 넣은 다음 [로그인]을 누릅니다.
기관이 OTP 앱을 요구하면 먼저 「OTP 앱 등록」 화면이 나옵니다. [등록]을 누르고 휴대폰의 OTP 앱으로 QR 코드를 찍은 다음, 앱에 보이는 6자리 코드를 넣고 [확인]을 누릅니다. 단추가 [비밀번호 바꾸기]로 바뀌면 누릅니다.
새 비밀번호를 정하는 화면에서 「지금 비밀번호」에 임시 비밀번호를, 「새 비밀번호」와 「새 비밀번호 한 번 더」에 새 비밀번호를 넣고 [비밀번호 바꾸기]를 누릅니다. 그다음 새 비밀번호로 다시 로그인합니다. OTP 앱을 등록했으면 코드도 넣습니다.

보이는 것

처음 로그인했거나 관리자가 임시 비밀번호를 만들었습니다. 새 비밀번호를 정해야 계속할 수 있습니다.

콘솔에 나오는 명령

로그인 화면에는 명령 콘솔이 없습니다. 콘솔은 로그인한 다음 모든 화면 아래에 있습니다.
자세히: 로그인과 OTP 앱
2단계: Claude 연결 (한 번만)
왼쪽 메뉴에서 [내 계정]을 누르고 Claude 구역으로 갑니다.
내 컴퓨터의 터미널에서 아래 명령을 실행합니다. 브라우저가 열리면 내 Claude 계정으로 승인하고, 터미널에 찍힌 토큰을 복사합니다.

내 컴퓨터의 터미널에서
$ claude setup-token
토큰을 「Claude 토큰 (sk-ant-...)」 칸에 붙여 넣고 [Claude 연결]을 누릅니다. 모든 작업공간이 이 연결을 씁니다.

보이는 것

개인 Claude 계정을 연결합니다. 대화를 모델 학습에 쓰는지 같은 데이터 처리 조건은 내 Claude 계정의 설정을 따르고, 기관이 정할 수 없습니다. 연결하기 전에 Claude 계정의 개인정보 설정을 확인하세요.

콘솔에 나오는 명령

토큰은 표준 입력으로 보내므로 콘솔에 값이 나오지 않습니다.
명령 콘솔 개발 중인 화면
$ synapse user claude-token 완료

표준 입력: (숨김)Connected Claude.
예시이며, 개발 중인 화면을 옮겨 그렸습니다.
자세히: 코딩 에이전트 연결하기
3단계: 내 데이터 둘러보기

왼쪽 메뉴의 [내 데이터]에는 내가 볼 수 있는 데이터만 나옵니다. 볼 수 없는 데이터는 목록에 아예 나오지 않습니다.
항목을 고르면 「작업공간 안 경로」가 보입니다. 예를 들면 /data/images/ct_2024 같은 경로입니다. Claude에게 데이터를 알려 줄 때 이 경로를 그대로 쓰면 됩니다.
필요한 데이터가 보이지 않으면 관리자에게 필요한 데이터와 내 아이디를 알려 주세요.
콘솔에 나오는 명령

이 화면은 조회 명령으로 채워지고 아무것도 바꾸지 않습니다. 콘솔의 [조회 명령도 보기]를 켜면 lake show / 같은 조회 명령도 보입니다.
자세히: 작업공간 만들기
4단계: 새 작업공간 만들기
[내 작업공간]에서 [새 작업공간]을 누릅니다.
「이 작업공간에서 쓸 데이터」에서 이 과제에 필요한 데이터만 고릅니다. 처음에는 「내 데이터 전체」가 골라져 있습니다.
고르는 동안 「이 작업공간의 결과를 볼 수 있는 사람」이 바로 바뀝니다. 데이터를 넓게 고를수록 볼 수 있는 사람은 줄어듭니다. 항목에 마우스를 올리면 더했을 때 몇 명으로 바뀌는지 미리 알려 줍니다.
필요하면 「이름 (선택)」을 적고 [작업공간 만들기]를 누릅니다.
새 작업공간 개발 중인 화면
이 작업공간에서 쓸 데이터

(일부 고름)내 데이터 전체

(고름)/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

/tables/labs 위에 포인터를 올린 모습입니다. 더하면 볼 수 없게 될 두 사람이 빗금으로 보입니다. 예시이며, 개발 중인 화면을 옮겨 그렸습니다.
콘솔에 나오는 명령

「내 데이터 전체」를 그대로 두면 명령에 데이터 목록이 붙지 않습니다. 이름을 적으면 --name도 붙습니다.
명령 콘솔 개발 중인 화면
$ ws create kim --data /images/ct_2024 /tables/patients 완료

Created workspace: ws-0012 (1,252 visible files)Who can see this workspace's results: 4 of 31 people. Admins can always see.Condition: one of ct_research or imaging_all and one of ehr_basic or ehr_fullInternet rules: Packages (packages)
예시이며, 개발 중인 화면을 옮겨 그렸습니다.
자세히: 작업공간 만들기
5단계: 시작하고 IDE 열기
목록에서 새 작업공간을 고르고 [시작]을 누릅니다. 상태가 「시작 중」에서 「실행 중」으로 바뀌면 [IDE 열기]를 누릅니다.
새 탭에 VS Code 호환 편집기(code-server)가 열리고 폴더 두 개가 보입니다.
- My work: 내 작업 폴더, ~/project
- My data (read-only): 내 데이터, /data
IDE 탭을 닫아도 작업공간은 꺼지지 않고, 터미널에서 돌던 작업도 계속됩니다.
콘솔에 나오는 명령

처음 시작할 때는 작업 환경을 만드는 줄이 하나 더 나옵니다: ... Creating the environment (뒤에 환경 이미지 이름). [IDE 열기]는 명령이 아니라 새 탭을 여는 이동이라 콘솔에 나오지 않습니다.
명령 콘솔 개발 중인 화면
$ ws start ws-0012 완료

... Preparing the workspace network... Checking the internet proxy and gateway... Starting the environmentStarted workspace: ws-0012IDE: https://app.example.org/ws/ws-0012/open
예시이며, 개발 중인 화면을 옮겨 그렸습니다.
자세히: IDE와 터미널에서 작업하기
6단계: Claude Code와 작업하기
IDE에서 Claude Code 창을 열거나, 터미널에서 claude 명령을 실행합니다. 연결한 토큰으로 이미 로그인되어 있습니다. 하려는 일을 그대로 말하면 됩니다.
모든 작업공간의 Claude는 같은 작업공간 규칙을 받습니다. 데이터는 /data에서 읽고, 코드는 ~/project에, 결과는 ~/project/outputs에 두고, 랜덤 시드를 고정하고, 결과를 처음부터 다시 만드는 명령을 재현 명령 파일(~/project/reproduce.sh)에 적으라는 규칙입니다. 표 데이터는 같은 폴더의 설명 파일(table.yaml)부터 읽게 되어 있습니다.
이 규칙 파일은 연구자도 에이전트도 고칠 수 없습니다. 다만 Claude가 규칙을 지켰는지는 따로 보장되지 않으니, 결과를 내보내기 전에 재현 명령 파일을 열어 확인하세요.
~/project/reproduce.sh
```
#!/bin/sh
# 결과를 처음부터 다시 만드는 명령 (예시)
set -e
cd ~/project
pip install --user scikit-learn==1.5.2
python train.py --seed 0 --data /data/images/ct_2024 --out outputs/
python evaluate.py --checkpoint outputs/model.pt --out outputs/roc_curve.png
```
콘솔에 나오는 명령

이 단계는 화면의 단추를 쓰지 않아 콘솔에 새 명령이 나오지 않습니다.
자세히: IDE와 터미널에서 작업하기
7단계: 데이터가 더 필요하면
Claude에게 필요한 데이터를 말합니다. Claude는 그 데이터를 더하면 결과를 볼 수 있는 사람이 어떻게 바뀌는지 먼저 확인하고, 데이터 더하기 요청을 만든 다음 승인 링크를 줍니다. 데이터는 내가 승인한 다음에야 /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 이름으로 한 번 실행됩니다.

요청한 뒤 파일이 바뀌거나 더해지면 승인해도 실행하지 않습니다.

승인하고 실행거절

에이전트가 보낸 승인 링크를 열면 나오는 화면입니다. 예시이며, 개발 중인 화면을 옮겨 그렸습니다.

콘솔에 나오는 명령

승인 화면은 요청한 명령에 승인 번호(--approval a-0031)를 붙여 실행합니다.
명령 콘솔 개발 중인 화면
$ ws add-data ws-0012 /tables/labs --approval a-0031 완료

Added data: /tables/labs (1,256 visible files)Who can see this workspace's results: 2 of 31 people. Admins can always see.Condition: ehr_full and one of ct_research or imaging_allRan the approved request: a-0031
예시이며, 개발 중인 화면을 옮겨 그렸습니다.
자세히: Claude의 요청 승인하기
8단계: 결과 내보내기
작업공간에서 [결과 내보내기]를 누릅니다.
「내보낼 파일」에는 작업 폴더 기준 경로를 적습니다. IDE의 ~/project/outputs/model.pt 파일이라면 이렇게 적습니다: project/outputs/model.pt
「재현 명령」에는 재현 명령 파일을 적습니다: project/reproduce.sh. 대화 상자의 「볼 수 있는 사람」이 이 결과를 볼 수 있게 될 사람입니다.
Claude에게 맡기면 Claude가 결과 내보내기 요청을 만들고, 7단계처럼 승인하면 실행됩니다.
콘솔에 나오는 명령

내보내는 순간 작업 폴더와 환경이 함께 저장됩니다. 그동안 작업공간이 아주 잠깐 멈추고, 콘솔에는 멈춘 시간을 알리는 줄도 나옵니다. 여기서는 그 줄을 뺐습니다.
명령 콘솔 개발 중인 화면
$ release create --workspace ws-0012 --outputs project/outputs/model.pt project/outputs/roc_curve.png --reproduce project/reproduce.sh 완료

... Recording the input data... Saving the work folder and environment... Working out who can see it... Registering the outputsReleased: r-0139Who can see this release: 2 of 31 people. Admins can always see.Condition: ehr_full and one of ct_research or imaging_all
예시이며, 개발 중인 화면을 옮겨 그렸습니다.
자세히: 결과 내보내기
9단계: 공유 링크 보내기
다 되면 「방금 내보낸 결과」에 [공유 링크 복사]가 나옵니다. 왼쪽 메뉴 [결과]의 「내가 내보낸 결과」에서도 복사할 수 있습니다. 링크는 이런 모양입니다: https://app.example.org/r/r-0139
링크는 권한이 아니라 주소입니다. 받은 사람도 볼 권한이 있어야 열 수 있고, 열 때마다 그 사람이 지금 볼 수 있는지 확인합니다. 볼 수 없는 사람에게는 필요한 권한과 [관리자에게 요청]이 보입니다.

보이는 것

링크를 받은 사람도 볼 권한이 있어야 열 수 있습니다.

콘솔에 나오는 명령

링크 복사는 명령을 실행하지 않습니다. 볼 수 없는 사람이 [관리자에게 요청]을 누르면 그 사람의 콘솔에 이런 명령이 나옵니다.
명령 콘솔 개발 중인 화면
$ release request-access r-0139 완료

Requested access: r-0139
예시이며, 개발 중인 화면을 옮겨 그렸습니다.
자세히: 공유 링크와 권한 요청
10단계: 다 쓰면 정지
작업공간에서 [정지]를 누릅니다. 작업 환경 안에서 돌던 프로그램과 터미널(tmux, screen 포함)은 모두 끝나고, 작업 폴더와 설치한 것은 그대로 남습니다. 다시 [시작]하면 이어서 합니다.
더 쓰지 않을 작업공간은 정지한 다음 [보관]합니다. 작업 폴더와 기록, 내보낸 결과는 그대로 남고, 보관을 풀 수 있습니다.
콘솔에 나오는 명령
명령 콘솔 개발 중인 화면
$ ws stop ws-0012 완료

Stopped workspace: ws-0012The work folder stays as it is.
예시이며, 개발 중인 화면을 옮겨 그렸습니다.
자세히: 정지, 보관, 저장 공간

언제	보이는 파일	볼 수 있는 사람
지금	1,252개	4명 (전체 31명 중)
승인하면	1,256개	2명 (전체 31명 중)

1단계: 로그인하고 비밀번호 정하기

2단계: Claude 연결 (한 번만)

3단계: 내 데이터 둘러보기

4단계: 새 작업공간 만들기

5단계: 시작하고 IDE 열기

6단계: Claude Code와 작업하기

7단계: 데이터가 더 필요하면

8단계: 결과 내보내기

9단계: 공유 링크 보내기

10단계: 다 쓰면 정지

다음에 읽을 것