> ## Documentation Index
> Fetch the complete documentation index at: https://docs.archetype.ing/llms.txt
> Use this file to discover all available pages before exploring further.

# 보안

> 내 컴퓨터에 남는 것과 나가는 것, 에이전트가 할 수 있는 일, 문제를 알리는 방법.

## 남는 것과 나가는 것

대화, 기록, 메모리, 설정, 키는 내 컴퓨터에 둡니다. Archetype은 사용 데이터를 보내지 않습니다.

밖으로 나가는 것은 내가 설정한 것뿐입니다.

| 가는 곳 | 무엇 |
| - | - |
| 엔진의 모델 제공자 | 내 메시지, 그리고 답하려고 에이전트가 읽고 실행한 것 |
| 웹 검색 서비스(따로 고르지 않으면 Exa) | 에이전트의 검색어 |
| 연결한 앱과 MCP 서버 | 에이전트가 그곳에 묻는 것 |
| 추가한 채팅 채널 | 에이전트와 나눈 채팅 |
| GitHub와 models.dev | 새 릴리스 확인과 모델 목록(`ARCHETYPE_NO_NETWORK=1`이면 둘 다 하지 않음) |
| 회사의 호스트 | 회사 공간에서 한 일, 그리고 회사로 보낸 것 |

## 에이전트가 할 수 있는 일

에이전트는 [권한 모드](https://docs.archetype.ing/ko/use/approvals.md)에 따라 고치거나, 명령을 실행하거나, 무언가 보내기 전에 묻습니다. 모드와 상관없이 지키는 규칙도 있습니다.

* 프로젝트 설정은 에이전트가 할 수 있는 일을 줄일 수만 있고 넓힐 수는 없습니다. 프로젝트의 이름 있는 에이전트는 기본 에이전트를 바꾸지 못합니다.
* 폴더에 있는 엔진 자체 설정(`.cursor/`, `opencode.json` 등)은 엔진이 쓰기 전에 한 번 묻습니다.
* 다른 프로그램을 시작하는 프로그램(`sh`, `env`, `npm run`, `docker` …)은 **항상 허용**으로 남지 않고 매번 묻습니다.

**관리 → 권한**에서:

| 설정 | 하는 일 |
| - | - |
| **동작 감시** | 다른 모델이 호출을 실행 전에 검사합니다(기본은 자리에 없을 때의 호출). 막힌 호출은 내가 이어 가라고 할 때까지 일을 멈춥니다. 기본은 꺼짐. |
| **엔진을 샌드박스에서 실행** | 엔진이 쓰는 것을 대화의 폴더 안에 가둡니다. 기본은 꺼짐. |
| **엔진에 내 SSH 에이전트를 넘기지 않기** | 엔진이 SSH·GPG 에이전트 없이 시작해서, 엔진의 명령이 내 이름으로 서명할 수 없습니다. |
| **엔진이 API 키를 직접 갖지 않게 하기** | API 키로 도는 Claude Code와 Codex가 턴 동안만 쓸 수 있는 토큰을 받고, 키는 내 컴퓨터의 프록시가 붙입니다. |

## 비밀값

* 키는 나만 읽을 수 있는 `~/.config/archetype/env`에 있습니다. 앱은 키 이름만 보여 주고 값은 보여 주지 않습니다.
* 에이전트가 요청한 키는 카드에 입력하고, 대화에 들어가지 않으며, `~/.local/share/archetype/secrets/`에 저장됩니다. 에이전트는 그 파일을 읽을 수 있습니다. 기록에 키가 남지 않게 하는 것이지, 믿지 못할 에이전트에게서 지키는 것은 아닙니다.
* Codex와 다른 엔진은 자기 로그인에 쓰는 키와 `passEnv`에 적은 키만 받습니다.
* 메모리는 키처럼 보이는 글을 저장하지 않습니다.

## 플러그인

플러그인의 프로세스는 시스템 샌드박스 안에서 돕니다. 기본으로는 자기 폴더와 데이터에만 닿고 네트워크는 쓰지 못합니다. 더 필요한 것(네트워크, 내 파일)은 매니페스트에 밝힙니다. `~/.ssh`, `~/.gnupg`, 클라우드 자격 증명, Archetype의 설정과 데이터는 무엇을 밝히든 막혀 있습니다. 샌드박스가 없는 곳(Windows 등)에서는 Pairful의 플러그인만 돕니다.

## 회사의 호스트

회사의 호스트에는 회사의 대화, 프로젝트, 지식이 있습니다. 호스트를 운영하는 사람은 거기 있는 것을 읽을 수 있습니다. 내 계정은 회사 호스트가 아니라 내 Archetype에서 연결하고, 내 구독은 그곳에서도 내 요청에만 쓰입니다. [팀용 Archetype](https://docs.archetype.ing/ko/teams/overview.md) 참고.

## 취약점 알리기

공개 이슈가 아니라 이메일 [dev@pairful.ai](mailto:dev@pairful.ai)로 보내 주세요. 버전(`archetype --version`), 시스템, 재현 단계, 공격자가 얻는 것을 적어 주세요.

5영업일 안에 받았다고 답하고, 15영업일 안에 취약점인지와 심각도를 알려 드립니다. 릴리스에서 고친 뒤 권고문을 공개하고, 알려 주신 분의 이름을 함께 밝힙니다(원하지 않으면 밝히지 않습니다). 다른 문제는 [지원](https://docs.archetype.ing/ko/support.md)을 보세요.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.