터미널 · MCP · 스킬
이 쪽은 AI 대화 바깥의 도구 세 가지를 다룹니다. 프로젝트 폴더에서 바로 여는 터미널, AI 가 쓰는 MCP 서버, 그리고 플러그인 · 스킬입니다.
내장 터미널
섹션 제목: “내장 터미널”프로젝트 화면 툴바의 💻 Terminal 을 누르거나 Ctrl+` 로 새 터미널을 엽니다. 터미널은 레이아웃의 한 칸으로 붙고, 프로젝트 폴더에서 시작합니다.
| 항목 | 값 |
|---|---|
| 기본 셸 | Windows 는 ComSpec(보통 cmd.exe, 없으면 powershell.exe), 그 외는 $SHELL |
| 개수 | 프로젝트당 최대 8개, 전체 최대 32개 |
| 스크롤백 | 5000줄 |
- 창 크기에 맞춰 자동으로 다시 맞춥니다.
- 출력의 URL 을 클릭하면 브라우저로 열립니다.
- 터미널 칸을 다른 창으로 떼어 내도 같은 셸을 그대로 이어 봅니다. 떼어 낸 창은 최근 출력부터 다시 보여 줍니다.
원격 접속에서는 작업 폴더가 반드시 있어야 하고, 허용 폴더 안이어야 터미널이 열립니다. 자세한 내용은 원격 접속 을 보세요.
도구 패널
섹션 제목: “도구 패널”툴바의 도구 를 누르면 통합 창이 열립니다. 탭은 MCP 서버 · 플러그인 · 스킬 세 개입니다. 프로젝트를 먼저 선택해야 씁니다.
MCP 서버
섹션 제목: “MCP 서버”MCP 서버 목록은 프로젝트 provider 에 따라 다른 설정을 보여 줍니다.
| Provider | 범위 | 표시 |
|---|---|---|
| Claude | 프로젝트별 | 이 프로젝트 |
| Codex | 전역 (~/.codex/config.toml) |
codex · 전역 |
| Grok | 전역 | grok · 전역 |
전역 설정의 서버를 지우면 모든 프로젝트에서 사라집니다. 삭제 전에 확인 창이 뜹니다.
서버 추가
섹션 제목: “서버 추가”+ 서버 추가 를 누르고 입력합니다.
- 이름 (예:
sentry) - 전송 방식:
http·sse·stdio - 설치 범위: Claude 는
user·local·project, Grok 은user·project. Codex 는 범위 없이 전역에 설치됩니다 http·sse는 URL 과 헤더(한 줄에 하나),stdio는 명령(예:npx)과 인자
원격 접속에서는 서버 추가가 막혀 있습니다. MCP 서버 추가는 PC 에서 해주세요 가 뜨면 PC 앱에서 추가하세요.
승인 · 인증 (MCP 인증 콘솔)
섹션 제목: “승인 · 인증 (MCP 인증 콘솔)”OAuth 로그인이 필요한 서버나 프로젝트 범위 승인을 기다리는 서버(⏸ Pending)에는 승인 / 인증 버튼이 붙습니다. 누르면 MCP 인증 콘솔 이 열립니다.
- 콘솔 안에서 대화형
claude가 뜹니다. - 프로젝트 MCP 승인 프롬프트가 뜨면 승인
/mcp→ 서버 선택 →Authenticate→ 브라우저에서 로그인- 끝나면 닫기 후 새로고침
로그인 주소가 나오면 🔗 로그인 링크 감지됨 과 함께 브라우저로 열기 버튼이 생깁니다. user 범위로 추가한 서버는 승인 단계가 없습니다.
Codex MCP 서버 허용
섹션 제목: “Codex MCP 서버 허용”AgentManager 는 Codex 를 자동으로 실행하므로 Codex 의 도구 승인 질문에 답할 수 없습니다. Settings > 모델 · 계정 > Codex MCP 서버 허용 에서 허용한 서버의 도구만 Codex 가 묻지 않고 씁니다.
- 변경은 다음 메시지부터 적용됩니다.
- 읽기 전용(safe) 프로젝트와 Orchestra 에는 적용되지 않습니다.
- 허용 변경은 PC 앱에서만 할 수 있습니다.
플러그인
섹션 제목: “플러그인”Claude Code 플러그인을 앱 안에서 관리합니다.
- 마켓플레이스: 공식
claude-plugins-official은 기본 포함. 추가는owner/repo또는 URL - 설치됨: 플러그인마다 활성 / 비활성, 업데이트, ✕ 삭제
- 찾아보기: 마켓플레이스에서 아직 설치하지 않은 플러그인을 보고 설치
채팅에 /plugin install 이름 을 입력해도 앱이 받아 설치하고 결과를 카드로 보여 줍니다.
스킬 탭은 Claude Code 가 자동으로 찾는 스킬 목록입니다(Claude 가 보는 스킬).
Claude Code 가 읽는 위치:
- 플러그인 캐시
~/.claude/plugins/cache/ - 사용자
~/.claude/skills/ - 프로젝트
.claude/skills
목록에는 Codex 전용 위치(~/.codex/skills/, .codex/skills)와 .agents/skills 도 함께 보입니다. 이 둘은 Claude 가 읽지 않습니다.
출처마다 색 태그가 붙습니다. .agents/skills 의 스킬에는 ⚠ claude-code 가 안 봄 경고가 붙습니다. .claude/skills 로 옮기면 Claude Code 가 인식합니다.
새 스킬은 플러그인을 설치하거나 ~/.claude/skills/<이름>/SKILL.md 를 직접 작성해 추가합니다.
앱 내부 스니펫 (레거시)
섹션 제목: “앱 내부 스니펫 (레거시)”예전 버전에서 만든 프롬프트 매크로입니다. Claude 가 자동 인식하지 않고, 채팅에서 /이름 으로 불러 씁니다. 프로젝트 · 글로벌 범위로 나뉘며 수정 · 삭제할 수 있습니다.