분류 전체보기 20

클로드 코드 에이전트 만들기(claude code custom agents): 같은 지시를 되풀이할 때 만들고 호출 기록이 0이어도 바로 지우지 않는다

에이전트 파일을 쓰기 전에 같은 지시로 같은 일을 몇 번이나 맡겼는지부터 세어 보자. 클로드 코드 에이전트(공식 문서 이름은 클로드 코드 서브에이전트)는 마크다운 파일 하나로 만들어진다. 따질 건 그 전에 넷. 같은 일을 같은 지시로 되풀이하고 있나, description 이 이 에이전트 하나만 골라내나, 어느 프로젝트에 둘까, 도구는 무엇만 줄까? 만들어 두고 안 쓰는 에이전트도 공짜는 아니다. description 이 컨텍스트를 차지하니까. 그래도 호출 기록이 0이라는 이유만으로 바로 지우지는 말 것. 프로젝트가 바뀌면 다시 불릴 수 있다. 출처는 Claude Code 서브에이전트 문서 · .claude 폴더 문서, 2026-10-21 조회.1. 만들 이유: 같은 일을 같은 지시로 되풀이할 때 (20..

카테고리 없음 2026.10.23

클로드 코드 서브에이전트 사용법(claude code subagents): .claude/agents/ 에 파일 하나로 만들고 검토는 쓴 쪽과 다른 서브에이전트에 맡긴다

같은 종류의 일을 매번 같은 지시로 맡기고 있다면 그 지시를 서브에이전트 파일 하나로 만들어 두면 된다. 클로드 코드 서브에이전트 사용법은 세 걸음. 프로젝트의 .claude/agents/(나만 쓰려면 ~/.claude/agents/)에 마크다운 파일을 하나 두고 맨 위 frontmatter 에 name · description 을 적은 뒤 그 아래에 서브에이전트가 따를 지시를 쓴다. 그다음엔 Claude가 description 을 보고 알아서 맡기거나 내가 이름 · @ 로 직접 맡긴다. 작업은 서브에이전트의 컨텍스트 창 안에서 돌고 메인 대화로 돌아오는 건 요약뿐. 쓸 도구는 tools 로 좁힌다. 빼 두면 쓸 수 있는 도구를 전부 물려받으니까. 여기에 우리 기준 하나를 더하면, 검토는 쓴 쪽과 다른 ..

카테고리 없음 2026.10.21

코드나라 구글 도구 개인정보처리방침

시행일: 2026년 10월 20일「코드나라 도구」는 코드나라(블로그 code-nara.tistory.com 과 같은 이름의 YouTube 채널) 운영자가 혼자 쓰려고 만든 도구입니다. 하는 일은 두 가지입니다. 운영자 채널에 영상을 올리고, 운영자 채널과 블로그의 지표를 받아 기록합니다. 다른 사람이 이 도구로 로그인하거나 자기 계정을 연결하는 기능은 없습니다.이 도구는 YouTube API 서비스를 씁니다. 이 도구를 쓰면 YouTube 서비스 약관(https://www.youtube.com/t/terms)에 동의하는 것이 됩니다. 구글이 정보를 어떻게 다루는지는 구글 개인정보처리방침(https://policies.google.com/privacy)에 있습니다.1. 구글에 요청하는 권한과 다루는 정보권..

카테고리 없음 2026.10.20

클로드 코드 MCP 연결 · 설정(claude code mcp setup): claude mcp add 한 줄로 붙이고, 읽기 도구만 승인 없이 열어 둔다

붙이는 건 명령 한 줄이고, 손이 더 가는 건 붙인 다음이다. Claude Code에 MCP 서버를 연결하는 명령은 claude mcp add. 원격 서버는 --transport http 와 주소를, 내 컴퓨터에서 도는 서버는 -- 뒤에 실행 명령을 적는다. 설정이 어디에 저장될지는 --scope 로 고르고, 기본은 지금 프로젝트에서 나만 쓰는 local. 붙인 뒤엔 claude mcp list 로 연결을 확인하고 곧바로 도구 권한을 정한다. 우리 기준은 읽기 도구만 승인 없이 쓰게 하고, 바깥을 바꾸는 쓰기 · 입력 도구는 계속 승인을 거치게 두는 것. 출처는 Claude Code MCP 문서 · 권한 문서 · 설정 문서 · 훅 문서 · MCP 공식 소개, 모두 2026-10-20 조회.MCP 서버를 ..

카테고리 없음 2026.10.20

클로드 코드 텔레그램 연동 · claude code telegram notification: Notification 훅에 sendMessage 한 번, 부르는 건 승인이 필요할 때만

필요한 건 셋: 봇 토큰, 알림을 받을 대화의 chat_id, Claude Code 설정 파일의 Notification 훅 한 블록. Claude Code는 입력이나 권한 승인을 기다릴 때 알림을 보내고, 그때 Notification 훅이 돈다. 훅이 부르는 스크립트는 텔레그램 Bot API sendMessage 한 번이면 끝. matcher 에 permission_prompt 를 적으면 도구 사용 승인을 기다릴 때만 보낸다. 남는 건 어느 순간에 부르게 하느냐인데, 우리는 승인이 필요한 순간에만 보내고 일반 승인 요청의 답은 텔레그램 답장이 아니라 작업하던 채팅에서 받는다. 출처는 Claude Code 훅 문서 · 훅 안내 · 채널 문서 · Telegram Bot API · 봇 기능 문서, 모두 202..

카테고리 없음 2026.10.20

claude code skills vs agents · 클로드 코드 스킬 vs 서브에이전트: 지금 대화에서 다시 쓸 절차는 스킬, 결과만 받을 일은 서브에이전트

「다시 쓸 프롬프트나 작업 흐름을 서브에이전트의 독립 컨텍스트가 아니라 메인 대화 컨텍스트에서 돌리고 싶다면, 대신 스킬을 고려하라.」 Claude Code 서브에이전트 문서의 한 줄을 옮기면 이렇다. 두 기능을 가르는 건 결국 일이 어느 컨텍스트에서 도느냐. 스킬(SKILL.md)은 Claude가 지금 대화 안에서 꺼내 쓰는 지시이고, 서브에이전트(.claude/agents/)는 자기 컨텍스트 창에서 일한 뒤 결과만 돌려주는 전문 조수다. 그래서 대화를 이어 가며 같이 쓸 절차는 스킬에, 출력이 길거나 도구를 묶어야 하거나 혼자 끝낼 수 있는 일은 서브에이전트에 둔다. 기준은 2026년 10월 19일에 읽은 Claude Code 공식 문서(Skills · Subagents).claude code ski..

카테고리 없음 2026.10.19

claude.md agents.md 차이 · claude code agents.md: 공통 규칙은 AGENTS.md 에 두고 CLAUDE.md 는 불러오기 한 줄과 Claude 전용만

작업 폴더나 그 위에 CLAUDE.md 가 있으면 Claude Code는 기본값에서 AGENTS.md 를 읽지 않는다. 두 파일의 차이는 결국 누가 읽느냐에서 갈린다. CLAUDE.md 는 Claude Code가 읽는 지시 파일, AGENTS.md 는 Codex를 비롯한 여러 코딩 에이전트가 같이 읽는 공개 형식의 지시 파일. 그래서 둘 다 쓴다면 공통 규칙은 AGENTS.md 한 곳에 적고, CLAUDE.md 에는 @AGENTS.md 한 줄과 Claude Code에만 필요한 지시를 둔다. 기준은 2026년 10월 16일에 읽은 Claude Code · Codex 공식 문서와 agents.md 사이트다.claude.md 와 agents.md 차이 한눈에 (2026-10-16 공식 문서 기준)세 곳에 적힌..

카테고리 없음 2026.10.16

claude.md 파일 위치 · 클로드 코드 claude.md 작성법: 저장소 맨 위 CLAUDE.md 에, 200줄 안쪽으로 매번 필요한 것만

claude.md 는 어디에 둬야 Claude Code가 읽을까? 팀이 같이 쓸 프로젝트 규칙은 저장소 맨 위 CLAUDE.md(또는 .claude/CLAUDE.md)에 둔다. 모든 프로젝트에 쓸 내 취향은 ~/.claude/CLAUDE.md, 이 프로젝트에서 나만 쓸 설정은 CLAUDE.local.md, 한 폴더에만 해당하는 규칙은 그 폴더 안의 CLAUDE.md. 작성법의 요점은 셋, 파일당 200줄 아래로 짧게, 맞았는지 확인할 수 있게 구체적으로, 코드를 보면 알 수 있는 내용은 빼고. 기준은 2026년 10월 14일에 읽은 Claude Code 공식 문서다.claude.md 파일 위치 네 곳과 읽히는 순서 (2026-10-14 공식 문서 기준)Claude Code 메모리 문서가 드는 위치를 개인..

카테고리 없음 2026.10.14

유튜브 api 키 발급 · YouTube Data API 키: 코드에 넣기 전 확인할 것 세 가지(API 제한 · .env 보관 · 교체 순서)

유튜브 API 키 발급은 Google Cloud 콘솔에서 버튼 몇 번이면 끝난다. 코드에 넣기 전에 볼 건 세 가지. 키가 YouTube Data API v3 만 부르도록 제한했는지, 키를 코드 밖 .env 에 두고 git 에서 뺐는지, 키를 바꿀 때 새 키로 실제 호출을 확인한 뒤에 옛 키를 지우는지. 기준은 2026년 10월 13일에 읽은 Google Cloud · YouTube Data API 공식 문서다.유튜브 API 키 발급 순서 (2026-10-13 공식 문서 기준)YouTube Data API 시작 문서가 적는 준비는 프로젝트, API 사용 설정, 인증 정보 세 가지.Google Cloud 콘솔에서 프로젝트를 만든다. 이미 있으면 그 프로젝트를 고른다.사용 설정된 API 목록(Enabled ..

카테고리 없음 2026.10.13

코덱스 사용량 확인 · codex cli 사용량: /status 와 사용량 대시보드로 5시간 · 주간 한도 보는 법

코덱스(Codex CLI) 사용량 확인은 세션 안에서 /status 한 줄. 남은 한도가 거기 나온다. 계정 전체 사용량과 초기화 시각은 ChatGPT의 Codex 사용량 대시보드에서 본다. 한도는 5시간 창과 주간 창, 두 칸(Plus 기준, 문서상 Pro 는 지금 5시간 한도 없음). 둘은 따로 차기 때문에 둘 다 봐야 한다. 기준은 2026년 10월 13일에 조회한 OpenAI 공식 문서.Codex CLI 안에서 남은 한도 보기: /status (2026-10-13 공식 문서 기준)OpenAI의 Codex 가격 · 한도 문서에는 이렇게 적혀 있다.If you want to see your remaining limits during an active Codex CLI session, you can u..

카테고리 없음 2026.10.13