# AI 코딩 문서

> 출처: https://retn.kr/docs/ai-coding/ · 리텐션 주식회사

비개발자와 실무자가 Claude Code·Codex로 일을 끝까지 만들 때 막히는 지점을 다룹니다. 설치와 환경 설정, 사용량 제한과 대화 길이, 자주 나는 오류, 프롬프트와 CLAUDE.md 구조를 직접 해 본 결과로 정리합니다. 각 문서에는 확인한 날짜와 버전을 적습니다.

## 문서 2편

- [Codex CLI 설치 방법: macOS·Windows·Linux, npm·Homebrew와 로그인 오류 해결](https://retn.kr/docs/ai-coding/codex-install.md): OpenAI Codex CLI를 macOS·Linux·Windows에 설치하는 명령어, npm install -g @openai/codex와 Homebrew 설치, ChatGPT 로그인, codex 명령어를 찾을 수 없을 때 해결 방법을 정리했습니다.
- [Claude Code CLI 설치 방법: Windows·macOS·Linux·WSL과 PATH 오류 해결](https://retn.kr/docs/ai-coding/claude-code-install.md): Claude Code CLI를 Windows(PowerShell·CMD), macOS, Linux, WSL에 설치하는 명령어, claude 명령어를 찾을 수 없을 때 PATH 설정, 자주 나는 설치 오류를 정리했습니다.

## 관련 글 41편

- [클로드 코드 에이전트 12개를 폴드·아이패드·맥북에서 그대로 이어 쓰기: 맥미니 + Tailscale + Herdr(허더) 세팅 팁](https://retn.kr/blog/herdr-claude-code-fold-ipad-macmini-tailscale.md)
- [손에 안 익는 접이식 키보드, 코덱스로 불편한 키를 연습하는 앱 만들기](https://retn.kr/blog/foldable-keyboard-codex-android-app.md)
- [같은 해결책이 안 통할 때, 코덱스에게 도구를 연결해보세요](https://retn.kr/blog/codex-tools-hypothesis-debugging.md)
- [AI 결과물 읽는 시간을 줄이는 출력 형식 4단계: 카파시 팁을 직접 실험한 결과](https://retn.kr/blog/ai-output-format-ladder.md)
- [클로드 Opus 5, 이제 이렇게 말 걸어야 합니다](https://retn.kr/blog/keulrodeu-opus-5-ije-ireohge-mal-geoleoya-habnida.md)
- [비개발자가 Git 커밋을 배운 날: 고친 일은 기록해야 남습니다](https://retn.kr/blog/non-developer-git-commit-pr-merge.md)
- [통합 안 된 매체 비용도 에어브릿지 대시보드에 — Self-Serve Cost Upload + 클로드 코드 자동화 실전 (3/3)](https://retn.kr/blog/airbridge-self-serve-cost-upload-claude-code-automation.md)
- [클로드 코드로 OG 이미지 만들고, 에어브릿지 API로 트래킹 링크 N개 발급한다 — 블로그 1편 자동 마케팅화 (2/3)](https://retn.kr/blog/claude-code-og-image-airbridge-tracking-link-blog-automation.md)
- [클로드 코드 + 에어브릿지 MCP × API로 마케터 일상을 다시 설계한다 — Agentic 자동화 청사진 (1/3)](https://retn.kr/blog/claude-code-airbridge-mcp-api-agentic-marketer-blueprint.md)
- [클로드 코드 복붙이 매일 깨져서, 하루 만에 우회 앱을 만들어 공개했다](https://retn.kr/blog/openpaste-claude-code-paste-fix.md)
- [GPT-5.4/Codex 프롬프트 구조: 클로드코드 버릇 버리고 한 방에 일시키는 법](https://retn.kr/blog/codex-prompting-guide-vs-claude-code.md)
- [다 날아가도 다시 세우는 사람: 비개발자 1인이 운영하며 배우는 속도](https://retn.kr/blog/solo-operator-learning-through-failures.md)
- [완벽한 도구를 기다리지 마세요 — AI 시대, 나만의 OS를 만드는 법](https://retn.kr/blog/dont-wait-build-your-own-tools.md)
- [에이전틱 커머스 체험기: AI 결제를 x402로 해봤습니다](https://retn.kr/blog/agentic-commerce-x402-base-usdc.md)
- [비개발자가 클로드코드로 맥 앱을 만들어 버렸다](https://retn.kr/blog/claude-code-wifi-qr-mac-app.md)
- [AI 코딩 에이전트를 10명으로 늘리는 법: CLAUDE.md부터 MCP까지 세팅 가이드](https://retn.kr/blog/ai-agent-compound-setup-part3.md)
- [클로드코드 부트캠프 후기: 10년 차 PM이 화이트칼라 위기에서 찾은 답](https://retn.kr/blog/claude-code-bootcamp-pm-whitecollar-review.md)
- [삼일절에 리더 30명과 AI 코딩을 했습니다](https://retn.kr/blog/leaders-ai-coding-bootcamp-260301.md)
- [비개발자를 위한 프롬프트 작성법: 오픈소스 기여를 '요청'에서 '운영 성과'로 바꾸는 방법](https://retn.kr/blog/non-developer-open-source-contribution-prompt-playbook.md)
- [AI 마케팅 자동화 실전 사례: 마케터 3명이 반복노동을 없앤 방법](https://retn.kr/blog/ai-marketing-automation-3-cases.md)
- [AI에게 일 시키는 7가지 법칙: AI활용법, 프롬프트보다 중요한 것들](https://retn.kr/blog/ai-delegation-7-laws.md)
- [클로드코드 부트캠프 후기: 비개발자 PM이 7시간 만에 달라진 점](https://retn.kr/blog/claude-code-bootcamp-non-developer-review.md)
- [pencil.dev 클로드코드 연동 API Key 에러, 이렇게 해결했습니다](https://retn.kr/blog/pencil-invalid-api-key.md)
- [스마트폰으로 클로드 코드 쓰기: Tailscale + Termux 가이드](https://retn.kr/blog/claude-code-mobile-tailscale-termux.md)
- [0에서 1이 되는 순간: AI 코딩 에이전트와 비개발자의 가능성](https://retn.kr/blog/ai-coding-agent-nondev.md)
- [비개발자가 클로드코드로 코딩하는 법 (35분 입문 가이드)](https://retn.kr/blog/claude-code-intro-for-non-developers.md)
- [작은 LLM 모델로 85% 정확도를 달성한 Discovery Chat(Text-to-SQL) 구축기](https://retn.kr/blog/sllm-text-to-sql.md)
- [비개발자의 Claude Code(클로드코드) 삽질기: 그로스 전문가가 2주 만에 엔지니어링을 구현하기까지](https://retn.kr/blog/claude-code-non-developer-growth-engineer-guide-2.md)
- [AI 코딩 도구로 그로스 팀 역량 10배 높이기: 비개발자의 클로드코드 실전 활용법](https://retn.kr/blog/ai-coding-agent-for-growth-and-non-technical-team-with-claude-code.md)
- [AI 코딩 시대, 개발자와 비개발자의 경계는 어디로 가고 있을까?](https://retn.kr/blog/ai-coding-battle-ground.md)
- [AI 코딩 도구 자가진단: 4가지 프롬프트로 나만의 사용 패턴 분석하기](https://retn.kr/blog/ai-coding-prompt-self-diagnosis.md)
- [Claude Code(클로드코드)로 AI코딩 입문: 비개발자의 6번 삽질기](https://retn.kr/blog/claude-code-ai-coding-beginner.md)
- [클로드(Claude) 대화 길이 제한 해결하는 7가지 방법 [2026 가이드]](https://retn.kr/blog/claude-maximum-conversation-length.md)
- [비개발자가 AI로 랜딩페이지 만들기: Google AI Studio + Vercel 배포 실전 가이드](https://retn.kr/blog/ai-landing-page-guide.md)
- [30분 만에 끝내는 Conversational AI 웹사이트 개조 — Problem Owner가 직접 Solver 되는 시대](https://retn.kr/blog/rag-in-30mins.md)
- [개발자 없이 AI 코딩으로 리드 수집 자동화 구축하기](https://retn.kr/blog/lead-gen-machine.md)
- [블로그 글 하나 쓰는 데 2시간? 클로드 프로젝트로 30분에 끝내는 법](https://retn.kr/blog/claude-skill-project-mcp.md)
- [클로드스킬(Claude Skills)로 3,400개 리뷰 분석하고 메타 광고 소재 찾는 방법](https://retn.kr/blog/claude-skills-review-analysis-lmf.md)
- [[GCP] 서비스 계정 키 생성 차단(Key Creation Disabled) 완벽 해결 가이드: 용어 정리부터 엣지 케이스까지](https://retn.kr/blog/gcp-service-account-key-creation.md)
- [[GCP] GCS 버킷 퍼블릭 공개 시 "Domain Restricted Sharing" 에러 해결법 (2025-11-18)](https://retn.kr/blog/google-cloud-console-public-url-sharing.md)
- [클로드 사용량 초기화: 한도 리셋 시간, 무료로 리셋 버튼, 사용 크레딧(옛 Extra Usage)으로 바로 이어 쓰는 법](https://retn.kr/blog/claude-code-limit-extra-usage.md)

## 용어

- AGENTS.md: 여러 AI 코딩 에이전트가 공통으로 읽는 저장소의 지침 파일로, 에이전트용 README 역할을 한다. (https://retn.kr/glossary/agents-md.md)
- Claude Code: Anthropic이 만든 에이전트 코딩 도구로, 코드를 읽고 파일을 고치고 명령을 직접 실행한다. (https://retn.kr/glossary/claude-code.md)
- Claude Skills: SKILL.md 파일에 업무 절차를 적어 두면 Claude가 필요할 때 불러 쓰는 재사용 작업 지침 묶음. (https://retn.kr/glossary/claude-skills.md)
- CLAUDE.md: Claude Code가 세션을 시작할 때마다 읽는 마크다운 지침 파일로, 프로젝트 규칙과 맥락을 담는다. (https://retn.kr/glossary/claude-md.md)
- Codex: OpenAI의 코딩 에이전트로, 터미널·IDE·클라우드에서 코드를 읽고 고치고 명령을 실행한다. (https://retn.kr/glossary/codex.md)
- Command-line interface: 마우스 클릭 대신 텍스트 명령어를 한 줄씩 입력해 소프트웨어를 조작하는 방식. (https://retn.kr/glossary/cli.md)
- Compaction: 대화가 컨텍스트 윈도우 한도에 가까워지면 이전 기록을 요약해 공간을 확보하는 기능. (https://retn.kr/glossary/compaction.md)
- Context window: 언어 모델이 응답을 만들 때 한 번에 참고할 수 있는 텍스트 전체의 양으로, 모델의 작업 메모리에 해당한다. (https://retn.kr/glossary/context-window.md)
- Cursor: Anysphere가 만든 AI 코딩 도구로, 코드 편집 환경 안에서 AI 에이전트가 코드를 읽고 고친다. (https://retn.kr/glossary/cursor.md)
- Git: 파일의 변경 이력을 스냅샷으로 기록하고, 이전 상태로 되돌리거나 여러 사람의 작업을 합치게 해 주는 버전 관리 시스템. (https://retn.kr/glossary/git.md)
- Hooks: Claude Code 작업 흐름의 정해진 시점에 자동으로 실행되는 사용자 정의 명령으로, 도구 실행을 막을 수도 있다. (https://retn.kr/glossary/hooks.md)
- Model Context Protocol: AI 앱이 외부 도구와 데이터에 같은 방식으로 연결되도록 정한 오픈소스 표준 규격. (https://retn.kr/glossary/mcp.md)
- Permission mode: Claude Code가 파일 편집이나 명령 실행 전에 사용자에게 물을지, 묻지 않고 실행할지를 정하는 설정. (https://retn.kr/glossary/permission-mode.md)
- Subagent: 메인 대화와 분리된 자체 컨텍스트에서 하위 작업을 처리하고 요약만 돌려주는 보조 AI 에이전트. (https://retn.kr/glossary/subagent.md)
- Token: 언어 모델이 텍스트를 처리하는 최소 단위로, 사용량·비용·컨텍스트 크기를 재는 기준이 된다. (https://retn.kr/glossary/token.md)
- Usage credits: 유료 Claude 플랜의 사용 한도를 다 쓴 뒤에도 표준 API 요금으로 충전한 잔액에서 차감해 계속 쓰게 하는 기능(이전 이름 Extra Usage). (https://retn.kr/glossary/usage-credits.md)
- Usage limit: Claude 같은 AI 구독 요금제가 정해진 시간 창마다 허용하는 사용량의 상한. (https://retn.kr/glossary/usage-limit.md)
- Vibe coding: 코드를 직접 읽거나 쓰지 않고, 원하는 결과를 말로 설명해 AI가 만든 코드를 그대로 받아 쓰는 개발 방식. (https://retn.kr/glossary/vibe-coding.md)
