---
title: AI 연결 시작
description: ChatGPT·Claude·코딩 에이전트 중 사용하는 도구를 연결하고 기존 정보를 읽기 전용으로 확인하세요.
url: https://docs.thegram.one/ko/guides/quickstart/
lang: ko
tier: current
editorial_sources:
  - https://thegram.one/install/agents.md
  - https://thegram.one/install/chatgpt.md
---

# AI 연결 시작

## 사용할 AI 선택 {#h0-1}

데스크톱 앱이나 DMG 없이 이미 사용하는 도구를 연결합니다.

<div class="tg-client-grid">
<a class="tg-client-card" href="/ko/guides/cloud-setup/#h0-6"><strong>ChatGPT</strong><span>플러그인 · OAuth</span></a>
<a class="tg-client-card" href="/ko/guides/cloud-setup/#h0-8"><strong>Claude</strong><span>커스텀 커넥터 · OAuth</span></a>
<a class="tg-client-card" href="/ko/guides/local-setup/"><strong>코딩 에이전트</strong><span>Claude Code, Codex, OpenCode, OMP</span></a>
</div>

## 연결 전에 준비할 것

- 본인의 Thegram 계정과 사용할 Vault에 대한 접근 권한.
- 코딩 에이전트는 Node.js 22+와 최신 plugin, 필요한 범위만 허용한 API key.
- ChatGPT·Claude는 본인의 provider 계정과 직접 검토하는 로그인·동의 절차. 커넥터만 연결한다고 memory skill까지 설치되지는 않습니다.

## 쓰지 않고 확인하기 {#h0-16}

연결한 AI에게 아래처럼 요청하세요.

```text
이 Thegram 연결로 접근할 수 있는 공간을 보여줘. 기존 프로젝트 문서가 있다면 개요를 읽고 결정 하나와 그 근거를 알려줘. 생성·수정·이동·삭제·공유는 하지 마. 비어 있거나 권한이 없으면 그 상태를 그대로 설명해줘.
```

**정상 결과:** 허용된 기존 정보와 출처를 보여주거나, 빈 공간·권한 오류를 명확히 설명합니다. 빈 Vault는 연결 실패가 아닙니다. 연결을 증명하려고 샘플 문서를 만들지 마세요.

## 코딩 프로젝트를 찾지 못했다면

현재 plugin은 API key가 읽을 수 있는 Vault 문서에서 정확한 repository tag를 가진 **기존 project record**를 찾습니다. 선택한 Vault에서 경로를 추정하거나, association이 없다고 새 문서를 만들지 않습니다. 같은 origin의 worktree는 identity를 공유하고, Git 저장소가 아닌 폴더는 identity를 자동 추정하지 않습니다.

[기존 프로젝트 연결](/ko/guides/local-setup/#h0-19)을 확인하세요. 오류를 피하려고 다른 Vault나 문서로 바꾸지 마세요.

## 읽기·저장·검색 구분

읽기는 읽기 권한으로 가능합니다. 저장은 쓰기 권한 외에도 **저장할 내용과 정확한 대상에 대한 명시적 승인**이 필요합니다. 승인한 저장 후에는 해당 경로를 직접 읽고, 검색은 색인 상태를 별도로 확인하세요.

다음: [권한](/ko/guides/permissions/) · [결정 찾기와 인수인계](/ko/guides/workflows/) · [연결 문제 해결](/ko/guides/troubleshooting/).