티스토리 뷰

인공지능

[AI] Claude Code(클로드 코드) 활용을 극대화하기 위한 최신 기술들(Skills, Slack, GitHub Actions, Chrome ETC)

망나니개발자 2025. 12. 23. 10:00
반응형

 

 

 

1. Claude Code(클로드 코드) 활용을 극대화하기 위한 최신 기술들
(Skills, Slack, GitHub Actions, Chrome ETC)


[ Claude Code and Slack ]

오늘날 슬랙과 같은 협업 메신저는 업무의 중심에 존재하는 경우가 많다. 기능 요청, 엔지니어링 논의 뿐만 아니라 버그 리포트, 장애 회고 등 엔지니어링 작업과 관련된 중요한 문맥은 Slack에 담겨 있는 경우가 다반사다.

 

 

앤트로픽은 이러한 상황에 대해 인지하고, 버그 리포트가 올라오거나 팀원이 코드 수정을 요청할 때, Slack에서 Claude를 태그하여 주변 문맥을 활용해 자동으로 Claude Code 세션을 생성할 수 있는 기능을 추가하였다. 예를 들어 슬랙에서 Claude를 멘션하여 버그 조사와 수정을 요청하고, 코드 작성과 리팩터링 및 리뷰를 맞기게 되는 것이다. 이를 위해 Claude Code and Slack이라는 글을 통해 Slack에서 @Claude를 언급하여 일을 처리할 수 있게 하는 기능을 소개하였다.

 

 

@Claude를 언급하면, Claude는 메시지를 검토해 그것이 코딩 작업인지 판단하고, 코딩 작업이라면 새로운 Claude Code 세션을 자동으로 생성한다. 그러면 해당 요청을 코딩 작업으로 처리하도록 지시할 수 있다. Claude는 Slack의 최근 채널 및 스레드 메시지에서 문맥을 수집해 Claude Code 세션에 전달하고, 이를 기반으로 웹에서 사용자가 인증한 저장소 중 어떤 곳에서 작업할지 자동으로 선택하게 되는 것이다. Claude Code 세션이 진행되는 동안 Claude는 Slack 스레드에 상태 업데이트를 게시하고, 작업이 완료되면 변경 사항을 검토할 수 있는 전체 세션 링크와 PR을 바로 열 수 있는 링크가 제공된다.

 

 

 

[ Claude Code GitHub Actions ]

우리는 GitHub를 통해 코드 리뷰와 빌드 등을 담당하게 된다. 따라서 앤트로픽은 AI 기반 자동화를 GitHub 워크플로우에 통합하기 위해 Claude Code GitHub Actions 기능을 출시하였다. 이는 GitHub 레포지토리에서 PR이나 이슈에 @claude를 멘션하면 Claude가 작업을 수행할 수 있도록 하는 것이다.

 

 

대표적으로 코드베이스를 읽고 분석, PR 생성, 기능 구현, 버그 수정 등이 가능하며, 이 기능은 Claude Code SDK 위에 구축되어 있어, 단순 자동화뿐 아니라 프로그래밍 방식 커스터마이즈도 가능하다. 간단한 변경 등은 이제 다시 IDE로 돌아가서 작업할 필요 없이 간단히 Claude에게 맡기면 되는 것이다.

Claude Code에서 /install-github-app 명령어를 이용하면, 해당 GitHub에 Claude Code 앱이 설치되고 이후에 API 키를 추가하면 자동으로 워크플로우 파일이 포함된 Pull Request가 생성된다. 해당 작업으로 .github/workflows 디렉터리에 워크플로우 파일들이 추가될 것이다.

 

 

 

[ Claude in Chrome ]

앤트로픽은 Claude in Chrome 브라우저 확장 프로그램을 베타 버전으로 공개하면서, Chrome 웹 브라우저에서 모든 유료 플랜(Pro, Max, Team, Enterprise) 사용자들이 Claude를 사용할 수 있게 제공하였다. Claude는 이제 사용자들과 함께 웹사이트를 읽고, 클릭하고, 탐색할 수 있으며, 우리가 브라우징하는 동안 사이드 패널에서 직접 작동하며, 우리가 보고 있는 내용을 함께 확인하고 요청 시 행동을 수행해준다. 이를 통해 브라우저에 AI가 통합되는 경험을 할 수 있다.

 

 

Claude Code도 브라우저와 통합되는데, Chrome 확장 프로그램이 함께 작동하기 때문에, 빌드–테스트–검증 워크플로우를 지원한다. 이는 특히 디자인 검증(Figma 시안과 빌드 결과 비교), 실시간 디버깅, 자동화 테스트에 유용할 것이라고 한다.

  • 터미널에서 Claude Code로 빌드
  • Chrome 확장 프로그램으로 브라우저에서 테스트 및 검증
  • 콘솔 로그를 사용해 문제 디버깅(Claude가 오류, 네트워크 요청, DOM 상태를 직접 읽을 수 있음)

 

또한 Claude Desktop에서 역시 브라우저 작업 제어가 가능해진다. Claude Desktop에서 작업을 시작한 뒤, 창을 전환하지 않고 브라우저 작업을 Claude가 처리하도록 할 수 있다. 데스크톱 앱에서 Claude in Chrome 커넥터를 활성화하려면 다음 단계가 필요하다.

  1. 왼쪽 하단의 이니셜을 클릭한 후 “Settings” 선택
  2. “Connectors”**로 이동
  3. 목록에서 Claude in Chrome을 찾아 “Configure” 클릭
  4. 커넥터를 켠 뒤, 아직 설치하지 않았다면 확장 프로그램을 다운로드 및 설치

 

이 단계를 완료하면 Claude와의 채팅 화면에 있는 Connectors 드롭다운에 Claude in Chrome이 추가된다. 이 기능은 기본적으로 비활성화되어 있어서 각 대화마다 수동으로 활성화해야 한다. 또한 Haiku 4.5, Sonnet 4.5, Opus 4.5 모델에서만 작동하며, 채팅 창에서 다른 모델을 선택하면 커넥터가 비활성화된다.

 

이러한 통합을 위해 직접 단계를 기록해 Claude에게 워크플로우를 가르치고 Claude가 이를 학습해 반복 실행할 수 있는 워크플로우 기록(Record a workflow) 기능과 오류, 네트워크 요청, DOM 상태를 포함한 브라우저 콘솔 출력을 읽는 콘솔 로그(Console Log) 기능, 정해진 일정에 따라 자동으로 브라우저 반복 작업을 설정할 수 있는 예약 작업(Scheduled tasks) 기능, Claude가 먼저 실행 계획을 작성해 승인을 받은 뒤, 승인된 범위 내에서 전체 워크플로우를 독립적으로 실행하는 실행 전 묻기(Ask before acting) 기능 등이 추가되었다.

물론 앤트로픽은 해당 브라우저 사용 기능이 사용자를 대신해 Claude가 웹사이트와 직접 상호작용할 수 있게 하는 베타 기능이므로, 위험 요소가 존재하여 사용 전에 Chrome에서 Claude를 안전하게 사용하기 문서를 반드시 검토할 것을 권장하고 있다.

 

 

 

[ Claude Skills ]

Claude Skills란 연관된 작업을 수행할 때 처리하기 위한 지침, 스크립트, 리소스가 담긴 폴더로, 이를 특정 도메인에 대한 전문 지식을 Claude에게 부여하는 전문화된 훈련 매뉴얼이다. Claude가 어떤 작업을 접하면, 사용 가능한 Skills를 스캔해 관련된 항목을 찾고, Skills 내용을 참고해서 작업을 수행하게 된다.

Skills는 점진적 공개(progressive disclosure) 방식을 사용한다. 이를 통해 Skills는 토큰의 사용량을 획기적으로 낮출 수 있었다고 한다.

  1. 먼저 Skill이 연관된 작업이 있는지를 판단하기 위한 메타데이터가 로드됨(~100 토큰)
  2. Claude가 특정한 Skill을 적용할지 여부를 판단함
  3. Skill을 적용하고자 한다면 그때서야 전체 지침이 로드됨(<5,000 토큰)
  4. 이후 작업을 수행하면서 번들된 파일이나 스크립트가 필요해진다면, 그때 로드됨

 

 

Skills는 Claude가 특정한 작업을 일관되고 효율적으로 수행해야 할 때 적합하다.

  • ex) 조직 워크플로: 브랜드 가이드라인, 컴플라이언스 절차, 문서 템플릿
  • ex) 도메인 전문성: Excel 수식, PDF 조작, 데이터 분석
  • ex) 개인 선호 반영: 노트 정리 방식, 코딩 패턴, 연구 방법론

 

프롬프트는 대화 중에 Claude에게 자연어로 제공하는 지침인데 해당 지침이 반복될 수 있다. 따라서 이러한 순간에 그리고 전문 적인 지식이 필요하다면, 프롬프트 내용을 Skills로 만들어 활용하는 것도 고려해볼법하다. 만약 Subagents를 활용하고 있다면, 각각의 Subagents들은 Skills를 활용하게 될 것이므로, 유용하다.

일부 사람들이 MCP와 Skills의 차이를 헷갈려 하곤 한다. 이전 포스팅에서 살펴보았듯 MCP는 LLM을 외부 시스템(IDE, GitHub, Slack 등) 에 연결하기 위한 오픈 표준으로, 데이터가 존재하는 곳에 Claude가 직접 접근할 수 있게 해준다. 그리고 MCP를 기반으로 구현한 MCP 서버는 데이터와 기능을 외부로 노출하고, MCP 클라이언트는 이 서버에 연결하여 데이터를 활용하게 된다. 즉, MCP는 데이터 접근을 가능하게 하는 것이다.

반면 Skills는 그 데이터를 어떻게 활용할지 가르친다. 따라서 MCP가 접근한 데이터들을 기반으로 작업을 수행하려고 할 때, Claude는 적용 가능한 Skills를 확인하고, 이를 기반으로 처리하여 일관된 결과를 제공할 수 있는 것이다. 따라서 MCP와 Skills는 상호보완적인 존재이므로 함께 사용해줄 필요가 있다.

  • ex) “데이터베이스에 접근해야 한다” → MCP
  • ex) “데이터베이스를 사용할 때 항상 날짜 범위로 먼저 필터링하라” → Skill
  • ex) “Excel 보고서는 이 특정 수식으로 포맷해라” → Skill

 

 

이미 다른 사람들이 만들어 둔 Skills를 활용할 수 있는 Skills Supermarket도 존재하므로 이미 작성된 Skills를 활용하는 것도 바람직하다. 또한 최근 Notion에서 사용중인 Claude Skills 예시를 공개한 바가 있다. 따라서 이를 활용해서 우리가 사용할 Skills 역시 만들어보면 좋을 것이다.

 

 

  • notion-meeting-intelligence: Notion에서 관련 컨텍스트를 모아 회의 자료를 준비하고, 사전 읽기 자료와 아젠다를 생성합니다.
  • notion-research-documentation: 여러 페이지에서 얻은 결과를 종합해 구조화된 리서치 보고서로 만들어 줍니다.
  • notion-knowledge-capture: 대화 내용을 Notion의 구조화된 문서로 변환합니다.
  • notion-spec-to-implementation: 제품/기술 스펙을 실제 실행 가능한 Notion 작업(Task)으로 전환합니다.

 

 

[ Hooks ]

Hooks는 Claude가 tool을 실행하려고 하기 전이나 후에 명령을 실행할 수 있게 해주는 기술이다. 예를 들어 파일 수정 후 코드 포매터를 실행하거나, 파일 변경 시 테스트를 돌리거나, 특정 파일에 대한 접근을 차단하는 등 자동화된 워크플로우를 구현하는 데 매우 유용하다. Hooks에는 두 가지 타입이 있다.

  • PreToolUse hooks: 도구가 호출되기 이전에 실행
  • PostToolUse hooks: 도구가 호출된 이후에 실행

 

 

 

그리고 다른 것들과 마찬가지로 Hooks는 Claude 설정 파일에 정의되며, 다음 위치 중 하나에 추가할 수 있다. Hooks는 설정 파일에 직접 작성할 수도 있지만, Claude Code 내부에서 /hooks 명령을 사용해 설정할 수도 있다.

  • Global: ~/.claude/settings.json (모든 프로젝트에 적용)
  • Project: .claude/settings.json (팀과 공유)
  • Project (커밋되지 않음): .claude/settings.local.json (개인 설정)

 

 

Hooks가 활용되는 가장 대표적인 사례는 Claude가 .env 같은 민감한 파일을 읽지 못하도록 막는 것이라고 한다. Read 도구뿐 아니라 Grep 도구도 파일 내용을 접근할 수 있으므로, 두 도구 모두를 감시하고 제한된 경로에 접근하는지 확인해야 한다. 이 방식은 Claude의 파일 시스템 접근을 완전히 통제하면서도, 특정 작업이 왜 제한되었는지에 대해 명확한 피드백을 제공할 수 있다.

이러한 Hooks는 크게 다음과 같은 경우에 많이 사용된다고 한다.

  • 코드 포매팅: Claude가 파일을 수정한 뒤 자동으로 포매터 실행
  • 테스트: 파일 변경 시 테스트 자동 실행
  • 접근 제어: 특정 파일에 대한 읽기/수정 차단
  • 코드 품질 관리: 린터나 타입 체커 실행 후 결과를 Claude에게 전달
  • 로깅: Claude가 접근하거나 수정한 파일 추적
  • 검증: 네이밍 규칙이나 코딩 컨벤션 검사

 

 

 

[ Tool Search Tool 기능 준비중 ]

앤트로픽에서 MCP-CLI라는 실험 기능을 통해 Tool Search Tool 기능을 테스트 중인데, 토큰 소비를 대폭 줄여주는 새로운 방식이다. 기존에는 MCP 서버가 모든 tool definition을 system prompt에 다 올려서 토큰을 매우 많이 사용했었고, 이로 인해 컨텍스트가 줄어들고 compaction이 자주 일어나는 등의 문제가 생겼다. 하지만 MCP-CLI를 활용하면 필요한 툴 정보만 그때그때 요청하는 on-demand 방식이 가능해진다. 대용량 JSON 같은 건 파일로 빼거나 jq로 처리 가능한 구조를 실험중이다. 이를 사용하기 위해서는 Claude Code 2.0.56 이상에서 ENABLE_EXPERIMENTAL_MCP_CLI=true 를 설정하면 사용 가능하다.

 

 

 

[ Anthropic, MCP를 Linux Foundation에 기증하다 ]

Linux Foundation은 Agentic AI Foundation (AAIF)를 설립했고, 에이전트형(autonomous) AI 개발을 위한 개방형, 중립적 오픈소스 거버넌스를 구축하고 산업 전체의 협력과 혁신을 촉진하고자 하였다. 그리고 재단 설립 초기에 다음의 핵심 기술/프로젝트가 기여되었다.

  • Model Context Protocol (MCP): Anthropic이 기여한 AI 모델이 외부 도구, 데이터 및 애플리케이션과 연결되는 표준 프로토콜
  • goose: Block이 기여한 오픈소스 AI 에이전트 프레임워크로, MCP 기반 구조와 로컬 중심 실행 환경을 제공함
  • AGENTS.md: OpenAI가 기여한 에이전트 코드 및 동작 지침 형식의 표준으로, 다양한 리포지토리와 도구에서 일관된 에이전트 행동을 정의할 수 있게 함

 

 

이 과정에서 AWS, Anthropic, Block, Bloomberg, Cloudflare, Google, Microsoft, OpenAI 등 주요 AI·클라우드·인터넷 기업들이 Platinum 멤버로 참여했다고 한다. 이전에는 Open AI에서도 MCP가 아닌 자체적인 프로토콜을 구축하려고 했지만, 앤트로픽이 MCP를 Linux Foundation에 기증하면서 이러한 반복 작업을 하지 않게 되었다.

 

 


관련 포스팅

 

 

 

참고 자료

 

 

 

 

 

반응형
댓글
반응형
공지사항
최근에 올라온 글
최근에 달린 댓글
Total
Today
Yesterday
링크
TAG more
«   2026/01   »
1 2 3
4 5 6 7 8 9 10
11 12 13 14 15 16 17
18 19 20 21 22 23 24
25 26 27 28 29 30 31
글 보관함