빅베어로그

시작 가이드 글 목록

Claude Code·Codex CLI·Gemini CLI를 설치하고 로그인한 뒤 지시 파일·권한·MCP 같은 기본 설정을 잡는 과정을 다룹니다. 도구별 설치 명령과 확인 방법, 처음 손댈 설정 파일을 차례대로 정리합니다.

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

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

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

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

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

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

  3. Antigravity CLI 모델 고르기: --model·--effort 규칙

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

    Antigravity CLI(agy)에서 쓸 수 있는 모델 목록과 기본 모델, --model과 --effort를 함께 쓸 때 거부되는 조합을 Windows 11에서 직접 확인하고, 같은 코드 수정 과제를 모델 8개에 맡겨 결과와 시간을 비교했습니다.

  4. Antigravity CLI MCP 서버 연결: agy mcp add와 설정 파일

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

    Antigravity CLI(agy)에 MCP 서버를 붙이는 agy mcp add와 mcp_config.json을 Windows 11에서 직접 확인했습니다. 저장 위치, 연결 실패가 조용히 넘어갈 때 확인하는 법, agy -p에서 필요한 mcp 권한 규칙까지 다룹니다.

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

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

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

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

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

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

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

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

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

  8. Gemini CLI 종료 후 Antigravity CLI 설치·설정 옮기기

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

    Gemini CLI가 2026년 6월 18일부터 개인 무료·AI Pro·Ultra 요청을 멈췄습니다. Antigravity CLI(agy)를 Windows에 설치하고 스킬·MCP 설정을 새 위치로 옮기는 순서, GEMINI.md가 그대로 읽히는지 정리했습니다.

  9. Gemini CLI settings.json: 네 파일이 겹칠 때 어느 값이 이기나

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

    Gemini CLI는 settings.json을 시스템 기본값·사용자·프로젝트·시스템 덮어쓰기 순으로 합치고 뒤 파일이 이깁니다. 배열·mcpServers가 합쳐지는 방식, 폴더 신뢰 때문에 프로젝트 파일이 빠지는 경우를 0.61.0에서 직접 확인했습니다.

  10. Codex CLI config.toml 위치와 우선순위: 값이 무시될 때

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

    Codex CLI 설정 파일은 ~/.codex/config.toml과 신뢰한 프로젝트의 .codex/config.toml입니다. 같은 키는 명령줄 > 프로젝트 > 프로필 > 사용자 순으로 이기고, 폴더 설정이 안 읽히는 이유와 무시되는 키까지 직접 실행해 정리했습니다.

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

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

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

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

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

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

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

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

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

  14. Gemini CLI 컨텍스트 파일: GEMINI.md를 어디에 두면 읽히나

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

    Gemini CLI는 ~/.gemini/GEMINI.md, 저장소 루트까지의 상위 폴더, 하위 폴더의 GEMINI.md를 모두 이어 붙여 읽습니다. 탐색이 .git에서 멈추는 이유, 이름을 바꾸는 context.fileName, 읽혔는지 보는 /memory 명령을 정리했습니다.

  15. Codex CLI 샌드박스 모드와 승인 정책 설정: 무엇이 막히나

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

    Codex CLI 기본값 read-only는 작업 폴더에도 못 씁니다. workspace-write가 쓰는 곳과 막는 곳(.git·.aws·홈), 승인 정책 on-request·never, 없어진 untrusted·--full-auto, Windows에서 다른 점을 정리했습니다.

  16. Gemini CLI 설치 방법: npm·Homebrew 비교와 인증 방식 3가지 고르는 기준

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

    Gemini CLI는 Node.js 20 이상에서 npm install -g @google/gemini-cli 한 줄로 설치합니다. 설치 경로 비교, 설치 확인, Google 로그인·API 키·Vertex AI 중 무엇을 고를지와 2026년 6월 개인 계정 종료 영향을 정리했습니다.

  17. Codex CLI 설치 방법: Windows·macOS 설치와 확인 (WSL 없이)

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

    Codex CLI는 npm install -g @openai/codex 한 줄로 설치하고 codex --version과 codex doctor로 확인합니다. Homebrew·설치 스크립트 고르는 법, Windows에서 WSL 없이 설치한 결과, 로그인, 권한 오류 해결까지 정리했습니다.

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

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

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

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

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

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

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

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

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

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

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

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