빅베어로그

#claude-code 태그 글 목록

  1. Claude Code AGENTS.md 설정: 안 읽히는 파일과 하위 폴더 규칙

    읽는 시간 약 8분 시작 가이드

    Claude Code는 CLAUDE.md가 없으면 AGENTS.md를 읽지만 AGENTS.override.md·AGENTS.local.md·.agents/는 읽지 않습니다. 하위 폴더 AGENTS.md가 붙는 조건과 Project instructions를 둘 자리도 직접 확인했습니다.

  2. Claude Code vs Codex vs Antigravity: 같은 버그 4개 고치기 비교 (2026)

    읽는 시간 약 6분 비교·선택

    Claude Code, Codex CLI, Antigravity CLI에 같은 주문 정산 버그 4개를 세 번씩 맡겼습니다. 세 도구 모두 전부 고쳤고 차이는 시간(53초·73초·227초)과 토큰에서 났습니다. Windows에서 비대화로 돌릴 때 막힌 곳도 정리했습니다.

  3. Claude Code가 스스로 테스트하게 하기: Stop 훅까지 19번 돌려 보니

    읽는 시간 약 9분 자동화 워크플로

    Claude Code에 같은 버그 수정을 19번 맡겨, 테스트 파일·CLAUDE.md·Stop 훅이 결과를 어떻게 바꾸는지 봤습니다. 테스트가 없으면 3번 모두 버그 하나를 놓쳤고, stop_hook_active를 안 본 Stop 훅은 24번 막혔습니다.

  4. Claude Code 모델 비교: Opus·Sonnet·Haiku 5.5를 effort별로 108번 돌려 보니

    읽는 시간 약 6분 비교·선택

    Claude Code에서 Opus 5.5, Sonnet 5.5, Haiku 5.5를 effort low~xhigh로 바꿔 같은 과제 세 개를 108번 돌렸습니다. 107번이 만점이었고 Haiku는 비용이 Opus의 17~27분의 1이었습니다. 모델별 비용·시간 그래프와 고르는 기준.

  5. Claude Code effort 비교: low부터 max까지 30번 돌려 본 결과

    읽는 시간 약 7분 비교·선택

    Claude Code의 effort를 low·medium·high·xhigh·max로 바꿔 같은 과제를 30번 돌렸습니다. 결과는 거의 같았고 max는 출력 토큰이 20~40배, 시간이 18~32배였습니다. 단계별 토큰·시간·비용과 고르는 기준을 정리했습니다.

  6. Could not locate the Claude CLI on PATH 오류 해결 (VS Code)

    읽는 시간 약 10분 문제 해결

    VS Code 확장이 Could not locate the Claude CLI on PATH로 멈출 때 where.exe로 원인을 가르고, PATH를 PowerShell 프로필 대신 사용자 환경 변수에 넣은 뒤 VS Code를 다시 시작하는 순서입니다.

  7. Claude Code 학습·데이터 보존: 내 코드가 남는 곳과 기간

    읽는 시간 약 13분 요금·정책

    Claude Code에 보낸 코드가 학습에 쓰이는지는 계정 종류가, 서버 보존 기간은 학습 허용 여부가 정합니다. /feedback·설문·텔레메트리처럼 따로 나가는 것과 로컬 평문 기록까지 직접 확인해 정리했습니다.

  8. Claude 앱·Claude Code·Cowork 차이: 같은 계정으로 어디서 무엇을 하나

    읽는 시간 약 12분 비교·선택

    코드 작업은 Claude Code, 문서·조사는 Cowork, 질문은 채팅. 하려는 일별로 무엇을 열면 되는지, 채팅과 Cowork 통합 뒤 달라지는 것, 터미널·데스크톱·클라우드 사이에서 세션을 옮기는 법을 정리했습니다.

  9. Claude Code로 HWP 파일 읽기·수정: 직접 해 본 결과

    읽는 시간 약 10분 자동화 워크플로

    Claude Code에 .hwp를 그대로 주면 앞 1,023자 미리보기만 읽고 한글 항목명은 추측으로 채웠습니다. PDF로 저장하면 정확히 읽고, HWPX로 저장하면 XML을 고쳐 한글에서 다시 열 수 있었습니다.

  10. Claude Code exit code 137: 실행 중 SIGKILL 원인과 해결

    읽는 시간 약 11분 문제 해결

    Claude Code process exited with code 137은 SIGKILL로 끝났다는 뜻입니다. 커널 로그에 Killed process가 있으면 메모리 부족, 없으면 띄운 앱이나 스크립트를 봅니다. Linux에서 직접 재현한 결과와 가르는 순서를 정리했습니다.

  11. Claude Code 모델 변경: 5가지 방법과 우선순위

    읽는 시간 약 13분 시작 가이드

    Claude Code 모델은 /model, --model, ANTHROPIC_MODEL, 설정 파일, ANTHROPIC_DEFAULT_MODEL 순으로 이깁니다. 별칭이 가리키는 버전, 작업별 모델·노력 수준, 바꾼 모델이 안 남을 때 확인 순서를 정리했습니다.

  12. Claude Code 명령어·단축키 사용법: 슬래시 명령과 Windows 단축키

    읽는 시간 약 13분 시작 가이드

    Claude Code 슬래시 명령은 메시지 맨 앞에 있어야 실행됩니다. 자주 쓰는 명령의 한 줄 용도, 응답 중에 보낸 명령이 가는 곳, 먼저 익힐 단축키와 Windows에서 안 먹히는 조합(Shift+Tab, Shift+Enter)을 정리했습니다.

  13. 클로드 코드(Claude Code) 업데이트: 설치 방식별 명령과 안 될 때

    읽는 시간 약 9분 시작 가이드

    Claude Code 업데이트 명령은 설치 방식마다 다릅니다. claude doctor로 설치본을 확인하고 네이티브·npm·Homebrew·WinGet·apt별 명령, 채널·버전 고정, 자동 업데이트 끄기, 버전이 안 바뀔 때 볼 곳을 정리했습니다.

  14. 클로드 코드(Claude Code) 토큰 절약: 직접 재 본 8가지 방법

    읽는 시간 약 11분 자동화 워크플로

    Claude Code 토큰을 줄이는 8가지 방법을 직접 재 봤습니다. 로그는 필요한 부분만 넘기고, 읽을 파일을 지정하고, CLAUDE.md를 줄이는 것이 효과가 컸고 /compact·서브에이전트는 그 자체로 비용이 듭니다.

  15. Claude Code·Codex 한글 깨짐: Windows에서 원인과 해결

    읽는 시간 약 9분 문제 해결

    Windows PowerShell 5.1에서 Claude Code·Codex CLI·Antigravity CLI의 한글이 깨지는 세 경우(출력 받기, 파이프 입력, 에이전트가 만든 .ps1)를 직접 재현하고 프로필 네 줄과 BOM 저장으로 고친 결과입니다.

  16. Claude Code plan 모드 사용법: 들어가는 법 3가지와 건너뛸 기준

    읽는 시간 약 12분 자동화 워크플로

    클로드 코드(Claude Code) plan 모드는 Shift+Tab, /plan, --permission-mode plan으로 들어가고, diff를 한 문장으로 설명할 수 있으면 건너뜁니다. Ctrl+G로 계획 고치기, 승인 때 컨텍스트 비우기, opusplan을 정리했습니다.

  17. Claude Code 권한 모드 고르기: 수동·plan·auto·dontAsk는 언제 쓰나

    읽는 시간 약 17분 개념 설명

    편집만 맡기면 acceptEdits, 긴 작업은 auto, 훑기만 하면 plan, 사람이 없는 파이프라인은 dontAsk입니다. 권한 모드 여섯 개가 묻지 않고 하는 일, 시작 모드가 정해지는 순서, Shift+Tab 순환을 정리했습니다.

  18. Claude Code 훅이 작동 안 할 때: /hooks부터 4단계 점검

    읽는 시간 약 18분 문제 해결

    Claude Code 훅이 작동하지 않으면 /hooks 등록, 매처, 스크립트 실행, JSON 해석 순으로 끊긴 곳을 찾습니다. Failed with non-blocking status code, 종료 코드 126·127, Windows의 Bash 매처·jq·역슬래시 문제까지 다룹니다.

  19. Claude Opus 5.5 vs Fable 5.1: 벤치마크·가격 비교와 고르는 법

    읽는 시간 약 14분 비교·선택

    Claude Opus 5.5는 발표 벤치마크 9개 모두에서 Fable 5.1을 앞서고 가격은 40%입니다. 같은 과제를 직접 맡긴 결과, 그래도 Fable 5.1을 고를 때, Claude Code에서 쓰는 법과 안전장치 오탐을 정리했습니다.

  20. Claude Code 플러그인: 무엇을 묶어 오고, 설치 전에 무엇을 봐야 하나

    읽는 시간 약 14분 시작 가이드

    Claude Code 플러그인은 스킬·에이전트·훅·MCP 서버를 한 번에 켜는 묶음입니다. 설치 전에 볼 구성 요소·컨텍스트 비용·설치 범위·자동 업데이트를 정리하고, 빈 설정 폴더에서 설치부터 제거까지 직접 실행한 결과를 실었습니다.

  21. Claude Code 설치·로그인 오류 해결: command not found 등

    읽는 시간 약 18분 문제 해결

    Claude Code 설치가 멈춘 단계를 먼저 가르고 command not found: claude, exit code 137, claude.exe 호환 오류, OAuth error: Invalid code, API Error: 403 등 문구별 원인과 해결을 정리했습니다.

  22. Claude Code 설정 파일 우선순위: settings.json 네 곳 중 어디에 둘까

    읽는 시간 약 14분 시작 가이드

    같은 키는 managed → 명령줄 → settings.local.json → 공유 settings.json → 사용자 파일 순으로 이깁니다. 키를 둘 자리를 고르는 법, 합쳐지는 키, 시작한 폴더에 따라 읽히는 파일을 정리했습니다.

  23. Claude Code 설정이 적용되지 않을 때: /status·claude doctor로 확인하는 순서

    읽는 시간 약 12분 문제 해결

    훅·권한·CLAUDE.md를 고쳤는데 그대로일 때 /context·/status로 읽혔는지, claude doctor로 거부됐는지, 위 단계가 덮었는지, --safe-mode로 비교하는 네 단계 확인 순서를 정리했습니다.

  24. Claude Code 비용·한도 길잡이: 구독 한도와 API 요금 줄이는 법

    길잡이 읽는 시간 약 6분 요금·정책

    Claude Code 한도에 막혔을 때와 API 요금을 줄이고 싶을 때 할 일은 다릅니다. 모델 전환·컨텍스트 줄이기·캐싱이 각각 어디에 듣는지와 상황별로 볼 글을 정리했습니다.

  25. Claude Code 자동화 길잡이: 지시 파일·스킬·훅·비대화형 실행 고르기

    길잡이 읽는 시간 약 7분 개념 설명

    같은 설명을 반복하면 CLAUDE.md·스킬, 반드시 실행돼야 하면 훅, 사람 없이 돌리려면 claude -p. 단계별로 무엇을 쓰고, 틀렸을 때 무엇이 되돌려지지 않는지와 상황별로 볼 글을 정리했습니다.

  26. AI 코딩 CLI 오류 해결 길잡이: 설치·로그인·한도·MCP 증상별 순서

    길잡이 읽는 시간 약 9분 문제 해결

    Claude Code·Codex CLI·Gemini CLI가 막혔을 때 --version과 첫 대화 두 가지로 설치·로그인·한도·MCP·설정 중 어디가 문제인지 가르고, 증상별로 볼 글을 정리했습니다.

  27. AI 코딩 CLI 설치 길잡이: 계정별 도구 고르기와 첫 설정 4가지

    길잡이 읽는 시간 약 8분 시작 가이드

    Claude Code·Codex CLI·Gemini CLI 중 이미 가진 계정으로 무엇을 깔지, 도구별 설치·확인 명령, 설치 뒤 손댈 네 가지와 설치·로그인이 막혔을 때 볼 글을 한곳에 모았습니다.

  28. Claude Code .claude 디렉터리: 무엇이 언제 읽히고 무엇이 쌓이기만 하나

    읽는 시간 약 13분 시작 가이드

    Claude Code의 .claude 폴더에서 세션마다 읽히는 설정과 쌓이기만 하는 기록을 갈랐습니다. 읽히는 시점, 프로젝트와 홈의 차이, 30일 자동 정리, claude purge로 지우는 법과 지우면 안 되는 파일을 정리했습니다.

  29. Claude Code 헤드리스 모드(claude -p): 출력 형식과 종료 코드

    읽는 시간 약 11분 자동화 워크플로

    claude -p로 Claude Code를 스크립트·CI에서 실행하는 법. text·json·stream-json 차이, 종료 코드와 is_error로 성패 가르기, 권한 모드와 --bare, Windows에서 버전마다 맞는 허용 규칙이 갈리는 점을 직접 실행해 정리했습니다.

  30. Claude Code 체크포인트와 /rewind: 무엇이 되돌아가고 무엇이 안 되나

    읽는 시간 약 12분 자동화 워크플로

    Claude Code /rewind는 Claude가 편집 도구로 고친 파일만 되돌립니다. 메뉴 항목별로 무엇이 돌아가는지, Bash·서브에이전트·세션 밖 편집처럼 되감기가 닿지 않는 곳, 링크 파일을 건너뛰는 경고와 대처를 정리했습니다.

  31. Claude Code·Codex·Gemini CLI 샌드박스 비교: 경계가 감싸는 범위

    읽는 시간 약 12분 비교·선택

    Claude Code는 셸 명령만, Codex CLI는 모델이 만든 셸 명령을 기본 read-only로, Gemini CLI는 CLI 프로세스 전체나 도구 단위로 감쌉니다. 직접 확인한 기본값과 켜는 법, 승인 축, 막혔을 때의 동작을 비교했습니다.

  32. Claude Code 사용량 확인법: /usage 화면과 5시간·주간 한도

    읽는 시간 약 12분 요금·정책

    Claude Code 사용량은 /usage로 확인합니다. 구독 한도는 토큰으로 줄고 5시간·주간 창에 동시에 쌓입니다. /usage 숫자 중 무엇을 믿을지, 상태 표시줄로 남은 한도를 계속 보는 법, 한도에 걸린 뒤 동작을 정리했습니다.

  33. Claude Code 워크트리로 병렬 세션 돌리기: 만들기·격리 규칙·안전한 정리

    읽는 시간 약 10분 자동화 워크플로

    claude --worktree <이름>으로 세션마다 파일을 나눠 병렬로 돌리는 법. 워크트리가 생기는 위치와 브랜치, 빠지는 .env 채우기, 세션 안에서 막히는 명령, 끝낼 때 지워지는 조건과 남는 조건을 정리했습니다.

  34. Claude Code MCP 서버 연결 실패: ENOENT 등 오류 4가지 해결

    읽는 시간 약 12분 문제 해결

    클로드 코드(Claude Code) MCP 서버가 안 붙을 때 claude mcp list 상태 줄 끝의 ENOENT, CONNECTION_CLOSED, HTTP 405, Missing environment variables 문구별로 볼 곳과 고치는 법을 정리했습니다.

  35. Claude Code 529 Overloaded·사용량 제한 오류: 메시지별 해결

    읽는 시간 약 11분 문제 해결

    Claude Code의 529 Overloaded, not your usage limit, Request rejected (429), hit your session limit, spend limit 메시지별로 무엇이 막혔는지와 기다릴지·모델을 바꿀지·설정을 볼지를 정리했습니다.

  36. Claude Code Windows 경로 문제: 공백·한글·CRLF가 깨뜨리는 곳

    읽는 시간 약 12분 문제 해결

    Windows에서 Claude Code가 경로 때문에 조용히 어긋나는 곳을 정리했습니다. settings.json은 역슬래시 두 번, 권한 규칙은 //c/, 훅은 구분자 정규화. Git Bash 경로, 한글 폴더 충돌, CRLF 스크립트까지 직접 확인했습니다.

  37. Claude Code 샌드박스 설정: /sandbox 켜는 법과 권한 규칙 차이

    읽는 시간 약 16분 개념 설명

    클로드 코드(Claude Code) 샌드박스를 /sandbox나 sandbox.enabled로 켜면 셸 명령이 닿는 파일·네트워크를 운영체제가 막습니다. 권한 규칙과의 차이, 기본 경계, 리눅스·WSL2 준비, 네이티브 Windows에서 켰을 때의 실제 동작을 정리했습니다.

  38. CLAUDE.md·AGENTS.md·GEMINI.md 비교: 하나로 합치는 법

    읽는 시간 약 13분 비교·선택

    Claude Code·Codex CLI·Gemini CLI를 함께 쓴다면 AGENTS.md 하나를 정본으로 두면 됩니다. 도구별로 읽는 파일과 찾는 범위, CLAUDE.local.md 하나로 AGENTS.md가 빠지는 함정, import와 심볼릭 링크 중 무엇을 쓸지 정리했습니다.

  39. Claude Code 훅·스킬·CLAUDE.md 차이와 고르는 기준

    읽는 시간 약 11분 비교·선택

    같은 지시를 CLAUDE.md·훅·스킬에 각각 넣고 직접 돌려 보니 실행 횟수가 1회·2회·0회로 갈렸습니다. 매번 실행이면 훅, 늘 알아야 하면 CLAUDE.md, 가끔이면 스킬로 고르는 기준과 헷갈리는 경계를 정리했습니다.

  40. 프롬프트 인젝션 방어법: Claude Code 설정과 실제 사고 사례 3건

    읽는 시간 약 11분 개념 설명

    프롬프트 인젝션은 에이전트가 신뢰할 수 없는 글을 읽고, 민감한 데이터에 닿고, 밖으로 내보낼 수 있을 때 성립합니다. 공개된 사고 3건과 Claude Code의 방어 계층, 지금 넣을 deny·샌드박스 설정을 정리했습니다.

  41. Claude Code 스킬 만들기: SKILL.md 작성부터 호출 확인까지

    읽는 시간 약 11분 자동화 워크플로

    Claude Code 스킬은 .claude/skills/<이름>/SKILL.md 하나로 만듭니다. 직접 만들어 /이름 호출과 자동 호출을 확인한 결과, 저장 위치, disable-model-invocation, CLAUDE.md·훅과 나누는 기준, 자동 호출이 안 될 때를 정리했습니다.

  42. Claude Code 서브에이전트 만들기: 조사·검토 역할 나누기

    읽는 시간 약 10분 자동화 워크플로

    Claude Code 서브에이전트를 .claude/agents/에 파일 하나로 만드는 법. 조사용은 읽기 도구만, 검토용은 수정 도구를 빼고, 부를 때는 이름으로 직접 부릅니다. model 결정 순서와 tools·model이 안 먹는 사례도 정리했습니다.

  43. Claude Code MCP 서버 연결: stdio·HTTP 설정과 범위 우선순위

    읽는 시간 약 8분 시작 가이드

    claude mcp add로 stdio·HTTP 서버를 붙이는 명령, local·project·user 범위 중 어디에 둘지, 같은 이름이 겹칠 때 이기는 쪽, PowerShell 5.1에서 '--'를 따옴표로 감싸야 하는 이유까지 직접 실행 결과로 정리했습니다.

  44. Claude Code 컨텍스트 관리: /compact·/clear 차이

    읽는 시간 약 11분 개념 설명

    Claude Code 컨텍스트가 차면 자동 압축이 대화를 요약으로 바꾸고, 원문의 세부는 빠집니다. 새 작업은 /clear, 조사는 서브에이전트, 이어 갈 때는 /compact. 직접 잰 압축 전후 수치와 압축 뒤 남는 것·사라지는 것을 정리했습니다.

  45. Claude Code 훅 가이드: 편집 후 포맷, 커밋 전 테스트, 폴더 보호 걸기

    읽는 시간 약 10분 자동화 워크플로

    Claude Code 훅으로 편집 후 자동 포맷(PostToolUse), 커밋 전 테스트 강제와 폴더 쓰기 차단(PreToolUse)을 거는 설정을 정리했습니다. Windows에서 공식 예시가 jq 없이 막지 못하는 문제와 바로 쓸 PowerShell 훅도 담았습니다.

  46. Claude Code 권한 설정: allow·deny 규칙 문법과 자주 새는 패턴

    읽는 시간 약 9분 시작 가이드

    Claude Code 권한 규칙은 deny→ask→allow 순으로 먼저 맞는 것이 이깁니다. allow·ask·deny 문법, 와일드카드 위치·명령 연결·실행기처럼 넓게 열리는 패턴, Windows의 PowerShell(...) 규칙을 정리했습니다.

  47. Claude Code CLAUDE.md 작성법: 위치, 규칙 나누기, /init부터 점검까지

    읽는 시간 약 14분 시작 가이드

    CLAUDE.md는 프로젝트 루트에 /init으로 만들고, 코드만 봐서는 모르는 것만 200줄 안에 적습니다. 네 가지 위치와 읽는 순서, .claude/rules/와 @import로 나누는 법, AGENTS.md와 함께 쓰는 법, 안 지켜질 때 점검 순서를 정리했습니다.

  48. 클로드 코드(Claude Code) Windows 설치: PowerShell 한 줄·오류 6가지

    읽는 시간 약 10분 시작 가이드

    클로드 코드(Claude Code)를 Windows PowerShell에서 irm 한 줄로 설치하고 확인·로그인·첫 작업까지 하는 순서입니다. 'claude' is not recognized, running scripts is disabled 등 오류 6가지 해결 포함.