# 에이전트 연결하기

> Nolan Edit은 nolanlabs에 함께 들어 있습니다. 또는 Claude Code, Codex, Gemini CLI, 모든 ACP 에이전트를 각자의 로그인으로 실행할 수 있습니다. 각각 필요한 것과 내 에이전트를 추가하는 방법.

Page: https://nolanlabs.io/ko/docs/agents

앱에는 에이전트가 함께 들어 있습니다. nolanlabs가 운영하는 모델 NolanX로 동작하는 Nolan Edit입니다. 또는 이미 가진 에이전트를 내 계정으로 채팅에서 실행할 수도 있습니다. 이 페이지는 어떤 에이전트가 동작하고 각각 무엇이 필요한지 설명합니다.

## Nolan Edit

Nolan Edit은 nolanlabs에 내장된 에이전트이고, NolanX는 Nolan Edit이 동작하는 모델입니다. 앱을 처음 열면 Nolan Edit을 권하고, 그 뒤로는 채팅 맨 위의 선택기에 nolanlabs 마크와 모델 이름 **NolanX**와 함께 나옵니다. 따로 설치할 것도, 다른 계정도 없습니다. 앱이 알아서 설정하고, 설정이 끝날 때까지 선택기에 **준비 중…**이라고 나옵니다.

- **크레딧.** NolanX 사용량은 크레딧으로 셉니다. 플랜이 없어도 모든 계정에 매달 100 크레딧이 있습니다. 타이틀이나 트림 같은 작은 수정에는 약 4 크레딧이 듭니다. Nolan Edit을 골라 두면 채팅 헤더에서 모델 이름 뒤에 남은 크레딧이 나오고, **설정** > **계정**에서 이번 달 사용량과 플랜을 **요금제 보기**(유료 플랜이라면 **요금제 관리**)와 함께 볼 수 있습니다. 0이 되면 다음 달 1일까지, 또는 더 큰 플랜으로 옮길 때까지 멈추고 그 사실을 알려 줍니다. 편집기와 다른 에이전트는 계속 동작합니다. 하루 한도도 있습니다. 더 많이 들어 있는 플랜은 [요금](https://nolanlabs.io/ko/pricing)에 있고, 플랜을 사고, 바꾸고, 취소하는 방법은 [플랜과 결제](https://nolanlabs.io/ko/docs/plans)에 있습니다.
- **먼저 묻는 것.** 타임라인 편집, 파일 읽기, 프레임 보기는 묻지 않고 합니다. 셸 명령, 파일 쓰기, 웹, 미디어 가져오기, 렌더링, 설정 변경은 각각 채팅에서 당신의 답이 필요합니다. **Allow once**, **Always allow**, **Deny** 중에서 고릅니다.
- **컴퓨터 밖으로 나가는 것.** 당신이 쓴 내용, 프로젝트에서 읽은 것, 보는 프레임은 nolanlabs.io를 거쳐 NolanX를 운영하는 회사로 갑니다. nolanlabs.io는 사용 횟수만 기록하고 그 내용은 절대 남기지 않으며, 그 횟수를 PostHog로 보내 nolanlabs가 확인합니다. [개인정보 처리방침](https://nolanlabs.io/privacy#nolanx)을 보세요.
- **스튜디오에서.** 앱 폴더에 `{"models": "off"}`라고 적힌 `policy.json` 파일을 두면 그 컴퓨터에서 Nolan Edit이 꺼지고, 선택지에도 나오지 않습니다.

Nolan Edit은 앱이 홈 폴더에 설치하는 Claude Code 위에서 동작합니다. Claude 계정은 필요 없습니다.

## 내 에이전트

채팅 맨 위에서 하나를 고르세요. 선택기에는 에이전트마다 이 컴퓨터에서의 상태가 나옵니다.

| 에이전트 | 필요한 것 |
| --- | --- |
| **Nolan Edit** | 로그인한 nolanlabs 계정. 위를 보세요 |
| **Claude Code** | 이 컴퓨터에 설치하고 로그인한 Claude Code |
| **Codex** | 설치하고 로그인한(`codex login`) Codex와 그 ACP 어댑터 `codex-acp` |
| **Gemini CLI** | 설치한 Gemini CLI와 유료 Gemini API 키, 또는 Gemini Code Assist Standard나 Enterprise 플랜. Google은 2026년 6월 18일에 [개인 로그인을 종료](https://developers.googleblog.com/an-important-update-transitioning-gemini-cli-to-antigravity-cli/)했습니다(무료, AI Pro, Ultra) |
| 내 에이전트 | ACP(Agent Client Protocol)를 지원하는 모든 에이전트와 그 실행 명령 |

nolanlabs에 붙여 넣을 키는 없습니다. 모든 에이전트가 같은 여덟 가지 도구를 받으므로, 각 에이전트는 버튼과 같은 작업으로 동작합니다. 질문 카드와 계획 카드는 Nolan Edit과 Claude Code에만 있습니다.

## 상태 표시의 뜻

선택기에서 에이전트마다 옆에 표시가 붙습니다.

| 표시 | 뜻 |
| --- | --- |
| **로그인됨**, 또는 플랜 이름 | 설치되어 있고 로그인되어 있습니다. 골라서 부탁하세요 |
| **로그인하지 않음** | 에이전트는 있지만 계정이 로그인되어 있지 않습니다. 에이전트 자체 명령으로 로그인하세요 |
| **설치 안 됨** | 에이전트나 그것을 연결하는 부분이 없습니다. 예를 들어 `codex-acp`가 없는 Codex |
| **Not on this computer** | Claude Code가 설치되어 있지 않습니다 |
| **Sets itself up when you pick it** | 처음 쓰기 전의 Nolan Edit. 고르면 앱이 필요한 것을 설치합니다 |

## Claude Code와 함께 오는 것

Claude Code 에이전트는 프로젝트 폴더에서 열리는 온전한 Claude Code 세션이며, 여기에 편집기의 도구가 더해집니다. 제한이 걸려 있지 않습니다.

- 자체 셸, 파일, 웹, 서브에이전트, 할 일 목록.
- 내 Claude Code 설정, `CLAUDE.md`, 스킬(`~/.claude`에 있는 것), 그리고 편집기의 자체 스킬.
- 프로젝트 폴더에서는 `CLAUDE.md`와 `.claude/skills`만 읽습니다. 그 폴더의 설정, 훅, MCP 서버, `CLAUDE.local.md`, `.claude/rules`는 읽지 않으므로, 누군가 보내 준 폴더가 스스로 무언가를 실행할 수는 없습니다.
- 턴 수 제한도, 자체 도구 시간 제한도 없습니다. 대화가 길어지면 스스로 압축합니다.

## 내 에이전트 추가하기

선택기 맨 아래의 **내 에이전트 추가…**를 고르거나, 앱 데이터 폴더의 `agents.json`을 편집하세요.

```json
{
  "default": "claude",
  "agents": [
    { "id": "my-agent", "name": "My agent", "command": "/usr/local/bin/my-agent", "args": ["--acp"] }
  ]
}
```

`default`는 채팅이 시작할 때 쓰는 에이전트입니다. 편집기는 대화마다 첫 메시지와 함께 모든 에이전트에게 짧은 지침을 주므로, 편집기를 전혀 모르는 에이전트도 같은 방식으로 동작합니다.

## 에이전트가 닿을 수 있는 곳

타임라인은 제안을 통해서만 바뀌며, 제안은 한 단계로 되돌릴 수 있습니다. [제안](https://nolanlabs.io/ko/docs/proposals)을 보세요.

미디어 가져오기, 렌더링, 설정 변경, 자체 셸·파일·웹 사용은 보기만 하는 경우가 아니라면 모두 채팅에서 당신의 답이 필요합니다. **프로젝트 설정 › 에이전트 권한**에서 이를 “묻지 않고 모두 사용”으로 바꿀 수 있습니다. 에이전트는 이 설정을 스스로 바꿀 수 없습니다.

열린 프로젝트마다 그 프로젝트 폴더에서 실행되는 에이전트 프로세스가 따로 있으며, 어느 것도 다른 프로젝트에 닿을 수 없습니다.

에이전트가 보는 프레임은 당신이 고른 에이전트에게 전달되며, 채팅에 붙여 넣은 그림도 마찬가지입니다. 푸티지 자체는 디스크의 원래 자리에 그대로 있습니다.

## 다음

[첫 컷](https://nolanlabs.io/ko/docs/first-cut)을 만들거나, [채팅](https://nolanlabs.io/ko/docs/chat)에 대해 읽어 보세요.
