AI Workspace
로컬 장치에서 Codex, Claude Code 또는 VS Code를 사용하여 원격 장치에서 명령을 실행하고 프로젝트 파일을 편집합니다. FlashDesk가 연결 설정을 처리합니다.
내용물
개요
AI Workspace는 원격 장치에 대해 로컬 AI 도구를 사용하기 위한 FlashDesk 작업 공간입니다. AI 도구는 운영자 장치에서 실행되는 반면 원격 장치에 대한 명령은 필요할 때 SSH를 통해 실행됩니다.
기본 사용법
원격 장치에서 AI Workspace를 활성화합니다.
원격 장치의 FlashDesk 설정에서 AI Workspace 및 SSH 연결 권한을 활성화합니다.
운영자 장치에서 AI Workspace를 엽니다.
대상 장치를 선택하고 AI Workspace를 엽니다. FlashDesk는 로컬 작업 공간 폴더를 만들고, SSH 도우미 파일을 생성하고, 임시 SSH 키를 원격 장치와 자동으로 교환합니다.
작업 방법을 선택하세요
직접적인 일회성 작업을 위해 SSH 명령 작업을 선택하거나, Local Mirror를 생성하고 로컬에서 파일을 편집하려는 경우 프로젝트 편집을 선택하십시오.
AI 도구 열기
AI Workspace 창에서 Codex 또는 Claude Code를 엽니다. FlashDesk는 선택한 도구에 대한 지침 파일을 작업 공간에 기록합니다.
명령 실행 또는 파일 편집
SSH 명령 작업의 경우 AI 도구에 생성된 도우미를 통해 원격 명령을 실행하도록 요청하세요. 프로젝트 편집의 경우 Local Mirror 파일을 편집한 다음 FlashDesk로 돌아와 차이점을 검토하고 적용합니다.
당신이 할 수 있는 일
- Codex, Claude Code, VS Code 또는 FlashDesk의 작업 공간 폴더를 엽니다.
- SSH를 통해 원격 장치에서 명령을 실행합니다.
- 선택한 원격 프로젝트의 Local Mirror를 생성하고 로컬에서 편집합니다.
- 원격 장치에 다시 적용하기 전에 Local Mirror 변경 사항을 검토하세요.
- AI 도구 지침 파일에 자동으로 병합되는 원격 장치마다 Custom instructions를 그대로 둡니다.
작동 원리
| 목 | 설명 |
|---|---|
AI Workspace |
FlashDesk 연결을 위해 생성된 로컬 작업 디렉터리입니다. |
.flashdesk-workspace/ssh_config |
선택한 원격 장치에 대해 FlashDesk가 생성한 SSH 구성 및 도우미 스크립트입니다. AI 도구는 이러한 파일을 직접 편집하는 대신 도우미 명령을 사용해야 합니다. |
.flashdesk-workspace/identity |
현재 AI Workspace에 대해 FlashDesk에 의해 생성된 임시 SSH ID입니다. FlashDesk는 이를 원격 장치에 자동으로 등록하고 AI Workspace가 닫히면 제거합니다. |
AGENTS.md / CLAUDE.md |
해당 AI 도구를 열 때 생성되는 명령 파일입니다. 또한 FlashDesk는 해당 콘텐츠를 검색된 Host OS(Windows 대 POSIX)에 맞게 조정하고 Custom instructions가 업데이트될 때 다시 생성합니다. |
| Local Mirror | 선택한 원격 프로젝트의 로컬 복사본입니다. 사용자는 변경 사항을 원격 장치에 다시 적용하기 전에 검토할 수 있습니다. |
작업 공간 모드
SSH 명령 작업
로그 확인, 파일 나열, 서비스 다시 시작, 확인된 작은 변경 등 원격 장치에서 직접 일회성 작업을 수행하려면 이 모드를 사용하세요.
Local Mirror를 사용한 프로젝트 편집
원격 프로젝트를 로컬에서 편집하려면 이 모드를 사용하십시오. FlashDesk는 선택한 원격 파일이나 폴더를 Local Mirror에 복제합니다. 편집 후 FlashDesk의 차이점을 검토하고 선택한 변경 사항만 원격 장치에 다시 적용합니다.
Custom instructions
Custom instructions를 사용하면 AI 도구가 이 작업 공간에서 따라야 하는 코딩 규칙, 사용할 패키지 관리자, 접촉을 피하기 위한 분기, 승인 규칙, 일반적으로 모든 세션이 시작될 때 반복하는 모든 사항에 대한 메모를 남길 수 있습니다.
- AI Workspace 창에서 폴더 열기 옆에 있는 Custom instructions 버튼을 사용하여 엽니다.
- 원격 장치별로 저장되므로 각 프로젝트마다 고유한 스탠딩 노트를 가질 수 있습니다.
Custom instructions(항상 따라옴)섹션 아래의AGENTS.md/CLAUDE.md에 병합되었으므로 Codex 및 Claude Code가 자동으로 선택됩니다. 기존 지침 파일은 저장할 때마다 다시 작성됩니다.
운영 참고 사항
- AI Workspace는 기본적으로 꺼져 있으며 원격 장치에서 허용되어야 합니다.
- 원격 장치는 SSH 연결도 허용해야 합니다.
- SSH를 사용하여 원격 장치에서 파일을 생성, 덮어쓰기, 이동 또는 삭제하기 전에 원격 장치 사용자에게 문의하십시오.
- Local Mirror를 사용하는 경우 사용자가 FlashDesk에서 차이점을 확인한 후에만 변경 사항을 원격 장치에 적용하십시오.
- 파일이 크면 Local Mirror 생성 속도가 느려질 수 있습니다. FlashDesk는 대용량 파일을 포함할지 아니면 건너뛸지 묻는 메시지를 표시할 수 있습니다.