안내서
Claude의 요청 승인하기
작업공간 안의 Claude나 터미널이 데이터 더하기나 결과 내보내기를 요청하면, 무엇이 바뀌는지 보고 승인하거나 거절합니다.
개발 중인 화면
이 페이지에서
포털 화면은 개발 중입니다. 화면의 낱말과 배치는 바뀔 수 있고, 단추가 실행하는 명령은 이미 만들어져 있습니다.
작업공간 안의 Claude와 터미널은 데이터를 더하거나 결과를 내보내는 일을 스스로 하지 못하고, 요청만 할 수 있습니다. 요청은 내가 보고 승인해야 실행됩니다. 아이디, 경로, 수는 예시입니다.
무엇이 승인을 기다리나
- 승인이 필요한 것. 작업공간 안에서, 곧 Claude나 작업공간 터미널에서 요청한 데이터 더하기와 결과 내보내기입니다.
- 승인이 필요 없는 것. 코드를 돌리는 일,
/data에서 읽는 일, 허용된 인터넷을 쓰는 일, 패키지 설치입니다. 포털에서 내가 직접 누른 [데이터 더하기]와 [결과 내보내기]도 바로 실행됩니다. - 작업공간 안의 범위. 작업공간 안에서는 주인이 관리자여도 관리자 권한이 없고, 다른 작업공간의 요청은 보이지 않습니다.
요청 찾기
- Claude가 주는 승인 링크. 요청을 만들면 Claude가 승인 링크를 알려 줍니다. 모양은 이렇습니다:
https://app.example.org/approve/a-0031 - 왼쪽 메뉴의 [승인 요청]. 기다리는 요청이 있으면 메뉴 옆에 수가 나옵니다. 목록에서 요청을 고르고 [열어서 결정]을 누릅니다. 「처리한 요청도 보기」를 켜면 끝난 요청도 보입니다.
- 작업공간 목록의 「요청」 칸. 그 작업공간에서 기다리는 요청 수가 나오고, 누르면 그 작업공간의 요청만 봅니다.
승인 화면 읽기
승인 요청 개발 중인 화면
데이터 더하기 요청 a-0031
Claude가 이 작업공간에 데이터를 더하려고 합니다.
- 요청한 곳
ws-0012- 더할 데이터
/tables/labs(4개)
| 언제 | 보이는 파일 | 볼 수 있는 사람 |
|---|---|---|
| 지금 | 1,252개 | 4명 (전체 31명 중) |
| 승인하면 | 1,256개 | 2명 (전체 31명 중) |
실행할 명령
ws add-data ws-0012 /tables/labs 승인하면 위 명령이 kim 이름으로 한 번 실행됩니다.
요청한 뒤 파일이 바뀌거나 더해지면 승인해도 실행하지 않습니다.
승인하고 실행거절
- 제목. 「데이터 더하기 요청」인지 「결과 내보내기 요청」인지와 요청 ID입니다.
- 누가 요청했나. 「Claude가 이 작업공간에 데이터를 더하려고 합니다.」처럼 요청한 곳을 적습니다. 작업공간 터미널에서 온 요청은 그렇게 적습니다.
- 바뀌는 것. 「지금」과 「승인하면」의 보이는 파일 수(결과 내보내기라면 내보내는 파일)와 볼 수 있는 사람입니다. 화면을 열 때 지금 기준으로 다시 계산하고, 요청한 뒤 권한이 바뀌었으면 그렇다고 알려 줍니다.
- 내보낼 파일. 결과 내보내기 요청에는 파일마다 크기와 SHA-256 앞 12자, 재현 명령, 대체할 결과가 나옵니다. 그림 파일은 미리 볼 수 있습니다.
- 실행할 명령. 승인하면 실행될 명령 그대로입니다. 「승인하면 위 명령이 kim 이름으로 한 번 실행됩니다.」
승인하고 실행, 또는 거절
[승인하고 실행]을 누르면 요청한 명령이 그대로, 내 이름으로, 한 번 실행됩니다. 진행 상황은 화면 아래 콘솔에 나옵니다. 명령을 고쳐서 실행할 수는 없습니다. 다른 것을 원하면 거절하고 Claude에게 다시 요청하게 하세요.
명령 콘솔 개발 중인 화면
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 synapse approval reject a-0033 Rejected request: a-0033 실행되지 않는 경우
- 파일이 바뀐 결과 내보내기. 「요청한 뒤 파일이 바뀌거나 더해지면 승인해도 실행하지 않습니다.」 바뀌었으면 「요청한 뒤 내보낼 파일이 바뀌어 실행하지 않았습니다.」가 나옵니다. Claude에게 다시 요청하게 하세요.
- 이미 처리한 요청. 한 요청은 한 번만 실행됩니다. 다시 누르면 「이미 처리한 요청입니다」가 나옵니다.
- 보관한 작업공간. 작업공간을 보관하면 기다리던 요청은 거절됩니다.
- 실행이 중단된 요청. 실행하던 중에 서버가 멈추는 등으로 끝나지 못했으면 「실행이 중단되어 다시 승인할 수 있습니다.」가 나옵니다. 이미 끝난 일이면 다시 실행되지 않습니다.
- 실행하다 실패한 요청. 사유를 보고 「고친 다음 다시 승인하거나 거절할 수 있습니다.」
작업공간마다 기다리는 요청은 기본 10개까지입니다.
왜 서버에서 승인하나
Claude Code에도 실행 전에 묻는 확인 창이 있지만, 에이전트가 같은 일을 다른 길로 부르면 건너뛸 수 있습니다. 그래서 승인은 서버가 지킵니다. 요청은 서버에 남고, 내가 포털에서 승인해야만 실행됩니다.