콘텐츠로 이동

터미널 · MCP · 스킬

이 쪽은 AI 대화 바깥의 도구 세 가지를 다룹니다. 프로젝트 폴더에서 바로 여는 터미널, AI 가 쓰는 MCP 서버, 그리고 플러그인 · 스킬입니다.

프로젝트 화면 툴바의 💻 Terminal 을 누르거나 Ctrl+` 로 새 터미널을 엽니다. 터미널은 레이아웃의 한 칸으로 붙고, 프로젝트 폴더에서 시작합니다.

항목 값
기본 셸 Windows 는 ComSpec(보통 cmd.exe, 없으면 powershell.exe), 그 외는 $SHELL
개수 프로젝트당 최대 8개, 전체 최대 32개
스크롤백 5000줄
  • 창 크기에 맞춰 자동으로 다시 맞춥니다.
  • 출력의 URL 을 클릭하면 브라우저로 열립니다.
  • 터미널 칸을 다른 창으로 떼어 내도 같은 셸을 그대로 이어 봅니다. 떼어 낸 창은 최근 출력부터 다시 보여 줍니다.

원격 접속에서는 작업 폴더가 반드시 있어야 하고, 허용 폴더 안이어야 터미널이 열립니다. 자세한 내용은 원격 접속 을 보세요.

툴바의 도구 를 누르면 통합 창이 열립니다. 탭은 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 앱에서 추가하세요.

OAuth 로그인이 필요한 서버나 프로젝트 범위 승인을 기다리는 서버(⏸ Pending)에는 승인 / 인증 버튼이 붙습니다. 누르면 MCP 인증 콘솔 이 열립니다.

  1. 콘솔 안에서 대화형 claude 가 뜹니다.
  2. 프로젝트 MCP 승인 프롬프트가 뜨면 승인
  3. /mcp → 서버 선택 → Authenticate → 브라우저에서 로그인
  4. 끝나면 닫기 후 새로고침

로그인 주소가 나오면 🔗 로그인 링크 감지됨 과 함께 브라우저로 열기 버튼이 생깁니다. user 범위로 추가한 서버는 승인 단계가 없습니다.

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 가 자동 인식하지 않고, 채팅에서 /이름 으로 불러 씁니다. 프로젝트 · 글로벌 범위로 나뉘며 수정 · 삭제할 수 있습니다.