새 컴퓨터에 똑같은 환경 만들기

명령 한 줄, 로그인 두 번, Codex /hooks 한 번이면 끝납니다. 그대로 따르면 Claude Code 와 Codex CLI 가 기존 컴퓨터와 같은 스킬·커맨드·지침·설정으로 동작합니다. 20분 안팎입니다.

• 0. 준비물
• 1. 저장소 clone 과 첫 동기화
• 2. Claude Code 로그인과 확인
• 3. Codex 로그인, 훅 신뢰, 확인
• 4. 터미널에서 최종 점검
• 그 뒤 일상
• 문제가 생기면

---

0. 준비물

→ Homebrew. brew --version 으로 확인, 없으면 https://brew.sh 의 한 줄 설치.

→ git 과 GitHub SSH 키. ssh -T git@github.com 에 “successfully authenticated” 가 나와야 합니다. 없으면 ssh-keygen -t ed25519 뒤 GitHub → Settings → SSH keys 에 공개키를 등록합니다. 저장소가 비공개라 leekh4232 계정의 키여야 합니다.

→ Node.js 20 이상, Python 3. node --version, python3 --version. Node 가 없으면 brew install node, Python 은 macOS 에 들어 있습니다.

→ Claude Code 와 Codex CLI.

npm install -g @anthropic-ai/claude-code @openai/codex
claude --version && codex --version

1. 저장소 clone 과 첫 동기화

→ 한 줄로 설치합니다.

git clone git@github.com:leekh4232/hossam-skills.git ~/workspace/hossam-skills \
  && bash ~/workspace/hossam-skills/common/skills/env-sync/scripts/sync.sh apply

→ 경로는 바꿔도 됩니다. 스크립트가 자기 위치에서 저장소를 찾습니다.

→ 주의: 이미 ~/.claude/skills 같은 폴더에 내용이 있으면 멈출 수 있습니다. 저장소에 없는 항목은 저장소로 옮기고, 양쪽에 다르게 있는 항목은 ❌ 로 멈춥니다. 메시지대로 정리하거나, 로컬 것을 버려도 되면 apply --force 를 씁니다. 백업 파일은 만들지 않습니다.

→ apply 가 하는 일 순서.

1 → 저장소 git pull.

2 → common/skills/* 를 claude/skills/·codex/skills/ 상대 링크로 보충.

3 → 링크 7개: ~/.claude/{skills,commands,CLAUDE.md}, ~/.agents/skills, ~/.codex/{prompts,AGENTS.md,hooks.json}.

4 → ~/.claude/settings.json 에 공유 키 병합(permissions 는 손대지 않음), ~/.codex/config.toml 최상위 키 병합.

5 → attention-span 출력 스타일 3개를 ~/.claude/output-styles/·~/.codex/output-styles/ 에 내려받기.

6 → 깨진 링크 정리, 점검. 마지막 줄이 “모두 정상” 이면 됩니다.

2. Claude Code 로그인과 확인

→ claude 를 띄우고 브라우저 로그인. 로그인 뒤 새 세션에서 확인합니다.

→ 확인 3가지. /memory 에 ~/.claude/CLAUDE.md 가 보이고, /skills 에 da-project-feedback·env-sync·karpathy-guidelines 가 보이고, /plugin 에 humanize-korean@im-not-ai 가 있어야 합니다. 플러그인은 첫 세션에 자동 설치되므로 안 보이면 한 번 더 띄웁니다.

→ 훅은 조용한 게 정상입니다. 세션을 열 때 SessionStart 훅이 돌고 아무 메시지도 남기지 않으면 성공입니다. 문제가 있을 때만 ⚠️·❌ 가 보입니다.

3. Codex 로그인, 훅 신뢰, 확인

→ codex login 으로 ChatGPT 계정 로그인. 유료 플랜(Plus·Pro·Team 등)이어야 합니다.

→ 필수: Codex 안에서 /hooks 를 실행해 hossam-skills 훅을 신뢰(trust). 외부에서 들어온 훅은 한 번 승인해야 돕니다. 이 단계를 빼먹으면 자동 pull 과 Attention Span 출력 스타일 주입이 동작하지 않습니다.

→ 확인 3가지. /skills 또는 $ 에 da-project-feedback·env-sync 가 뜨고, /prompts: 에 deck·quiz·env-sync 가 뜨고, 아무 질문에나 한국어 높임말로 답하면 됩니다.

4. 터미널에서 최종 점검

bash ~/workspace/hossam-skills/common/skills/env-sync/scripts/sync.sh check
ls -l ~/.claude | grep -E 'skills|commands|CLAUDE.md'
ls -l ~/.agents ~/.codex | grep -E 'skills|prompts|AGENTS.md|hooks.json'

→ “모두 정상” 이면 끝입니다.

그 뒤 일상

→ 고치기. ~/.claude/skills/<이름>/, ~/.claude/commands/<이름>.md 를 그대로 편집하면 저장소에 바로 반영됩니다. 링크라서 그렇습니다.

→ 올리기. /env-sync push "메시지"(Codex: /prompts:env-sync push "메시지"). 다른 컴퓨터는 다음 세션을 열 때 자동으로 받습니다.

→ 새 공용 스킬. common/skills/<이름>/SKILL.md 로 만들고 /env-sync 를 한 번 돌리면 양쪽 링크가 생깁니다. 그 링크도 커밋 대상입니다.

문제가 생기면

→ ❌ “…가 저장소 버전과 다름”. 로컬에 다른 내용의 실제 파일이 있는 것입니다. 내용을 저장소 쪽 파일에 합친 뒤 다시 apply, 버려도 되면 apply --force.

→ ⚠️ “pull 실패” 또는 세션 시작이 느림. 오프라인이거나 SSH 키 미등록입니다. 네트워크와 ssh -T git@github.com 을 확인합니다. 훅은 5초 안에 포기하고 계속 진행합니다.

→ Codex 가 반말·영어로 답함. ~/.codex/AGENTS.md 링크가 없거나 비어 있는 것입니다. sync.sh check 로 링크를 확인하고 Codex 를 재시작합니다.

→ Codex 에 Attention Span 스타일이 적용 안 됨. /hooks 신뢰를 안 했거나 ~/.codex/output-styles/attention-kind.md 가 없는 것입니다. Codex 에서 /hooks 신뢰, sync.sh apply 로 스타일 재설치.

→ ~/.codex/skills/.system 이 보임. Codex 기본 스킬 폴더로 Codex 가 관리합니다. 그대로 둡니다. 우리 스킬은 ~/.agents/skills 에만 있습니다.