Claude Code와 Codex 설정
Claude Code와 OpenAI Codex를 위한 저의 구성입니다: 스킬(skills), 훅 스크립트(hook scripts), Claude Code 모드(mods), 그리고 이들을 두 도구에 연결하는 설정 스크립트가 포함되어 있습니다. 이는 쉘 스크립트, 마크다운, 그리고 모드의 TypeScript로 이루어져 있으며 빌드 단계는 없습니다.
설정 (Setup)
git clone https://github.com/petekp/claude-code-setup.git
cd claude-code-setup
./setup.sh
setup.sh는 다음 링크들을 생성합니다:
| Link | Points to |
|---|
~/.claude/scripts | scripts/ |
| ... | |
Codex는 자체적으로 ~/.agents/skills에서 스킬을 읽으므로, 해당 스킬들은 Claude Code를 위해서만 연결됩니다. ./setup.sh --undo를 실행하면 링크가 제거됩니다.
./scripts/skill-doctor.sh로 이를 확인할 수 있습니다.
스킬 (Skills)
skills/ 폴더에는 이 저장소에 작성된 스킬들이 들어있습니다. npx skills add -g 등으로 설치된 외부 스킬들은 ~/.agents/skills에 위치합니다.
두 에이전트의 스킬 폴더는 실제 폴더로 유지되므로, 다른 도구들도 여기에 설치할 수 있습니다. link-skills.sh는 이 저장소나 ~/.agents/skills를 가리키는 링크만 건드립니다.
스킬을 추가하거나 제거한 후에는 ./scripts/link-skills.sh를 실행하거나, Claude Code 세션을 시작하여 SessionStart 훅이 이를 실행하도록 합니다. 프론트매터(frontmatter)는 ./scripts/validate.sh로 확인하세요.
모드 (Mods)
mods/ 폴더에는 Claude Code 모드가 들어있습니다: TypeScript 훅을 가진 플러그인들입니다. 각 모드의 README에 내용이 설명되어 있습니다.
인박스(inbox) 모드는 자체 저장소(petekp/inbox)를 가지고 있습니다. 이 모드는 세션에서 기다리는 것들, 즉 에이전트의 질문, Claude가 기록한 이슈, 그리고 사용자의 PR 검사 및 리뷰 등을 수집합니다.
아직 아무것도 연결되어 있지 않습니다. 하나를 시도하려면 claude --plugin-dir mods/<name>으로 Claude Code를 시작하세요. ./scripts/validate.sh는 모든 모드를 확인합니다. mods/DEVELOPING.md에서는 모드의 UI를 라이브로 테스트하는 방법을 설명합니다.
설정 (Settings)
~/.claude/settings.json은 Claude Code에 속합니다. Claude Code는 예를 들어 /model 사용이나 플러그인 설치 후에 이 파일을 자체적으로 다시 작성합니다. 따라서 이 저장소로 링크된 경우, 다음 쓰기 작업에서 일반 파일로 대체되므로 설정은 연결되지 않습니다.
./scripts/settings-snapshot.sh는 현재 파일을 ~/.agents/claude/settings.json 또는 사용자만의 비공개 저장소인 $CLAUDE_SETTINGS_SNAPSHOT으로 복사합니다. --diff 옵션은 변경된 내용을 보여줍니다. 새 컴퓨터의 경우, 설정 파일이 존재하지 않으면 setup.sh가 스냅샷을 제자리에 복사합니다.
이 스크립트들이 작성된 훅(hooks)과 상태 표시줄(status line)은 다음과 같습니다:
{
"hooks": {
"SessionStart": [
...
스크립트 (Scripts)
| 스크립트 | 기능 |
|---|
link-skills.sh | 스킬(skills)을 ~/.claude/skills와 ~/.codex/skills에 연결합니다. |
| ... | |
포킹 (Forking)
저장소를 포크하고, 자신의 포크를 클론한 다음, ./setup.sh를 실행하세요. 그런 다음:
skills/에서 원하지 않는 스킬을 제거하고 자신만의 스킬을 추가합니다. 스킬은 name과 description의 프런트매터(frontmatter)를 가진 SKILL.md 파일이 포함된 폴더입니다.- 이 저장소에서 에이전트가 어떻게 작동하는지 알려주는
AGENTS.md를 다시 작성하세요.
- 개인적인 지침을 이 저장소 외부의
~/.claude/CLAUDE.md와 ~/.codex/AGENTS.md에 넣으세요.
- 제 설정을 복사하는 대신 자신만의 설정을 만드세요. 위의 훅(hooks)부터 시작하세요.
라이선스 (License)
MIT