Claude Code로 러스트 맵 만들기: Crucible AI 앱 연결

빠른 답: Crucible 런처에서 에이전트, 그다음 연결을 열고 AI 앱 옆의 연결을 누른 다음, 그 앱을 재시작하거나 그 안에서 새 채팅을 시작하세요. MCP 서버를 실행하는 다른 앱이라면 설정 복사가 붙여 넣을 블록을 복사합니다. 되돌릴 수 없는 변경은 활동에서 내가 허용할 때까지 기다립니다.

Crucible 런처의 에이전트 탭은 세 부분으로 되어 있습니다.

• 로컬 에이전트(로컬 에이전트와 대화하기도 참고하세요)는 내 PC에서 실행되며 Crucible, Rust 맵, 로컬 서버에 대한 질문에 답하는 작은 AI입니다. 앱을 열거나 서버를 시작하는 것 같은 간단한 일도 대신 해 줄 수 있어요.
• 활동은 AI가 Crucible에서 한 모든 일의 목록이고, 내 확인을 기다리는 카드도 여기에 있습니다.
• 연결은 이미 쓰고 있는 AI 앱(Claude Code, Codex, Cursor 등)을 연결해서 Crucible에서 나를 위해 일하게 하는 곳입니다. 앱을 열고 업데이트하고, Crucible Heightmap에서 Rust 맵을 만들고 내보내고, Crucible Local Server에서 로컬 Rust 테스트 서버를 돌립니다.

앱 창은 내내 화면에 남아 있어서 AI가 일하는 것을 지켜볼 수 있습니다.

로컬 에이전트

로컬 에이전트는 무료이고 전부 내 PC에서 실행됩니다. 요청하기 전에는 아무것도 설치되지 않습니다.

모델 고르기

에이전트, 그다음 로컬 에이전트를 여세요. 첫 화면에 그래픽 카드, 그 메모리(VRAM), PC의 RAM, 그리고 로컬 에이전트가 실행할 수 있는 모델 세 가지가 나옵니다. 모두 Qwen 팀의 모델이에요.

모델	답변	다운로드	그래픽 메모리
Standard (Qwen3.5-2B)	가장 빠름	약 1.2 GB	약 2.0 GB, 또는 프로세서에서 실행
Smarter (Qwen3.5-4B)	더 좋고 실수가 적음	약 3.8 GB	약 3.6 GB, 그래픽 카드 전용
최고 (Qwen3.5-9B)	최고, 다시 더 느림	약 6.5 GB	약 5.9 GB, 그래픽 카드 전용

내 카드에 맞는 모델 하나에 추천 표시가 붙습니다(Model 메뉴에서는 별 표시). Rust와 게임 내 보기를 위해 그래픽 카드에 여유 남기기(처음에는 켜져 있음)가 어느 것인지 정합니다.

• 켜면 카드의 대부분을 비워 두는 모델을 제안해서, 그 옆에서 Rust나 Heightmap의 게임 내 보기가 부드럽게 실행됩니다.
• 끄면 내 카드가 담을 수 있는 가장 큰 모델을 제안합니다.

카드에 여유가 있는 아무 모델이나 고르고 설치를 누르세요. Smarter와 최고는 Standard와 함께 오고, Standard는 Rust나 게임 내 보기 때문에 그래픽 카드에 여유가 없을 때 답합니다. 위의 크기에는 Standard도 포함되어 있어요. 다운로드가 멈추면 설치 계속이 멈춘 곳에서 이어 갑니다.

그다음 불러오기를 눌러 모델을 메모리에 올리고 질문하세요.

무엇을 알고 무엇을 하나요

Crucible가 어떻게 작동하는지, 각 슬라이더와 버튼이 무엇을 하는지 압니다. 답변마다 아래에 사용한 페이지의 링크가 나옵니다.

Rust 자체도 Rust 게임 레퍼런스와 같은 수준으로 압니다. 콘솔 명령어, 서버 변수, shortname이 붙은 아이템, 스택 크기와 제작 레시피, 프리팹 경로, Oxide와 Carbon 플러그인의 기초이고, Rust 업데이트마다 최신으로 유지됩니다. “decay 끄는 명령어가 뭐야”나 “큰 나무 상자 프리팹이 뭐야”라고 물어보세요.

문서가 다루지 않는 질문, 예를 들어 레이드 비용이나 최신 Rust 업데이트에 무엇이 추가됐는지는 추측하는 대신 모른다고 말하고, 아는 곳으로 안내합니다. Crucible Discord, RustHelp, Facepunch의 업데이트 소식, 또는 간단한 Google이나 YouTube 검색입니다.

구매와 결제(결제 과정, 할인 코드, 플랜 전환, 취소, 청구서)와 친구가 서버에 참가하게 하는 것(playit.gg, 포트 포워딩)도 도와줍니다. 그 단계를 설명하고 위치를 보여 주며, 돈이 드는 버튼이나 구독이나 라이선스를 바꾸는 버튼은 항상 내가 직접 눌러야 합니다.

모든 Crucible 앱에서 평범한 말로 부탁하면 일을 할 수 있습니다.

• 런처: Crucible Heightmap이나 Crucible Local Server를 열고, 닫고, 설치하고, 업데이트하거나 제거하고, 런처 설정(언어, 시작, 트레이, 자동 업데이트, 모션 줄이기)을 바꾸고, 업데이트를 확인하고, 지원용 로그를 저장하고, 임시 파일을 정리하고, 무료 다운로드를 저장하거나 설치합니다(무료 플러그인을 Carbon이나 Oxide 서버에 바로 넣을 수 있어요).
• Crucible Heightmap: 새 맵을 만들고, 슬라이더와 맵 크기를 바꾸고, 실행 취소와 다시 실행을 하고, 프로젝트와 시드를 저장하고 열고, worldgen을 만들고, 섬, 램프, 채널 컷을 편집하고, 페인트하고, 내보냅니다. 내보내기의 어떤 파일이든 가능합니다.
• Crucible Local Server: 서버를 설정하고, 시작하고, 중지하고, 재시작하고, 설정을 바꾸고, 콘솔 명령어를 실행하고 콘솔을 읽고(예를 들어 서버가 왜 멈췄는지 보려고), 누가 접속 중인지 보고, 백업하고, 와이프하고, 플러그인과 맵을 관리합니다.
• 자기 자신: 음성, 답변 소리 내어 읽기, Hands-free, 기억량과 모델, 실행 전에 묻기, 채팅.

이것들은 바로 합니다. 계획을 보여 주고 먼저 내 허용을 기다리게 하려면 먼저 무엇을 물어보나요?를 참고하세요.

한 번의 요청으로 여러 단계가 필요한 몇 가지 작업도 할 수 있습니다.

• 서버 설정하기: 서버를 설명하면(“Oxide로 10명용 4k PvE 서버, 이름은 Test”) 서버를 만들고, 맵(내가 정한 크기와 시드의 절차적 생성 맵이나 가장 최근의 Heightmap 내보내기 파일)을 지정하고, 말한 설정을 적용하고, 서버 파일을 내려받고, 시작합니다. “나를 관리자로 만들어 줘”라고 하면 이 PC에 로그인된 Steam 계정이 서버의 소유자가 되고, “올라오면 참가해 줘”라고 하면 월드가 다 불러와질 때까지 기다렸다가 Rust를 시작해 참가한 다음 채팅으로 알려 줍니다(음성이 켜져 있으면 소리로도). 기다리는 동안 런처를 계속 쓸 수 있어요.
• 서버에 맵 넣기: 가장 최근의 Heightmap 내보내기 파일을 서버에 올리고 시작하고, 부탁하면 올라온 뒤 참가합니다.
• 서버 설정: 서버의 플레이어 수, PvE, 게임 모드, 이름, 설명을 바꿉니다.

각각은 내가 말한 것만 채웁니다. 말하지 않은 이름, 크기, 시드를 지어내는 일은 없습니다. 필요한데 닫혀 있는 앱은 먼저 열립니다. 맵을 단계별로 통째로 만들거나 세밀하게 페인트하는 것 같은 큰 작업은 할 수 있는 만큼 하고, 연결에서 연결한 Claude Code나 Codex 같은 AI 앱이 더 잘할 때는 그렇다고 알려 줍니다. Crucible Heightmap이나 Crucible Local Server가 로컬 에이전트가 다룰 수 있는 것보다 오래된 버전이면 그렇다고 말합니다. 앱을 닫고, 앱에서 업데이트를 누른 다음 다시 여세요.

답이 어떤 장소일 때는 설명하면서 보여 줍니다. 구독을 어디서 취소하는지 물으면 런처가 계정으로 바뀌고, 기타를 물으면 상점 > 기타를 열고, 지원용으로 저장이 어디 있는지 물으면 설정의 그 행을 가리킵니다. Heightmap의 패널과 보기, Local Server의 탭도 같은 방식으로 보여 줘요.

음성

로컬 에이전트는 답변을 쓰는 대로 소리 내어 읽어 줄 수 있고, 입력하는 대신 말로 대화할 수 있습니다. 음성은 설치와 함께 옵니다(약 0.5 GB 추가).

• 채팅 위 막대의 음성은 답변 소리 내어 읽기를 켜고 끄고, 열 가지 목소리 중 하나를 고르고(고르면 샘플을 재생합니다), 볼륨, 속도, 마이크를 정합니다. 메시지를 보내거나, 채팅을 바꾸거나, 일시 정지 버튼을 누르면 읽던 것이 끊깁니다.
• 마이크 버튼은 보내기 옆에 있습니다. 누르고 말한 다음 다시 누르거나 그냥 말을 멈추세요. 말한 내용이 입력란에 들어가서 보내기 전에 확인할 수 있어요.
• 음성 메뉴의 Hands-free: 로컬 에이전트가 “Hey”와 내가 고른 목소리의 이름(“Hey Luna”)을 기다렸다가, 말한 대로 하고 답변을 소리 내어 읽어 줍니다. 누를 버튼이 없어요. 이름을 들으면 짧은 신호음이 나고 마이크 버튼이 빨갛게 바뀝니다. 한 번에 다 말하거나(“Hey Luna, start my server”), 이름을 말하고 신호음을 기다린 다음 나머지를 말하세요. **“Hey Luna, stop”**은 말을 멈추게 합니다. 런처가 최소화되어 있거나 게임 뒤에 있어도 계속 듣습니다. Hands-free가 켜져 있는 동안 마이크 버튼은 마이크를 음소거하고 해제합니다.

마이크 버튼이 아무 일도 하지 않으면 Windows가 마이크를 막고 있을 수 있습니다. Windows 설정 > 개인 정보 및 보안 > 마이크에서 마이크 액세스와 데스크톱 앱에서 마이크에 액세스하도록 허용을 켜세요. 중국어 답변은 소리 내어 읽지 않습니다.

그래픽 카드 또는 프로세서

불러오기를 누르면 로컬 에이전트는 여유가 있을 때 가장 빠른 그래픽 카드에서, 없을 때는 프로세서에서 실행됩니다. 꺼내기 옆의 칩이 어느 쪽을 쓰는지 보여 줍니다.

버튼 아래 띠는 PC가 쓰고 있는 그래픽 메모리(VRAM)와 RAM의 양을 실시간으로 보여 주고, 로컬 에이전트 자신의 몫은 라임색으로 표시합니다. 이 채팅의 컨텍스트가 얼마나 찼는지, 쓰는 속도(초당 토큰)도 보여 줍니다.

Model: 나중에 바꾸기

Model은 Standard, Smarter, 최고 사이를 언제든 바꿉니다. 채팅은 그대로 이어져요. 각 행은 그 모델이 내 PC에서 차지하는 공간을 보여 주고, 별이 내 카드에 추천되는 모델을 표시합니다.

• 아직 내 PC에 없는 모델에는 다운로드 표시가 있습니다. 고르면 다운로드될 때까지 진행 막대가 있는 설정 화면이 돌아오고, 끝나면 채팅이 돌아옵니다.
• Smarter나 최고 옆의 휴지통 아이콘은 그 모델을 내 PC에서 지우고 공간을 비웁니다. Standard는 남고, 그 모델을 다시 고르면 다시 내려받습니다.

Smarter와 최고는 그래픽 카드에서만 실행됩니다. 고른 모델을 카드가 담을 여유가 없을 때, 예를 들어 게임 내 보기가 열려 있을 때는 더 작은 모델이 대신 답하고 Model 버튼이 금색으로 바뀌어 알려 줍니다. 무거운 것을 닫고 꺼내기와 불러오기를 누르세요.

기억량: 채팅을 얼마나 기억할지

기억량은 로컬 에이전트가 한 번에 채팅을 얼마나 기억할지 정합니다.

설정	기억하는 양	그래픽 메모리: Standard	Smarter	최고
자동 (기본값)	내 PC에 맞게 설정	약 2.0 GB	3.6 GB	5.9 GB
짧게	8k 토큰	약 1.9 GB	3.4 GB	5.6 GB
보통	16k 토큰	약 2.0 GB	3.6 GB	5.9 GB
길게	32k 토큰	약 2.1 GB	4.2 GB	6.4 GB
가장 길게	64k 토큰	약 2.5 GB	5.2 GB	7.4 GB

더 길수록 더 긴 채팅과 더 긴 여러 단계 작업을 따라갈 수 있습니다. 채팅이 꽉 차면 가장 오래된 메시지가 모델의 기억에서 빠지고, 채팅 자체에서는 절대 사라지지 않습니다.

채팅

새 채팅은 새 채팅을 시작합니다. 채팅은 이번 달에는 주별로, 그 전에는 월별로 묶입니다. 그룹을 클릭하면 열고 닫히고, 휴지통 아이콘은 채팅 하나나 그룹 전체를 삭제합니다.

Rust와 로컬 에이전트

Rust와 로컬 에이전트는 그래픽 카드와 메모리를 같이 씁니다. 불러오기를 눌렀을 때 Rust가 열려 있거나, 모델이 불러와진 동안 Rust가 시작되면 런처가 앞으로 나오고 채팅하는 동안 Rust를 닫으라고 권합니다. 꺼내기는 메모리를 모두 돌려줍니다.

꺼내기, 업데이트, 제거

• 꺼내기는 모델을 내립니다. 채팅은 남습니다.
• 업데이트는 더 새로운 로컬 에이전트가 나오면 나타납니다.
• 채팅 목록 맨 아래의 로컬 에이전트 제거는 내 PC에서 로컬 에이전트를 지웁니다. 채팅은 남고, 첫 화면이 돌아와서 다시 모델을 고를 수 있습니다.

AI 앱은 어떻게 연결하나요?

에이전트, 그다음 연결을 여세요. 런처가 내 PC에서 찾은 AI 앱을 나열합니다.

• 연결은 그 앱에 Crucible를 추가합니다. AI 앱을 재시작하거나 그 안에서 새 채팅을 시작해야 Crucible를 불러옵니다.
• 실행 취소는 Crucible를 다시 뺍니다.
• 복구는 앱이 옮겨진 Crucible 설치를 가리킬 때 나타납니다. 이 설치를 가리키도록 고칩니다.
• 이 PC에 없음은 앱이 설치되어 있지 않다는 뜻입니다.

목록에는 Claude Code, Claude Desktop, Cursor, VS Code, Codex, Antigravity, Windsurf, Gemini CLI, LM Studio가 있습니다. 내 PC에서 실행되는 AI 앱(터미널, 에디터, 데스크톱 앱)이고, 브라우저의 채팅 웹사이트는 내 PC의 앱에 닿을 수 없습니다.

다른 AI 앱은 아직 나오지 않은 것까지 포함해 로컬 MCP 서버를 실행하는 어떤 앱과도 작동합니다. 설정 복사는 표준 MCP 설정 블록을 복사합니다.

{
  "mcpServers": {
    "crucible": {
      "command": "<the Crucible program on your PC>",
      "args": ["--mcp"]
    }
  }
}

그 앱의 MCP 설정에 붙여 넣거나, AI 에이전트 자체에게 붙여 넣고 Crucible를 추가해 달라고 부탁하세요. 복사된 블록에는 이미 내 PC에 맞는 경로가 들어 있습니다.

런처를 먼저 열 필요는 없습니다.

연결된 AI 앱은 Crucible에서 무엇을 할 수 있나요?

• 런처: 설치되어 실행 중인 것을 보고, 앱을 설치, 업데이트, 열기, 제거하고, PC의 여유 메모리를 확인하고, 이 문서를 검색하고, 아무 탭이나 페이지를 보여 주고, 런처 설정(언어, 시작, 트레이, 자동 업데이트, 모션 줄이기)을 바꾸고, 업데이트를 확인하고, 지원용 로그를 저장하고, 임시 파일을 정리하고, 플랜과 갱신 날짜를 읽고, 로컬 에이전트의 설정을 바꾸고, 무료 플러그인, 프리팹, 맵, 가이드를 저장하거나(폴더는 내가 고릅니다) 무료 플러그인을 Carbon이나 Oxide 서버에 바로 넣습니다.
• Crucible Heightmap(열려 있고, 라이선스가 적용되어 있을 때): 화면에 보이는 이름으로 어떤 설정이든 읽고 바꾸고, 새 맵을 conjure하고, 섬을 다루고, worldgen을 실행하고 그 설정(바이옴과 티어 비율, 회전, 절벽, 호수, 용암, 토폴로지)을 바꾸고, 램프와 채널을 추가하고, 페인트하고, 모든 브러시를 설정하고, 높이와 경사에 따라 땅을 칠하고, Conjure가 굴리는 것, 보기의 오버레이와 시간대, 앱 자체의 설정을 바꾸고, imports 폴더의 그림을 섬으로 바꾸고, 저장한 섬 모양을 쓰고, 맵이나 게임 내 보기의 사진을 찍고, 프로젝트를 저장, 열기, 이름 변경, 삭제하고, 저장한 시드(즐겨찾기, 태그, 가져오기)를 다루고, 내가 쓰는 것과 같은 내보내기 패널로 내보냅니다. 저장된 프로젝트 여러 개를 한꺼번에 내보내는 것도 포함입니다.
• Crucible Local Server(열려 있을 때): 서버를 만들고, 이름을 바꾸고, 복사하고, 삭제하고, 서버 파일을 내려받고 관리하고, 설정과 라이브 규칙을 바꾸고, 매일 재시작을 정하고, 시작, 중지, 재시작하고, 빠른 보기의 버튼을 누르고, 콘솔 명령어를 실행하고 콘솔을 읽고, 플레이어를 나열하고, 맵과 세이브를 다루고, 플러그인과 그 설정 파일을 검색하고 관리하고, 백업하고 와이프하고, 서버의 노트를 읽고 쓰고, 파일을 둘러보고, 앱 자체의 설정을 바꾸고, Rust를 시작해 참가합니다.

Heightmap의 맵 위치는 맵 그림을 기준으로 줍니다. 왼쪽에서 오른쪽, 위에서 아래이고, 보는 그대로 북쪽이 위입니다.

먼저 무엇을 물어보나요?

되돌릴 수 없는 일은 내가 허용할 때까지 기다립니다. 에이전트 > 활동(또는 로컬 에이전트 자신의 요청은 채팅 옆)에 카드가 나타나고, 런처가 앞으로 나오며, AI는 내가 허용이나 거부를 누를 때까지 기다립니다. 거부하면 내가 거절했다고 AI에게 알립니다. 여기에는 이런 것들이 포함됩니다.

• 저장하지 않은 변경이 있는 Heightmap 맵 교체, 프로젝트, 저장한 시드, 저장한 모양 삭제,
• Heightmap의 손으로 칠한 땅 전부 지우기,
• 앱 제거,
• 서버, 맵, 세이브, 월드, 노트 페이지 삭제와 서버 파일 제거,
• 와이프, 백업 복원, 백업 삭제,
• 링크나 파일에서 플러그인 설치(내 서버에서 다른 사람의 코드가 실행됩니다), 플러그인 삭제, 플러그인 설정 파일 변경,
• server.cfg나 실행 인자 교체, 서버를 프리셋으로 되돌리기,
• Crucible Local Server의 저장된 파일 지우기,
• 서버를 바꾸는 콘솔 명령어(status 같은 읽기 명령어는 바로 실행됩니다),
• 서버가 실행 중일 때 앱 닫기,
• 서버가 실행 중일 때 로컬 에이전트가 Crucible Local Server 닫기,
• 로컬 에이전트가 앱을 제거하거나 채팅 삭제.

로컬 에이전트는 서버를 시작하고, 중지하고, 설정하는 일은 바로 합니다. 계획을 카드 하나에 보여 주고 먼저 허용을 기다리게 하려면 활동에서 로컬 에이전트가 묻지 않고 실행을 눌러서 로컬 에이전트가 실행 전에 확인으로 바꾸세요. 와이프, 삭제, 저장하지 않은 작업을 잃을 수 있는 일은 항상 물어봅니다.

이 세션 동안 모두 허용은 런처가 닫힐 때까지 연결된 AI 앱의 변경을 카드 없이 통과시킵니다. 저장되지 않고 로컬 에이전트에는 영향이 없습니다.

절대 못 하는 일은 무엇인가요?

• 무엇이든 구매하거나, 구독을 바꾸거나, 라이선스 키를 보는 것. 구매, 플랜 변경, 취소, 라이선스는 내가 버튼을 누르는 런처의 상점과 계정 탭에 남아 있습니다.
• 비밀번호 읽기. 서버의 RCON 비밀번호는 AI 앱에게 숨겨져 있습니다.
• PC에 여유가 없는 단계 시작. 단계에 쓸 메모리가 부족하면 Crucible가 무엇이 쓰고 있는지 알려 주므로, 무엇을 닫을지 정할 수 있습니다.

어떻게 멈추나요?

에이전트 탭 오른쪽의 중지는 내가 재개를 누를 때까지 AI 앱과 로컬 에이전트가 요청하는 모든 것을 거부하고, 런처를 재시작해도 유지됩니다. 이미 실행 중인 다운로드는 끝나서, 반쯤 업데이트된 앱이 남는 일은 없습니다. 로컬 에이전트의 답변을 도중에 멈추려면 보내기 버튼이 있던 자리의 일시 정지 버튼을 누르세요.

활동은 모든 요청을 나열합니다. 어떤 AI가 했는지, 무엇을 요청했는지, 어떻게 되었는지요.

내 데이터는 공유되나요?

로컬 에이전트는 내 PC에서 실행됩니다. 채팅은 내 PC에 남고, 입력하거나 말한 것은 어디로도 전송되지 않습니다.

연결된 AI 앱은 내 PC에서 나온 Crucible의 답변만 받고 그 외에는 아무것도 받지 않습니다. 그 앱이 그것(맵 그림, 설정, 서버 상태)으로 무엇을 하는지는 그 앱 자체의 정책을 따르고, 그 앱에 보여 주는 다른 모든 것과 같습니다. 라이선스 키나 비밀번호는 절대 받지 않습니다.

무슨 일이 있었는지는 어디서 보나요?

설정의 지원용으로 저장에는 도움이 필요할 때를 위해 AI 앱이 한 일도 들어 있습니다. 같은 설정 탭의 폴더 열기는 Crucible가 내 PC의 어디에 있는지 보여 줍니다.

관련 문서

• 로컬 에이전트와 대화하기
• Crucible Local Server란?
• Crucible Heightmap이란?
• 용어집