SONUB
KO English 한국어 日本語 中文 हिन्दी বাংলা اردو Español Português Français Deutsch Русский العربية Bahasa Indonesia Tiếng Việt ไทย Türkçe

알림을 켜는 방법

이 브라우저 또는 주소에서는 알림을 사용할 수 없습니다. 지원되는 브라우저로 보안 연결된 SONUB 사이트에 접속해 주세요.

알림이 차단되어 있으면 브라우저 설정에서 허용해 주세요.

  1. 주소 표시줄 옆의 사이트 설정 또는 브라우저의 사이트 설정을 열고, 이 사이트의 알림을 허용으로 바꾸세요.
  2. 기기 설정에서 브라우저 알림을 허용하고 방해 금지 또는 집중 모드를 확인하세요.
  3. SONUB으로 돌아와 페이지를 새로고침한 뒤 벨을 눌러 알림을 켜세요.

iPhone 또는 iPad에서는 SONUB을 홈 화면에 추가하고 거기에서 연 뒤 알림을 허용하세요.
Anthropic

Claude Code — 터미널에서 일하는 Anthropic 의 코딩 에이전트

프로젝트 폴더에서 claude 라고 입력하면 시작합니다. 를 읽고, 코드에 대한 질문에 답하고, 파일을 고치고, 명령을 실행해 자기 작업을 시험합니다. 이 화면은 설치와 첫 실행을 안내하고, 깊은 내용은 과정 챕터로 잇습니다.

고급 — 넓히기: 스킬·서브 에이전트·훅·MCP·헤드리스

반복하는 일은 로 가르치고, 큰 일은 에게 나눠 맡기고, 꼭 지켜야 할 것은 훅으로 강제하고, 바깥 도구는 로 잇고, 사람 없이 돌릴 일은 claude -p 로 스크립트에 넣습니다.

에이전트 스킬 — 반복하는 일을 가르치기

스킬은 SKILL.md 가 든 폴더입니다. Claude 는 평소에는 스킬의 이름과 설명만 알고 있다가, 일이 그 설명에 맞으면 본문을 읽어 따릅니다. 그래서 스킬을 많이 둬도 자리를 거의 차지하지 않습니다. 예전의 사용자 명령(.claude/commands/)도 이제 스킬로 합쳐졌습니다.

  • .claude/skills/<이름>/SKILL.md 는 이 프로젝트, ~/.claude/skills/<이름>/SKILL.md 는 내 모든 프로젝트에서 씁니다.
  • description 에 무엇을 하고 언제 쓰는지 분명히 적어야 Claude 가 알아서 고릅니다.
  • /<스킬 이름> 으로 직접 부를 수도 있고, /skills 로 목록을 봅니다.
  • 스크립트·참고 문서는 같은 폴더에 두고 SKILL.md 에서 가리킵니다. SKILL.md 는 500줄 아래로 짧게 둡니다.
.claude/skills/release-notes/SKILL.md
---
name: release-notes
description: Write release notes from the git log. Use when the user asks for release notes, a changelog or "what changed since the last tag".
---

# Release notes

1. Find the last tag: `git describe --tags --abbrev=0`
2. Read the commits since then: `git log <tag>..HEAD --oneline`
3. Group them under Added / Fixed / Changed.
4. Write plain sentences a user can understand. Skip internal refactors.

스킬은 열린 표준 — 하지만 Claude Code 는 자기 방식으로 동작

스킬은 Claude 를 만든 Anthropic 이 처음 만들어 무료로 공개했고, 지금은 agentskills.io 에서 Agent Skills 라는 범용 열린 표준으로 관리합니다. Codex·Cursor·Gemini CLI·GitHub Copilot 등 많은 도구가 같은 SKILL.md 폴더를 읽습니다.

하지만 주의하세요. 표준은 스킬 폴더 안에 무엇을 넣는지만 정하고, 스킬을 어디서 찾는지·이름이 겹치면 무엇을 쓰는지는 도구마다 다릅니다. Claude Code 는 agentskills.io 가 권하는 방식과 다르게 동작하므로, 다른 도구에서 잘 되던 스킬이 Claude Code 에서는 다르게 동작할 수 있습니다.

  • 폴더: agentskills.io 는 여러 도구가 함께 쓰는 .agents/skills/ 를 권하지만, Claude Code 는 .claude/skills/(프로젝트)와 ~/.claude/skills/(개인)를 읽습니다. .agents/skills/ 는 읽지 않습니다.
  • 이름이 겹칠 때: 표준의 일반 규칙은 프로젝트 스킬이 개인 스킬을 이기지만, Claude Code 는 반대입니다 — 엔터프라이즈 > 개인(~/.claude/skills/) > 프로젝트 순이라 개인 스킬이 실행됩니다.
  • 상위·하위 폴더: 표준은 정하지 않습니다. Claude Code 는 시작한 폴더와 그 위로 git 저장소 루트까지를 읽고, 하위 폴더는 그곳에서 일할 때 읽습니다(다음 단락).
  • frontmatter: 표준 필드는 name·description·license·compatibility·metadata·allowed-tools 여섯 개입니다. Claude Code 는 disable-model-invocation·context: fork·paths 같은 필드를 더했는데, 다른 도구는 이를 무시하고 claude.ai 업로드·Skills API 는 오류로 멈춥니다.

다른 AI 도구와 함께 쓸 스킬은 frontmatter 를 표준 여섯 필드로만 쓰세요. 그러면 Claude Code 와 다른 도구에서 고치지 않고 그대로 읽힙니다.

Claude Code 가 스킬을 찾는 곳 — 지금 폴더와 상위 폴더를 함께

지금 폴더에 .claude/skills 폴더가 있고 상위 폴더에도 같은 폴더가 있으면, Claude Code 는 지금 폴더와 상위 폴더의 스킬을 모두 같이 씁니다. 다만 위로는 루트까지만 올라갑니다.

  • claude 를 시작한 폴더와, 그 위로 저장소 루트까지 모든 상위 폴더의 .claude/skills/ 를 읽습니다. apps/web/ 에서 시작해도 루트의 스킬이 함께 잡힙니다.
  • 저장소 루트보다 위 폴더의 .claude/skills/ 는 읽지 않습니다. 여러 프로젝트에 공통으로 쓸 스킬은 ~/.claude/skills/ 에 두세요. git worktree 에서는 worktree 루트까지만 올라갑니다.
  • 시작한 폴더보다 아래(하위) 폴더의 스킬은 처음엔 읽지 않습니다. Claude 가 그 폴더의 파일을 처음 읽거나 고칠 때 읽혀 세션이 끝날 때까지 남고, 그 전에는 / 메뉴에도 없습니다. 미리 읽으려면 /add-dir 로 그 폴더를 더합니다.
  • 루트와 apps/web/ 양쪽에 deploy 스킬이 있으면 둘 다 씁니다. /deploy 는 루트의 스킬, /apps/web:deploy 는 하위 폴더의 스킬을 실행하고, Claude 에게는 작업 중인 파일이 있는 폴더의 스킬을 쓰라는 지시가 붙습니다.
  • 플러그인 스킬은 /<플러그인 이름>:<스킬 이름> 으로 따로 구분되므로 내 스킬과 겹치지 않습니다.
Run claude in apps/web/
~/projects/                    ← above the repository root
├── .claude/skills/            ← not loaded (put shared skills in ~/.claude/skills/)
└── repo/                      ← git repository root
    ├── .claude/skills/        ← loaded
    └── apps/web/              ← run claude here
        ├── .claude/skills/    ← loaded (used together with the root)
        └── src/
            └── .claude/skills/  ← not at start — loads when Claude first reads or edits a file in src/
Same name in two folders (claude started at the repository root)
repo/
├── .claude/skills/deploy/SKILL.md            → /deploy
└── apps/web/.claude/skills/deploy/SKILL.md   → /apps/web:deploy

지금 어떤 스킬이 읽혔는지는 /skills 로 봅니다. 상위·하위에 스킬을 많이 쌓으면 자주 안 쓰는 스킬부터 설명이 잘리므로, 가끔 /skill-doctor 로 점검하세요.

서브 에이전트 — 일을 나눠 맡기기

서브 에이전트는 자기만의 과 지시·도구를 가진 도우미입니다. 큰 조사나 검토를 맡기면 그 안에서 파일을 많이 읽어도 메인 대화에는 결과만 돌아오므로, 메인 대화가 깨끗하게 유지됩니다.

  • .claude/agents/<이름>.md 는 프로젝트(커밋해 팀과 나눔), ~/.claude/agents/ 는 나만 씁니다. 꼭 필요한 항목은 name 과 description 뿐입니다.
  • tools 로 쓸 수 있는 도구를 줄이면 안전합니다 — 검토 담당은 읽기만 하게 둡니다.
  • "code-reviewer 서브 에이전트로 이 변경을 검토해 줘" 처럼 부르거나, description 이 맞으면 Claude 가 알아서 맡깁니다.
  • 새 서브 에이전트는 Claude 에게 만들어 달라고 하거나 위 폴더에 파일을 직접 씁니다. 처음부터 들어 있는 Explore·Plan 도 있습니다.
.claude/agents/code-reviewer.md
---
name: code-reviewer
description: Reviews code changes for bugs, security problems and missing tests. Use after writing or changing code.
tools: Read, Grep, Glob, Bash
model: sonnet
---

You are a careful senior reviewer.
Run `git diff` to see the changes, then report:
1. Bugs (with file and line)
2. Security problems
3. Missing tests
Do not edit files.

훅 — 정해진 때 반드시 실행되는 명령

CLAUDE.md 는 부탁이라 가끔 잊힐 수 있지만, 훅은 Claude Code 가 정해진 순간마다 반드시 실행하는 명령입니다. 파일을 고친 뒤 포매터 돌리기, 위험한 명령이나 비밀 파일 편집 막기, 일이 끝나면 알림 받기에 씁니다.

  • PreToolUse — 도구를 쓰기 전(막을 수 있음), PostToolUse — 도구를 쓴 뒤
  • UserPromptSubmit — 부탁을 보낼 때, Stop — Claude 가 답을 마칠 때, SessionStart — 세션을 시작할 때, Notification — 내 확인이 필요할 때
  • matcher 로 어느 도구에 걸지 고릅니다(예: Edit|Write, Bash).
  • 훅 명령이 종료 코드 2 로 끝나면 그 동작을 막고, stderr 에 쓴 이유를 Claude 에게 알려 줍니다.
  • /hooks 로 지금 걸린 훅을 봅니다. 위 예는 파일을 고칠 때마다 Prettier 로 정리합니다(jq 가 필요).
.claude/settings.json
{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

훅은 내 컴퓨터에서 내 권한으로 실행됩니다. 남이 준 훅은 명령을 읽고 이해한 뒤에만 넣으세요.

MCP — 바깥 도구와 잇기

MCP(Model Context Protocol)는 AI 도구가 바깥 서비스(이슈 관리···문서 도구)를 쓰게 하는 열린 표준입니다. MCP 를 하나 더하면 그 서버가 주는 도구를 Claude 가 쓸 수 있습니다.

  • claude mcp add --transport http <이름> <주소> — 인터넷에 있는 원격 서버를 더합니다.
  • claude mcp add <이름> -- <명령> — 내 컴퓨터에서 실행하는 서버(stdio)를 더합니다. -- 뒤는 그대로 서버에 넘어갑니다.
  • --scope project 로 더하면 저장소 맨 위의 .mcp.json 에 저장돼 팀이 함께 씁니다(처음 쓸 때 승인을 묻습니다).
  • /mcp 로 연결 상태를 보고 로그인(OAuth)합니다. claude mcp list 로 목록을 봅니다.
Terminal
# A remote server (HTTP)
claude mcp add --transport http notion https://mcp.notion.com/mcp

# A server that runs on your computer (stdio)
claude mcp add playwright -- npx @playwright/mcp@latest

# Share it with the team — saved in .mcp.json
claude mcp add --scope project playwright -- npx @playwright/mcp@latest

claude mcp list

믿을 수 있는 MCP 서버만 더하세요. 바깥 글을 읽어 오는 서버는 그 글에 숨은 지시(프롬프트 주입)를 함께 들여올 수 있습니다.

헤드리스 — 대화 화면 없이 스크립트로

claude -p "…" 는 대화 화면 없이 한 번 실행하고 결과를 출력한 뒤 끝납니다. 쉘 스크립트·cron· 에서 Claude 를 부품처럼 씁니다.

  • 파이프로 입력을 넘깁니다(cat error.log | claude -p "…").
  • --output-format json 은 결과·세션 id·비용을 JSON 으로, stream-json 은 진행을 줄마다 내보냅니다.
  • --allowedTools 로 이번 실행에 허락할 도구를, --max-turns 로 최대 차례 수를 정합니다.
  • claude -p --continue 로 앞 실행을 이어 가거나, --resume <세션 id> 로 그 세션을 이어 갑니다.
Terminal
# One question, one answer
claude -p "Explain what src/auth.ts does in 5 lines"

# Pipe input in
cat build-error.log | claude -p "Find the cause and suggest a fix"

# JSON output for scripts (result, session_id, total_cost_usd)
claude -p "List the TODO comments in src/" --output-format json

# Limit what it may do and how long it runs
claude -p "Run the tests and fix failures" \
  --allowedTools "Read,Edit,Bash(npm test *)" --max-turns 10

스크립트에서는 --bare 를 붙이면 CLAUDE.md·훅·플러그인·MCP 를 읽지 않고 빠르게 시작합니다(공식 문서는 앞으로 -p 의 기본이 된다고 안내합니다). 프로젝트 지시가 필요하면 빼세요.

고급 연습

  1. 자주 하는 일 하나(예: 릴리스 노트, 커밋 메시지)를 .claude/skills/ 에 스킬로 만들고 /스킬이름 으로 불러 봅니다.
  2. 읽기만 하는 code-reviewer 서브 에이전트를 만들어 지금 변경을 검토하게 합니다.
  3. PostToolUse 훅으로 파일을 고칠 때마다 포매터나 린터가 돌게 합니다.
  4. MCP 서버 하나를 더하고 /mcp 로 연결을 확인합니다.
  5. claude -p 로 오류 로그를 요약하는 한 줄짜리 쉘 스크립트를 만듭니다.

다섯 가지를 모두 해 봤다면 [마스터] 탭으로 넘어가세요.

공식 문서

2026-10-18 에 공식 문서로 확인했어요. 도구가 자주 바뀌니 명령이 안 되면 공식 문서를 보세요.

가이드라인

인공지능

AI 자격증

공부

바이브코딩

게임 개발

연습

강사

채팅

게시판

만들기

소통

더보기

용어 사전

모르는 말을 골라 보세요. 쉬운 설명과 관련 용어를 볼 수 있어요.

찾는 용어가 아직 없어요.

용어를 고르면 설명이 보여요.