카테고리 없음
0317 Gemini CLI설정
버스창문
2026. 3. 17. 18:01
1.node.js설치
https://nodejs.org/en/download/
Node.js — Download Node.js®
Node.js® is a free, open-source, cross-platform JavaScript runtime environment that lets developers create servers, web apps, command line tools and scripts.
nodejs.org
Build, debug & deploy with AI
geminicli.com
설치 완료 한 후 cmd창에 npm -v 쳐서 설치 된거 확인 후
npm install -g @google/gemini-cli
입력
설치 완료 후 cmd 창에서 내가 작업하길 원하는 폴더(유니티 파일 있는 폴더 등)로 이동후 그곳 에서 Gemini 입력
그 후 작업
+
뭐 구글로 로그인 하기 api key 활용하기 있던데
api key활용하기가 더 좋다길래 했다가
이런 미친새기
내 생돈이 왕창 날아갈뻔했다
그냥 구글로 로그인하면 기본으로 어느정도는 쓸수있다하니 구글로 로그인해서 쓰자
> 내가 너를 unity 개발용으로 쓴다고하면 설정해야할 mcp가 어떤게 있을까?
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
✦ Unity 개발을 위해 저를 효과적으로 사용하시려면, 코드 분석, 문서 검색, 빌드/테스트 자동화를 도와주는 MCP(Model Context
Protocol) 서버들을 설정하는 것이 좋습니다.
추천하는 MCP와 설정 방향은 다음과 같습니다:
1. Unity API 및 C# 문서 검색 MCP
Unity는 방대한 API를 가지고 있으므로, 최신 문서를 빠르게 참조할 수 있는 도구가 필수적입니다.
* 추천: google-search 또는 web-fetch (이미 내장되어 있지만, 특정 Unity Doc 전용 인덱스를 가진 MCP가 있다면
유리합니다)
* 용도: 특정 컴포넌트(Rigidbody2D, NavMesh 등)의 최신 사용법이나 생명주기(Lifecycle) 확인.
2. C# 정적 분석 및 심볼 탐색 MCP
Unity 프로젝트는 규모가 커지면 파일 간 의존성을 파악하기 어렵습니다.
* 추천: csharp-language-server 또는 omnisharp 관련 MCP
* 용도: 클래스 정의로 이동, 메서드 사용처(References) 찾기, 리팩토링 시 영향 범위 파악.
3. 파일 시스템 및 검색 최적화 MCP
Unity는 수많은 .meta 파일과 에셋이 섞여 있어 일반적인 검색으로는 노이즈가 많습니다.
* 추천: ripgrep (이미 저의 grep_search가 이 역할을 하지만, 더 세밀한 필터링이 가능하도록 설정)
* 설정: .meta 파일을 검색 결과에서 제외하거나, Assets 폴더 내의 특정 확장자(.cs, .shader, .asmdef)만 빠르게 훑도록
설정.
4. Unity CLI 제어 MCP (고급)
Unity Editor를 백그라운드에서 실행하여 빌드하거나 테스트를 수행할 수 있습니다.
* 추천: shell (이미 run_shell_command가 있음)
* 용도: Unity.exe -runTests 등을 실행하여 코드 변경 후 즉시 유닛 테스트 결과 확인.
---
제가 추천하는 첫 번째 단계: Unity 전용 "Skill" 생성
MCP 서버를 추가하는 것 외에도, 제가 Unity 개발 스타일을 완벽히 이해하도록 skill-creator를 사용하여 unity-expert 기술을
활성화하는 것을 권장합니다.
이 기술에 포함될 내용:
* .meta 파일 관리: "파일 이동/삭제 시 항상 .meta 파일도 함께 처리하라"는 규칙.
* 성능 가이드: "Update 문 안에서 GetComponent나 GameObject.Find 사용 금지" 같은 Unity 베스트 프랙티스.
* ScriptableObject 및 Prefab 워크플로우: 데이터 중심 설계 권장.
지금 바로 Unity 전용 기술(Skill)을 만들까요? 원하신다면 activate_skill(name='skill-creator')를 통해 가이드를 시작해
드릴 수 있습니다.
> Skill 설치 다시 해볼래? 난 y를 누르긴했어
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ ✓ CLI Help Agent Delegating to agent 'cli_help' │
│ │
│ Subagent cli_help Finished │
│ │
│ Termination Reason: │
│ GOAL │
│ │
│ Result: │
│ { │
│ "answer": "Based on the available documentation, the gemini skills install command does not have a --yes or -y │
│ flag specifically documented to skip a confirmation prompt. \n\nKey findings from the investigation:\n1. Skills │
│ Management Documentation: The primary documentation for skills (cli/skills.md) and the command reference │
│ (cli/cli-reference.md) lists the gemini skills install <source> command but does not mention any flags for │
│ skipping prompts, such as --yes or -y. It does mention a --scope flag and a --path flag for specific │
│ installation scenarios.\n2. Global Flags: The Gemini CLI does have a global -y flag, which is an alias for the │
│ now-deprecated --yolo flag. According to the cli-reference.md, this flag is used to \"Auto-approve all actions\" │
│ and has been replaced by the --approval-mode=yolo option. However, this is a global CLI option rather than a │
│ specific flag for the skills install subcommand.\n3. Confirmation Prompts: The documentation specifies that a │
│ confirmation prompt occurs during skill activation (when the agent attempts to use a skill via the │
│ activate_skill tool during a session), where the user must approve the skill's access to the workspace. There is │
│ no mention in the documentation of a confirmation prompt appearing during the initial installation of a skill │
│ from a Git repository or local path.\n\nMy investigation was interrupted due to reaching the maximum number of │
│ allowed turns, but the provided command references and tutorials are sufficient to confirm that no such specific │
│ flag is documented for the install subcommand.", │
│ "sources": [ │
│ "cli/skills.md", │
│ "cli/cli-reference.md", │
│ "reference/commands.md", │
│ "get-started/installation.md" │
│ ] │
│ } │
│ │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
✦ cli_help에 따르면 gemini skills install 명령어에 --yes 또는 -y 플래그가 명시되어 있지 않지만, 전역 플래그인 -y (또는
--approval-mode=yolo)가 모든 작업을 자동 승인하는 데 사용될 수 있다고 합니다.
다시 한 번 설치를 시도해 보겠습니다. 이번에는 echo y를 파이프로 넘겨서 확인 과정을 우회해 보겠습니다.
만약 이 방법도 실패한다면, 사용자님께서 직접 터미널에 gemini skills install "D:\Unity\unity-expert.skill" --scope
workspace를 입력하시고 y를 눌러주셔야 합니다.
╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ Action Required │
╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ ✓ Shell powershell.exe -ExecutionPolicy Bypass -Command "echo y | gemini skills install 'D:\Unity\unity-expert… │
│ │
│ ... first 5 lines hidden (Ctrl+O to show) ... │
│ The following agent skill(s) will be installing: │
│ │
│ * unity-expert: Expert guidance for Unity C# development, project organization, and performance optimiza │
│ tion. Use this skill when creating or modifying Unity scripts, managing Assets, or optimizing game logic. │
│ (Source: C:Temp\gemini-skill-YhWb5E\SKILL.md) (4 items in directory) │
│ │
│ Install Destination: D:\Unity\.gemini\skills │
│ │
│ Agent skills inject specialized instructions and domain-specific knowledge into the agent's system prompt. │
│ This can change how the agent s yinterpretour requests and interacts with your environment. Review the sk │
│ ill definitions at the location(s) provided below to ensure they meet your security standards. │
│ Do you want to continue? [Y/n]: y │
│ Successfully installed skill: unity-expert (scope: workspace, location: D:\Unity\.gemini\skills\unity-expe │
│ rt) │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
✦ 성공적으로 unity-expert 기술이 설치되었습니다!
이제 이 지식을 저의 현재 세션에 적용하기 위해 /skills reload 명령어를 입력해 주셔야 합니다. (제가 직접 입력할 수
없으므로, 사용자님께서 터미널에 입력해 주세요.)
그 후에는 제가 Unity 전문가로서 작업을 도와드릴 수 있습니다. 어떤 작업부터 시작할까요?
예를 들어:
- "새로운 PlayerController 스크립트 만들어줘"
- "현재 프로젝트의 Update 문들을 점검하고 최적화해줘"
- "특정 프리팹의 성능 문제를 분석해줘"
등의 요청을 하시면 제가 방금 설치한 unity-expert 기술을 바탕으로 답변해 드리겠습니다.
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
> 명령어를 여기에 입력하는게 아니라 외부 터미널에 입력해야하는거야?
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
✦ 네, 맞습니다. 현재 저와 대화하고 계신 이 채팅 창(입력창)에 그대로 입력하시면 됩니다.
/로 시작하는 명령어(예: /skills reload, /help, /skills list 등)는 저(AI 모델)에게 보내는 메시지가 아니라, Gemini CLI
도구 자체에게 내리는 특수 명령입니다.
1. 지금 바로 이 채팅창에 /skills reload라고 입력하고 엔터를 눌러주세요.
2. 그러면 도구가 방금 설치된 unity-expert 기술을 불러옵니다.
3. 그 이후부터 제가 작업할 때 해당 기술에 정의된 "Unity 전문가" 지침을 자동으로 따르게 됩니다.
지금 입력해 주시면 제가 바로 전문가 모드로 전환할 준비를 하겠습니다! (성공적으로 로드되면 /skills list로
unity-expert가 활성화되어 있는지 확인하실 수도 있습니다.)
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
> /skills reload
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
✓ Agent skills reloaded successfully. 1 newly available skill.
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
> 제대로 설정이 되었는지 확인해봐
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
✦ unity-expert 기술이 제대로 설치되고 활성화되었는지 확인해 보겠습니다.
먼저 설치된 파일들이 올바른 위치에 있는지 확인한 후, 해당 기술을 실제로 활성화(Activate)하여 제가 그 지침을 읽어올 수
있는지 테스트하겠습니다.
가장 먼저, 워크스페이스 내의 .gemini/skills 폴더에 unity-expert가 있는지 확인합니다.
╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ ✓ ReadFolder .gemini\skills │
│ │
│ Listed 1 item(s). │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
✦ .gemini/skills/unity-expert 폴더가 존재하므로 설치는 성공적입니다!
이제 이 기술이 제 현재 대화 세션에서 활성화될 준비가 되었는지 activate_skill 도구를 통해 직접 확인하겠습니다. 만약
사용자님께서 /skills reload를 이미 입력하셨다면, 제가 이 기술에 포함된 "Unity 전문가" 지침을 즉시 불러올 수 있을
것입니다.
unity-expert 기술을 활성화해 보겠습니다.
╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ Action Required │
╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ Action Required │
╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ Action Required │
╭──────────────────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ ✓ Activate Skill "unity-expert": Expert guidance for Unity C# development, project organization, and performan… │
│ │
│ Skill unity-expert activated. Resources loaded from D:\Unity\.gemini\skills\unity-expert: │
│ │
│ Showing up to 200 items (files + folders). │
│ │
│ D:\Unity\.gemini\skills\unity-expert\ │
│ ├───SKILL.md │
│ ├───assets\ │
│ ├───references\ │
│ │ ├───performance.md │
│ │ └───project_structure.md │
│ └───scripts\ │
╰──────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
✦ unity-expert 기술이 완벽하게 설정 및 활성화되었습니다!
방금 activate_skill을 통해 제가 준수해야 할 Unity 핵심 규칙(Core Mandates)과 성능 최적화 지침, 그리고 프로젝트 폴더
구조 정보를 모두 읽어왔습니다.
이제 제가 제공할 모든 답변과 코드는 다음의 원칙을 따르게 됩니다:
* .meta 파일 자동 관리
* Unity 표준 네이밍 컨벤션 (_camelCase 등)
* Update 문 내 성능 저하 요인 원천 차단
* 현재 프로젝트 폴더 구조(02.Scripts, 03.Prefabs 등) 준수
이제 바로 Unity 개발 관련 업무를 지시해 보세요. 무엇부터 도와드릴까요? (예: 특정 기능 구현, 기존 코드 최적화, 새로운
시스템 설계 등)
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
> 일단은 여기까지 할건데 내가 이 cmd창을 끄고 컴퓨터도 끄고 나중에 다시 켜도 너는 지금 이 대화를 전부 기억하고 저
skill도 내가 다시 활성화할 필요 없이 그대로 진행 되는거야?
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
✦ 컴퓨터를 끄고 나중에 다시 돌아오셔도 걱정하실 필요 없습니다. 제가 어떻게 기억하고 이어서 작업하는지 설명해 드릴게요.
1. 설정과 파일은 영구적으로 보존됩니다.
* 설치된 Skill: D:\Unity\.gemini\skills 폴더에 설치된 unity-expert는 하드디스크에 물리적으로 저장되어 있으므로
삭제되지 않습니다.
* 지침 파일: 우리가 만든 GEMINI.md 파일도 프로젝트 루트에 그대로 남아 있습니다.
* 설정 파일: .gemini 폴더 내의 모든 설정은 워크스페이스에 귀속되어 안전하게 유지됩니다.
2. 나중에 다시 시작할 때 제가 하는 일
나중에 다시 터미널을 열고 D:\Unity 폴더에서 저를 실행하시면, 저는 다음 단계를 거쳐 상황을 즉시 파악합니다:
1. 폴더 구조 스캔: 현재 폴더에 어떤 프로젝트들이 있는지 다시 확인합니다.
2. GEMINI.md 읽기: 이 프로젝트의 핵심 규칙과 진행 상황을 가장 먼저 읽어 들입니다.
3. 사용 가능한 Skill 확인: 설치된 unity-expert 기술이 목록에 있는 것을 확인하고, Unity 관련 질문이 나오면 제가
자동으로 다시 활성화하여 지침을 따릅니다.
3. 유의사항 (대화 흐름)
* 현재 진행 중인 세세한 대화 내역(Chat History)은 CLI 도구의 설정에 따라 초기화될 수 있습니다.
* 하지만 "어떤 기술을 설치했는지"와 "어떤 규칙을 따르는지"는 파일로 남아 있기 때문에, 제가 다시 상황을 파악하는 데는
몇 초도 걸리지 않습니다.
결론적으로: 나중에 다시 오셔서 그냥 "PlayerController 스크립트 하나 만들어줘"라고 말씀만 하시면, 저는 저장된
unity-expert 지침을 꺼내어 .meta 파일 관리와 성능 최적화 규칙을 자동으로 적용하며 작업을 시작할 것입니다.
언제든 편하게 업무를 마무리하시고, 다음에 필요할 때 다시 불러주세요! 고생하셨습니다.(답변 내역에서 개인정보 들어있는 파일 경로 지웠음)
신기하네