안녕하세요, 저는 Cang He입니다.
오늘, CodexGuide를 공식 출시합니다.
이것은 "Codex 실전 가이드"이며, GitHub에 오픈소스로 공개되었습니다.
완전히 무료이며 오픈소스입니다.
더 나은 읽기 경험을 위해 온라인 웹사이트도 만들었습니다.
오늘 공식 발표합니다.
예전의 저처럼, 많은 분들이 Codex App, Codex CLI, Codex 플러그인에 대해 약간 혼란스러워하실 거라고 생각합니다.
한순간에는 Claude Code를 쓰라 하고, 다음 순간에는 Codex를 쓰라 하니, 정말 머리가 아플 수 있죠.
그래서 학습 경로를 기준으로 CodexGuide는 "진입점 이해하기, 작업 실행하기, 방법 정립하기, 팀 노하우 축적하기"라는 네 가지 레이어로 구성되어 있습니다. CLI로 시작할 수도 있고, 데스크톱 클라이언트, ChatGPT, 또는 클라우드 작업으로 시작할 수도 있습니다. 핵심은 각 진입점에 적합한 작업 리듬을 먼저 이해하는 것입니다.
현재 가장 많이 사용되는 것은 Codex Desktop App으로, 특히 컴퓨터 사용 및 브라우저 기능에서 뛰어난 엔지니어링 능력을 보여줍니다.
Codex Desktop App 다운로드 및 설치부터 Plus 구독까지, CodexGuide는 매우 상세한 튜토리얼을 제공합니다.
솔직히 말하면, Plus 구독 튜토리얼만으로도 서드파티 충전에 드는 많은 비용을 절약할 수 있습니다. ㅎㅎ
자신의 계정을 직접 충전하는 것이 더 안정적이죠. 어쨌든 내 것이니까요.
또한, 모바일 Codex를 사용하여 원격으로 작업을 실행하는 방법에 대한 개인 경험을 바탕으로 한 튜토리얼도 포함했습니다.
여기서 말하는 "모바일 Codex"는 더 정확히는 ChatGPT 모바일 앱 내의 Codex 진입점입니다. 독립적인 모바일 Codex 앱이 아니며, 휴대폰을 원격 데스크톱 마우스와 키보드로 바꾸는 것도 아닙니다. 이렇게 생각하면 됩니다: 데스크톱 앱, 원격 개발 머신, 또는 다른 권한이 부여된 환경에서 Codex가 실행 중이고, 모바일 측은 이러한 환경에 연결하여 컴퓨터에서 떨어져 있을 때도 작업을 계속 보고, 응답하고, 승인하고, 조정할 수 있게 해줍니다.
이제 잠자는 시간을 제외하고는 언제든지 "vibe coding"을 할 수 있습니다. Mac Mini에서 실행 중인 Codex를 휴대폰으로 어디서든 편리하게 지시할 수 있죠.
앞으로 여기에 제 Codex 적용 사례를 더 추가할 예정입니다.
진입점 맵에서는 CLI부터 데스크톱 APP, IDE까지 다양한 사이드 진입점을 소개하여 Codex를 한 번에 완전히 이해할 수 있도록 안내합니다.
Codex 설정이 어렵게 느껴진다면 걱정하지 마세요. 여기서 모든 답을 찾을 수 있습니다.
또한, 공식 자료를 바로 찾아볼 수 있도록 리소스 진입점을 특별히 추가했습니다. Codex가 정기적으로 이를 확인하여 문서가 공식 버전과 동기화되도록 하거나, 최소한 크게 지연되지 않도록 할 것입니다.
현재 Codex의 업데이트 속도는 매우매우 빠르니까요.
간단한 튜토리얼은 시작하기 위한 것일 뿐이므로, "실전 사례"라는 컬럼도 추가했습니다.
여기에는 누구나 쉽게 따라 할 수 있는 흥미로운 Codex 사례들이 많이 모일 것입니다.
예를 들어, Codex × Draw.io MCP를 사용하여 AI가 자동으로 아키텍처 다이어그램을 그리게 하는 방법이 있습니다.
이렇게 유용한 사례를 누가 거절할 수 있겠어요?
하지만 지금까지는 13개의 대표 사례만 모았습니다. 앞으로 더 많은 실전 사례를 계속 보완하고 수집할 예정입니다.
Codex × GitHub Actions: CI 자동 장애 복구 실전 테스트 같은 사례는 개발자들에게 특히 추천합니다. Codex를 한 단계 더 발전시킬 수 있는 부분이니까요.
지식 관리를 좋아한다면 Codex + Obsidian 사례를 놓치면 안 됩니다. 이 사례는 Codex × LLM Wiki를 사용하여 Obsidian에서 AI 지식 베이스를 구축하는 방법을 알려줍니다.
솔직히 말하면, 이 프로젝트는 5월 1일에 시작해서 틈틈이 개선해 왔습니다.
이유는 간단했습니다. 처음에는 Codex에 로그인하거나 충전하는 방법조차 몰랐습니다. AI에게 물어보고 튜토리얼도 찾아봤지만, 전부 말도 안 되는 내용이었죠.
결국 시행착오를 거쳐 방법을 찾아냈습니다.
그 순간 깨달았습니다: Codex에서 어려운 것은 사용법이 아니라 "작동하게 만드는 것"이라는 것을.
많은 사람들이 사용을 피하려는 것이 아니라, 계정, 환경, 네트워크에서 막혀서 의욕을 잃는 것입니다.
공식 문서는 있지만, 아시죠? 그건 이미 사용법을 아는 사람들을 위해 쓰인 겁니다.
그래서 스스로 만들어보자고 생각했습니다. 등록부터 실전 적용까지, 모든 함정을 직접 겪고 나서 따라오는 사람들을 위해 매끄럽게 다듬는 거죠.
개인적인 욕심도 있습니다: 최근 Codex에 푹 빠져서 매일 상호작용하며 코드를 짜는 것보다 더 많은 함정을 경험하고 있습니다.
이 경험들을 채팅 기록 속에서 썩히는 것보다는, 나 자신을 위한 기록으로 정리하는 것이 낫겠다고 생각했습니다.
이 튜토리얼이 단 하나의 삽질이라도 줄여준다면, 지난 2주간의 다크서클이 헛되지 않을 것입니다.
마지막으로, 이 오픈소스 튜토리얼을 만드는 데 참여해 주신 모든 친구분들께 감사드리며, 커뮤니티의 기여로 함께 다듬어 나가길 환영합니다.
아직 완벽하지는 않지만, 완벽함보다는 완성이 중요합니다.
제 글을 좋아해 주셔서 감사합니다. 다음 호에서 뵙겠습니다.
