> ## 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.

# 계정과 키

> 엔진마다 로그인하고, API 키를 넣고, 모델을 고르고, 다른 도구에서 쓰던 설정을 가져옵니다.

## 엔진에 로그인하기

**관리 → 에이전트와 모델**을 엽니다. 엔진마다 한 줄이 있고, 설치됐는지, 로그인됐는지, 어떤 요금제인지 보입니다.

* **설치**는 없는 엔진을 설치합니다.
* **로그인**은 그 엔진의 로그인을 실행합니다. Claude Code, Codex, Kimi Code는 브라우저가 열리고, Antigravity는 터미널에서 `agy`를 실행합니다. OpenCode는 로그인 없이 무료 모델로 시작합니다.
* **사용**을 누르면 새 대화가 그 엔진으로 시작합니다. 설치되지 않았거나 로그인하지 않은 줄에는 없습니다.

로그인 정보는 엔진마다 자기 파일에 두고, Archetype은 읽지 않습니다. **계정 추가**로 같은 엔진의 다른 계정(회사용과 개인용 등)을 두고, 어느 계정으로 돌릴지 고릅니다.

브라우저가 없는 서버에서는 `claude setup-token`으로 받은 토큰을 env 파일의 `CLAUDE_CODE_OAUTH_TOKEN`에 둡니다.

## API 키

Archetype 모델은 내 API 키나 ChatGPT 계정으로 돕니다. OpenAI 줄의 **로그인**을 누르면 브라우저에 입력할 코드가 나옵니다.

제공자 줄의 **키 추가**로 키를 저장하고, **다른 키 추가**로 하나 더 넣습니다. 한 키가 거절되거나 한도에 걸리면 다음 키를 씁니다. 키는 `~/.config/archetype/env`에 한 줄에 하나씩 들어갑니다.

```bash theme={null}
ANTHROPIC_API_KEY=…
OPENAI_API_KEY=…
GEMINI_API_KEY=…        # 또는 GOOGLE_API_KEY, Google AI Studio에서 발급
OPENROUTER_API_KEY=…
```

* 나만 읽을 수 있어야 합니다(`chmod 600`). 아니면 백그라운드 서비스가 시작하지 않습니다.
* 셸에 이미 설정된 변수가 파일보다 먼저입니다.
* 백그라운드 서비스는 파일이 바뀌면 2초 안에 다시 읽습니다.

Gemini는 API 키로만 씁니다. Google 계정 로그인은 더 이상 제공하지 않습니다.

에이전트가 다른 일에 키가 필요하면, 입력이 가려진 카드로 묻습니다. 키는 대화에 들어가지 않고 `~/.local/share/archetype/secrets/`에 보관됩니다.

## 모델 고르기

> [tab] 앱
>
> 입력칸 아래 칩에서 엔진과 모델, 추론 강도를 고릅니다. [엔진](https://docs.archetype.ing/ko/use/engines.md) 참고.

> [tab] 터미널
>
> ```bash theme={null}
> /backend                     # 대화를 돌릴 것 고르기
> /backend engine:claude       # 엔진, 또는 Archetype 모델의 제공자
> /model                       # 키가 있는 모델 고르기
> /model NAME
> ```
>
> 시작할 때는 `archetype --backend claude`, `--provider anthropic`, `--model NAME`. `archetype --list-models`가 모델 목록을 보여 줍니다.

바꿔도 대화는 이어집니다. 기본 `provider`와 `model`은 사용자 설정에 둡니다. 프로젝트 설정으로는 정할 수 없습니다.

**프로필**은 함께 적용할 설정 묶음입니다. 엔진, 모델, 추론 강도, 권한 모드, 토큰맥싱을 담습니다. **관리 → 프로필**에서 지금 설정을 저장하고, 상태줄이나 `/profile NAME`으로 바꿉니다.

## 다른 도구의 설정 가져오기

첫 실행에서 **내 설정 가져오기**가 나오고, 나중에는 **관리 → 환경 가져오기**에 있습니다. 이 컴퓨터에 있는 것을 찾아 보여 주면, 가져올 것을 고릅니다.

| 가져오는 곳 | 가져오는 것 |
| - | - |
| Claude Code, Codex, Hermes, Cline, OpenCode, Goose, Aider | 지침, 스킬, MCP 서버 |

* 지침은 내 `AGENTS.md` 끝에 도구 이름 제목 아래 그대로 붙습니다. 요약하거나 고쳐 쓰지 않습니다.
* MCP 서버에 필요한 키는 설정 파일이 아니라 env 파일에 들어갑니다.
* 가져오지 않는 것: 모델과 제공자, API 키, 로그인, 권한, hook, 대화 기록. 로그인은 Archetype에서 다시 합니다.
* 찾는 동안 아무것도 실행하지 않습니다. 가져온 MCP 서버는 **지금 적용**을 누르면 시작합니다.

이 폴더에서 Claude Code로 하던 대화를 이어 가려면 대화에서 `/import`를 입력합니다. 그 대화의 사본으로 새 세션에서 이어 갑니다.


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