ComAsNasAI 에이전트 · 미리보기
Claude Code·Codex에서 ComAsNas 쓰기
미리보기 — 아직 출시 전
Claude Code나 Codex 클라우드 세션에 프롬프트 하나를 붙여 넣으면, 에이전트가 내 Mac이나 Windows PC의 공유 폴더에서 파일을 다룰 수 있어요. 허락하면 Mac에서 명령도 실행해요. 모든 통신은 iPhone 앱과 같은 끝단 암호화 중계를 거치고, 언제든 끊을 수 있어요.
이 페이지는 미리보기 빌드를 설명해요. npx comasnas는 출시 때 공개되며, 그전에는 아래 명령을 쓸 수 없어요.
할 수 있는 일
- 클라우드 코딩 세션에서 공유 폴더의 파일을 읽고, 쓰고, 옮기고, 이름을 바꿔요.
- 원하면 Mac에서 명령을 실행해요(기본은 꺼짐, 켜면 샌드박스 안에서).
- 평소 말로 공유 폴더를 검색하고, ComAsNas 어시스턴트에게 파일에 대해 물어요.
안전장치
- 공유 폴더 안에서만
- 연결은 내가 공유한 폴더만 볼 수 있어요. 그 밖의 경로,
..같은 우회, 심볼릭 링크는 거부돼요. - 한 번만 쓰는 초대
- 프롬프트 속 초대는 10분 동안 한 번만 쓸 수 있어요. 비밀 코드는 그대로 전송되지 않아요.
- 읽기 전용 선택
- 기본은 파일 읽기·쓰기이고, 읽기 전용으로도 줄 수 있어요.
- 명령 실행은 기본 꺼짐
- 켜면 macOS 샌드박스 안에서 실행돼 공유 폴더·임시 폴더 밖에는 쓰지 못해요. 전체 권한은 경고와 함께 따로 골라야 해요. 처음엔 Mac에서만 지원해요.
- 만료
- 연결은 기본 30일 뒤 만료돼요(1일·7일·무기한 선택 가능).
- 언제든 끊기
- 메뉴 막대에서 연결마다 해제할 수 있고, 그 연결의 명령도 멈춰요. "모두 중지"로 실행 중인 명령을 한 번에 멈춰요.
- 모든 요청 기록
- 에이전트의 요청과 명령의 시작·끝이 내 컴퓨터의 기록에 남아요.
- 지우기는 휴지통으로
- 파일을 지우면 휴지통으로 옮겨질 뿐, 바로 삭제되지 않아요.
설정 방법
내 컴퓨터에서: ComAsNas 메뉴 막대 → 클라우드 세션 연결… → 옵션 고르기 → 프롬프트 복사. 프롬프트는 한 문장과 npx -y comasnas@latest connect comasnas-connect-v1:…로 되어 있어요. 그다음 클라우드 환경마다 한 번, 중계 접속을 허용해요.
Claude Code(클라우드)
- 환경 설정 → Network access → Custom을 열어요.
relay.comasnas.com을 추가해요. "include default list"는 켜 둬요.- 세션에 프롬프트를 붙여 넣어요. 에이전트가 명령을 실행해 내 컴퓨터와 짝을 맺고 짧은 사용법을 출력해요.
Codex(클라우드)
- 환경 설정 → agent internet access를 열어요.
relay.comasnas.com을 허용해요.- 작업에 프롬프트를 붙여 넣어요. 에이전트가 명령을 실행해 짝을 맺고 사용법을 출력해요.
중계 접속이 막혀 있으면 comasnas connect가 감지한 플랫폼에 맞는 설정 방법을 출력하고 멈춰요. ComAsNas는 플랫폼의 네트워크 허용 목록을 우회하지 않아요. 설정 이름은 2026년 10월 기준이며 바뀔 수 있어요.
명령 목록
연결 뒤 에이전트가 쓸 수 있는 명령이에요(comasnas guide로도 출력되며, --json을 붙이면 기계가 읽기 좋은 출력). 경로는 내 컴퓨터의 경로예요. 명령과 설명은 실제 출력 그대로 영어예요.
| 명령 | 하는 일 |
|---|---|
comasnas status | 컴퓨터 이름, 공유 폴더, 권한 |
comasnas ls [-l] [PATH] | 폴더 목록(경로 없으면 공유 폴더) |
comasnas stat PATH | 항목 하나의 정보 |
comasnas cat PATH | 파일 내용 출력 |
comasnas get REMOTE [LOCAL] | 클라우드 세션으로 내려받기 |
comasnas put LOCAL REMOTE [--overwrite] | 클라우드 세션에서 올리기 |
comasnas mkdir [-p] PATH | 폴더 만들기 |
comasnas mv [--overwrite] FROM TO | 옮기기·이름 바꾸기 |
comasnas rm PATH | 휴지통으로 옮기기(바로 지우지 않음) |
comasnas find [--plain] [--limit N] QUERY | 평소 말로 공유 폴더 검색 |
comasnas ask [--apply] REQUEST | 파일에 대해 Claude에게 묻거나 변경 계획 받기 |
comasnas apply TASK | ask가 만든 계획 적용(사용자가 원할 때만) |
comasnas exec [--detach] [--cwd DIR] [--timeout S] [--env K=V] -- COMMAND | 명령 실행(명령 실행을 켠 경우만, Mac) |
comasnas jobs · logs [-f] JOB · kill [--force] JOB | 실행한 명령 목록·출력 보기·멈추기 |
comasnas guide · disconnect | 사용법 다시 보기 · 이 연결 지우기 |
실제 실행 기록 보기
2026-10-08 미리보기 빌드의 실제 실행 기록(연결, 목록, 읽기, 8.6 MB 올리기·내려받기, 휴지통, 공유 폴더 밖 경로 거부, 샌드박스 거부, 연결 해제)은 홈 화면에 있어요.
자주 묻는 질문
무엇이 어디로 가나요?
클라우드 세션과 내 컴퓨터 사이의 파일 데이터와 명령은 relay.comasnas.com을 거치며 끝단 암호화돼요. 중계 서버는 내용을 볼 수 없고 파일을 저장하지 않아요. comasnas ask는 동의한 뒤에만 요청 내용과 Claude가 고른 파일의 텍스트(공유 폴더 안만)를 ComAsNas 서버를 거쳐 Anthropic의 Claude로 보내고, 서버는 이를 저장하지 않아요. comasnas find는 검색 문장만 보내요.
지금 쓸 수 있나요?
아니요. 미리보기이며 아직 출시 전이에요. 파일 앱 기능의 Mac·Windows 앱은 지금 다운로드할 수 있어요.
Windows도 되나요?
파일 다루기는 돼요. 명령 실행은 처음엔 Mac에서만 지원해요.
어떻게 멈추나요?
ComAsNas 메뉴 막대에서 그 연결의 해제를 누르거나 만료를 기다리면 돼요. 에이전트의 다음 명령은 "거부됨(해제 또는 만료)"으로 끝나요.
Anthropic이나 OpenAI와 관계가 있나요?
없어요. Claude와 Claude Code는 Anthropic, Codex는 OpenAI의 제품이에요. ComAsNas는 Hael Song이 만드는 독립 앱이에요.