빅베어로그

AI 도구·에이전트 실전 가이드

Claude Code, Codex CLI, Gemini CLI 같은 AI 코딩 도구와 에이전트의 설치·비교·자동화·요금·문제 해결 가이드. 글마다 직접 실행한 결과와 공식 문서를 구분해 근거와 확인일을 밝힙니다.

길잡이

주제 하나에 흩어진 글을 읽을 순서대로 잇는 글입니다. 어디서부터 볼지 모르겠다면 여기서 시작하세요.

최신 글

  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 API thinking 400 오류: disabled·between_tools·effort 해결

    읽는 시간 약 13분 문제 해결

    Claude API가 thinking 설정 때문에 400을 돌려줄 때 오류 문구로 원인을 가릅니다. Sonnet 5.5의 disabled 거절과 between_tools, effort xhigh·max 충돌, 끌 수 없는 모델에서 고칠 값을 정리했습니다.

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

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

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