> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-ko/scene-editor/extend-with-code/ai-assistant.md).

# AI 어시스턴트

Creator Hub 안에서 AI 어시스턴트와 채팅하며 씬을 만들고 변경하세요.

Creator Hub는 열린 씬을 보고 대신 편집해 주는 AI 어시스턴트를 실행할 수 있습니다. 아이템 배치, 동작 연결, 스크립트 작성, 미리보기 실행 및 결과 확인을 요청할 수 있습니다.

어시스턴트는 실험 기능이며 기본적으로 꺼져 있습니다.

{% hint style="warning" %}
**📔 참고**: 어시스턴트는 설치하고 로그인하는 코딩 CLI를 실행하며, 머신에 대한 전체 액세스 권한을 가지므로 터미널에서와 동일한 범위로 접근합니다. 요청한 작업을 신뢰할 수 있을 때만 활성화하세요.
{% endhint %}

## 켜기

1. 설정(오른쪽 상단의 톱니바퀴 아이콘)을 엽니다.
2. 다음으로 이동: **실험적** 탭.
3. 켜기 **AI 어시스턴트 활성화**.

활성화되면 **AI 어시스턴트** 버튼이 편집기 상단 바에 나타납니다. 이를 클릭하면 씬 옆에 채팅 패널이 열립니다.

## 코딩 CLI 연결

어시스턴트는 자체 API 키를 사용하지 않습니다. 설치하고 로그인하는 코딩 CLI를 실행하므로, 작업 비용은 해당 도구 자체 구독으로 청구됩니다.

다음 두 가지가 지원됩니다:

| CLI         | 설치                                   | 로그인           |
| ----------- | ------------------------------------ | ------------- |
| Claude Code | `npm i -g @anthropic-ai/claude-code` | `claude`      |
| Codex       | `npm i -g @openai/codex`             | `codex login` |

Creator Hub 내부에서 할 수 있습니다. 설정에서 **연결**아래에서, 감지된 각 CLI의 상태와 **로그인** 로그인을 실행하고 브라우저를 여는 링크가 표시됩니다. 초록색 점과 **연결됨** 은 준비되었음을 의미합니다. **로그아웃** 하면 연결이 끊깁니다.

직접 하려면 **터미널을 통한** 섹션을 CLI 아래에서 엽니다. 정확한 **설치** 및 **로그인** 명령을 복사할 수 있습니다.

CLI가 연결되지 않은 상태로 처음 열면 같은 설정 카드가 채팅 패널 자체에 나타납니다.

{% hint style="info" %}
**💡 팁**: 로그인된 CLI가 두 개 이상 있으면, 채팅 패널의 드롭다운으로 전환할 수 있습니다.
{% endhint %}

### 대신 API 키로 청구

CLI 구독 대신 토큰당 요금을 내고 싶다면, 설정에서 **대신 이 비용을 API 키로 청구** 를 켜세요. 다음을 읽습니다. `ANTHROPIC_API_KEY` 또는 `OPENAI_API_KEY` 를 환경에서 가져옵니다. 기본적으로 꺼져 있습니다.

## 할 수 있는 일

어시스턴트는 열려 있는 씬에서 작업합니다. 할 수 있는 일:

* **씬 편집**: 엔티티 생성 및 삭제, 컴포넌트 변경, 배치 [스마트 아이템](/creator/content-creator-ko/scene-editor/interactivity/smart-items.md), 연결 [스크립트](/creator/content-creator-ko/scene-editor/extend-with-code/script-component.md), 그리고 읽고 쓰기 `scene.json`.
* **코드 작성** 씬 파일 내에서.
* **미리보기 실행** 및 제어: 스크린샷 찍기, 돌아다니기, 클릭하기, 로그 읽기, 성능 확인.
* **선택 항목 읽기**, 따라서 엔티티를 선택하고 "이것을 더 크게 만들어"라고 말할 수 있습니다.

변경 사항은 발생하는 즉시 저장되며 일반 실행 취소 기록에 들어갑니다. 전체 대화를 한 번에 되돌리려면 **AI 변경 사항 실행 취소** 를 어시스턴트의 답변에서 사용하세요.

## 채팅 사용하기

* **새 채팅** 새로운 대화를 시작합니다.
* **채팅 기록** 에는 얼마나 전에 실행되었는지와 함께 이전 대화가 나열됩니다. 대화는 프로젝트별로 저장되므로, 씬을 다시 열면 해당 채팅이 돌아옵니다.
* **별도 창에서 열기** 는 어시스턴트를 별도 창으로 분리하며, 두 번째 모니터에서 유용합니다. **편집기에 다시 도킹** 하면 돌아옵니다.
* 패널은 더 넓게 또는 더 좁게 드래그할 수 있습니다.

하나의 **AI 사용 정보** 카드는 어시스턴트가 연결된 계정의 토큰을 사용함을 알려줍니다. 해당 계정의 사용량을 주시하세요.

Claude CLI가 너무 오래되었다면, 패널에 경고가 표시됩니다. 다음을 실행하세요: `claude update` 를 터미널에서 실행해 수정하세요.

## Decentraland skills가 설치됩니다

어시스턴트가 실행되면, Creator Hub는 공식 [Decentraland SDK Skills](/creator/content-creator-ko/sdk7/getting-started/vibe-coding.md) 를 다운로드해 프로젝트에 연결하므로, 어시스턴트가 추측하는 대신 검증된 SDK7 패턴을 따릅니다.

이들은 다음에 연결됩니다 `.claude/skills` 및 `.agents/skills` 프로젝트 폴더 안에 있으며, 두 항목 모두 `.gitignore` 에 추가되어 저장소에 들어가지 않습니다.

## 대신 자신의 AI 도구 사용

이미 Claude Code, Cursor, Codex, 또는 MCP를 지원하는 다른 도구를 사용 중이라면, 내장 패널 대신 열린 씬을 대상으로 지정할 수 있습니다. MCP(Model Context Protocol)는 AI 도구가 다른 프로그램을 호출할 수 있게 하는 표준 방식입니다.

1. 설정에서 **실험적** 탭 아래에서 **AI 어시스턴트 MCP 서버 노출**.
2. 클릭 **구성 복사**.
3. 이를 도구의 MCP 구성에 붙여넣으세요.

복사된 구성은 실제 포트와 토큰이 채워진 상태로 다음과 같습니다:

```json
{
  "mcpServers": {
    "creator-hub": {
      "type": "http",
      "url": "http://127.0.0.1:<PORT>/mcp",
      "headers": { "Authorization": "Bearer <TOKEN>" }
    }
  }
}
```

Claude Code의 경우, 대신 씬 폴더의 터미널에서 다음을 추가할 수 있습니다:

```bash
claude mcp add --transport http --scope local creator-hub http://127.0.0.1:<PORT>/mcp \
  --header "Authorization: Bearer <TOKEN>"
```

{% hint style="warning" %}
**📔 참고**: Creator Hub가 시작될 때마다 포트와 토큰이 새로워집니다. 도구에 갑자기 `401` 오류가 발생하면 구성을 다시 복사하세요. 서버는 자신의 컴퓨터에서만 수신하며, 항상 열려 있는 씬에만 작동합니다.
{% endhint %}

## 관련 페이지

* [AI와 함께하는 바이브 코딩](/creator/content-creator-ko/sdk7/getting-started/vibe-coding.md): SDK Skills 및 잘 프롬프트하는 방법에 대한 전체 가이드.
* [코드와 결합](/creator/content-creator-ko/scene-editor/extend-with-code/overview.md): 코드 편집기에서 씬을 엽니다.
* [스크립트 컴포넌트 사용하기](/creator/content-creator-ko/scene-editor/extend-with-code/script-component.md): 파일에서 엔티티에 동작을 연결합니다.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.decentraland.org/creator/content-creator-ko/scene-editor/extend-with-code/ai-assistant.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.