카테고리 · 11편
AI 코딩 도구
Claude Code·Codex·MCP 를 실제 작업에 붙여 쓰면서 부딪힌 설정과 제약.
도구 사용법이 아니라 실제로 붙여 쓰다 막힌 지점입니다. 설정이 어디 저장되는지, 지난 작업 기록이 어디 남는지, 에이전트가 무엇을 못 하도록 막혀 있는지.
프롬프트 요령은 없습니다. 파일 경로와 권한 경계처럼 확인하면 답이 나오는 것만 다룹니다.
Paseo 의 Project·Workspace·Tab 을 worktree 작업 단위로 끊는 법
같은 폴더에서 paseo run 을 반복하면 워크스페이스가 계속 새로 생긴다. 계층이 무엇에 대응하는지, 1 워크스페이스=1 워크트리=1 브랜치를 어떻게 지키고 CLI 로 검증하는지.
Paseo 페어링이 timeout 날 때, 릴레이 장애부터 의심하지 마라
셀프호스팅 Paseo 데몬에 폰을 페어링하는데 Connection timed out. 릴레이가 죽었나 싶지만 대개는 Server ID 불일치다. 릴레이를 의심하기 전에 봐야 할 진단 순서.
Paseo 에서 계정별 env 가 resume 뒤 사라진다 — provider override 로 고정하기
paseo run --env 로 넣은 CLAUDE_CONFIG_DIR 은 에이전트 생성 순간에만 산다. 재시작·resume 하면 조용히 데몬 기본 계정으로 돌아간다. 며칠 뒤 폰에서 이어 쓰면 엉뚱한 계정으로 청구되는 형태라 눈치채기 어렵다.
브라우저 없는 원격 서버에서 Codex CLI 로그인 — device authorization
ssh 전용 헤드리스 서버에서 codex login 은 로컬 콜백 서버를 띄우고 브라우저를 기다리다 끝나지 않는다. --device-auth 로 코드만 옮겨 로그인하고, auth.json 과 login status 로 실제 완료를 검증한다.
AI CLI 의 --resume 이 세션 ID 를 알아도 못 찾는 이유 — cwd 스코프
세션 ID 를 정확히 넘겼는데 No conversation found 가 뜬다. 세션이 작업 디렉터리 단위로 스코프되기 때문이다. 최소 재현과 실제 해결.
헤드리스 AI CLI 의 인증 실패가 "정상 빈 결과"로 위장한다 — subprocess returncode 함정
cron 에서 돌던 AI CLI 배치가 열흘간 조용히 전량 실패했다. 로그엔 에러가 없었다. OAuth 세션이 만료됐는데 호출부가 종료코드를 안 봐서, 401 로 죽은 빈 stdout 이 도메인상 정상 결과와 구분 불가능하게 섞인 게 원인이었다.
Claude Code 설정을 여러 기기로 옮기기 — 통째 복사 대신 4분류
AI CLI 하네스(룰·훅·플러그인·시크릿)를 여러 기기에서 재현할 때, config·인증·캐시·시크릿을 어떻게 분리해야 조용히 안 깨지는지.
systemd 로 띄운 AI CLI 의 bash 도구에서만 명령이 PATH 에서 사라진다
터미널에선 잡히는 명령이 에이전트 bash 도구에선 not found. 원인은 systemd → 데몬 → 셸 스냅샷으로 이어지는 4중 PATH 레이어였다.
유실된 줄 알았던 리서치는 세션 트랜스크립트에 남아 있다
서브에이전트에게 시킨 대량 조사에서 최종 요약만 기록하고 원본은 버린 줄 알았는데, 세션 JSONL 은 삭제되지 않고 영구 보존된다. 위치와 파싱 방법.
Claude Code auto mode 가 셀프 머지를 막는다 — 우회하지 말 것
에이전트가 자기가 만든 PR 을 병합하려 하면 차단된다. 차단을 풀려고 설정을 고치는 것도, 그 설정 파일을 읽는 것도 막힌다. 버그가 아니라 의도된 경계다.
claude mcp add 로 등록했는데 목록에 안 보인다 — 기본 scope 는 local
MCP 서버를 등록해도 다른 디렉터리에서 연 세션에서는 안 보인다. 기본 scope 가 local 이라 실행한 cwd 아래에만 저장되기 때문이다.