라이프스타일
입문자를 위한 문제 해결
먼저 실패한 계층을 구분합니다. 명령을 못 찾으면 설치나 PATH, 로그인 거부는 인증, 파일 누락은 위치나 권한, 결과 오류는 요청이나 코드를 확인합니다. 한 번에 조건 하나만 바꾸세요.
읽는 데 약 15분 · 실습 20 분

이 글의 목차
Codex 학습 목차로 돌아가기Codex 학습 센터: 전체 튜토리얼 목차설치와 첫 작업부터 MD 지침과 고급 연동까지 60개 강의, 열 개 단원을 계획합니다. 수준, 환경, 목표, 명령으로 다음 글을 찾고 미게시 항목의 상태를 확인할 수 있습니다.전체 글 읽기
목표와 사용법
도식의 01은 증상 기록, 02는 최소 확인 하나, 03은 원인 수정 후 원래 동작 반복입니다. 오류마다 바로 재시도하지 말고 입력·상태·사용 가능한 환경을 보존한 뒤 문제를 좁힙니다.
먼저: 증상과 마지막 성공 동작 기록
시간·플랫폼·버전·현재 폴더·정확한 명령/동작·예상·오류 원문을 기록합니다. 관련 정보만 공유하고 계정·비공개 경로·키를 가리세요. 설치 후 명령이 없으면 설치 결과, 다른 run이 활동하면 작업 이름·호스트를 보존합니다. 빨간 글씨만 잘라내지 말고 직전 명령·위치를 포함해야 다음 판단에 도움이 됩니다.
# Troubleshooting record
- Time and timezone:
- Surface: desktop / CLI / IDE / mobile / web
- OS and app or CLI version:
- Working folder or execution host (redacted if shared):
- Exact command or UI action:
- Expected result:
- Actual error and exit status:
- Last successful action:
- One change attempted:
- Result after that change:
- Files or settings to restore:
설치·로그인·플랫폼 진입점
| 증상 | 최소 확인 | 상세 |
|---|---|---|
| codex 없음 | 터미널 재열기·실행 파일 위치 | CLI 설치 |
| PowerShell 차단 | 차단 파일명·호출법 기록 | Windows CLI |
| macOS/Linux 설치 위치 다름 | shell·PATH·실행 파일 구분 | macOS, Linux/WSL |
| 로그인 후 권한 없음 | 같은 터미널의 codex login status | 계정·사용량 |
| 데스크톱·모바일 조작 없음 | 버전·계정·워크스페이스·진입점 기록 | 플랫폼 선택 |
codex 없음: CLI 설치Codex CLI 설치와 시작환경에 맞는 설치 경로를 선택하고 로그인, 읽기, 한 줄 수정, 독립 검증, 세션 재개를 진행합니다. 반복 가능한 두 파일 실습과 없는 파일 확인을 포함합니다.전체 글 읽기
PowerShell 차단: Windows CLIWindows CLI 설치와 문제 해결PowerShell에서 설치와 로그인, 명령 경로, 첫 읽기, 업데이트 문제를 확인합니다.전체 글 읽기
macOS/Linux 설치 위치 다름: macOSmacOS CLI 설치와 문제 해결macOS 터미널에서 설치하고 셸, 업데이트, 경로, 권한 문제를 구분해 해결합니다.전체 글 읽기 · Linux/WSLLinux/WSL CLI와 파일 위치호스트와 WSL의 도구, 경로, 계정을 구분하고 올바른 환경에서 실습과 업데이트를 진행합니다.전체 글 읽기
로그인 후 권한 없음: 계정·사용량계정, 로그인, 요금제와 사용량사용량을 해석하기 전에 로그인 방식을 확인하세요. ChatGPT 계정 로그인은 해당 계정의 Codex 사용 한도를 이용하며, 지원 클라이언트의 API 키 인증은 별도 API 결제를 확인해야 합니다. 바뀌기 쉬운 가격을 외우기보다 자신의 계정에서 확인하는 방법을 익힙니다.전체 글 읽기
데스크톱·모바일 조작 없음: 플랫폼 선택Codex 사용 환경 선택데스크톱, 모바일, CLI, IDE, 클라우드를 사례로 비교하고 파일과 도구의 실행 위치를 확인합니다.전체 글 읽기
같은 PC의 Windows·WSL·컨테이너·원격도 인증·설정을 공유하지 않을 수 있으므로 실패 환경을 식별합니다.
Windows는 Get-Command codex, macOS/Linux는 command -v codex로 실행 파일을 확인합니다. 여러 설치는 기록하고 바로 버전을 지우거나 전체 보안 정책을 바꾸지 않습니다. ChatGPT 인증·API 키·조직 제한을 구분하며 재설치는 한도를 늘리지 않습니다. 서비스 장애는 공식 상태 페이지의 시간·대상을 비교하고 전체 정상이어도 자신의 네트워크·권한 정상으로 단정하지 않습니다.
작업 폴더·MD·설정
| 증상 | 첫 확인 | 심화 편 |
|---|---|---|
| 수정이 화면에 없음 | 폴더·제공 URL·버전 | 경로, 브라우저 |
| AGENTS.md 적용 안 됨 | 이름·계층·작업 루트 | 규칙 범위 |
| README를 영구 규칙으로 취급 | 지시 진입점·작업 자료 구분 | 문서 역할 |
| TOML 해석 실패 | 최근 수정·따옴표·table 중복·실제 위치 | 설정 문제 |
| 재개 후 오래된 결론 | 기록뿐 아니라 현재 파일·버전 | 세션, 인계 |
수정이 화면에 없음: 경로터미널 경로와 프로젝트 루트Windows, macOS, Linux에서 실습 폴더를 만들고 현재 위치, 상대 경로, 절대 경로를 구분합니다.전체 글 읽기 · 브라우저브라우저, 스크린샷과 이미지 활용시각 작업에는 참고, 현재 화면과 변경 조건이 필요합니다. 스크린샷과 생성 그림은 증거의 의미가 다르며 생성 화면으로 동작 성공을 증명할 수 없습니다.전체 글 읽기
AGENTS.md 적용 안 됨: 규칙 범위AGENTS.md 범위와 우선 규칙루트와 하위 폴더의 지침, 충돌, override를 추적해 선택된 문서를 확인합니다.전체 글 읽기
README를 영구 규칙으로 취급: 문서 역할규칙, 설명, 문맥 파일 구분작업 규칙, 프로젝트 진입점, 설계 조건, 인계 상태를 나누고 오래된 가설을 실제 파일과 테스트로 확인합니다.전체 글 읽기
TOML 해석 실패: 설정 문제설정 우선순위와 진단적용되지 않거나 충돌하는 설정의 출처를 찾고 한 항목씩 변경해 복원 가능한 기록을 남깁니다.전체 글 읽기
재개 후 오래된 결론: 세션세션 재개와 분기신규, 재개, 분기 작업을 구분하고 기록에서 올바른 작업과 경로, 남은 일을 확인합니다.전체 글 읽기 · 인계맥락과 작업 인계긴 작업에는 결정과 증거를 남깁니다. README는 사용법, 설계 문서는 이유, 인계는 진행 상황, AGENTS.md는 지속할 규칙으로 구분합니다.전체 글 읽기
한 조건씩 바꾸고 복구 후 필요한 변경은 유지하며 자신의 진단 표시만 제거하세요. 전체 설정을 인터넷 서식으로 덮어쓰지 않습니다.
재현 실습: 올바른 폴더 찾기
새 path-trouble에 빈 project·other를 만들고 project에만 아래 marker.md를 둡니다. other에서 터미널을 열어 일부러 marker.md를 읽어 파일 누락을 재현하세요. Codex·운영 변경은 필요 없습니다. 현재 위치·목록을 확인하고 명시한 상대 경로로 읽은 뒤 project로 cd해 원래 읽기를 반복합니다.
# Correct folder: PATH-PRACTICE-1
Get-Content -LiteralPath .\marker.md
Get-Location
Get-ChildItem
Get-Content -LiteralPath ..\project\marker.md
Set-Location -LiteralPath ..\project
Get-Content -LiteralPath .\marker.md
cat ./marker.md
pwd
ls
cat ../project/marker.md
cd ../project
cat ./marker.md
처음은 실패하고 뒤 두 번은 같은 PATH-PRACTICE-1이며 내용을 고친 것이 아니라 위치를 고쳤음을 확인합니다. 원래 위치로 돌아가고 자료는 보관하며 재귀 삭제는 필요 없습니다. Codex에서도 작업 루트·지정 파일 존재부터 확인해 잘못 연 프로젝트인지 판단하세요. 같은 이름 작업·다른 worktree·휴대전화의 오래된 내용이 같은 폴더의 증거는 아닙니다.
PowerShell cmdlet인 Get-Content는 $?를 즉시 저장합니다. $LASTEXITCODE는 주로 codex·node 같은 네이티브 프로그램용입니다. 경로 실습을 마치면 project에 있어야 하며 아래는 없는 other/marker.md, 실제 marker 순서로 읽습니다. PowerShell은 False·True, shell은 0이 아닌 값·0이 나와야 합니다. 다른 명령이 상태를 덮기 전에 저장하세요.
Get-Content -LiteralPath ..\other\marker.md
$practiceReadOk = $?
$practiceReadOk
Get-Content -LiteralPath .\marker.md
$practiceReadOk = $?
$practiceReadOk
cat ../other/marker.md
practice_read_exit=$?
printf '%s\n' "$practice_read_exit"
cat ./marker.md
practice_read_exit=$?
printf '%s\n' "$practice_read_exit"
정확한 정의는 PowerShell 자동 변수를 참고하세요. 두 읽기는 marker를 바꾸지 않습니다. 예상 밖 편집은 별도로 조사해 경로 수정과 파일 원문 보존을 나누어 인계합니다.
도구·원격·자동화
| 증상 | 확인 계층 | 심화 편 |
|---|---|---|
| Skill은 보이나 오동작 | 선택·지시·자료 | 기술 검증 |
| 설치 Plugin 읽기 실패 | 진입점·활성·계정·원본 권한 | 플러그인 문제 |
| MCP 설정 있지만 도구 없음 | 프로세스/URL·연결·목록·인증 | MCP 문제 |
| 휴대전화 오래된 자료 | 호스트·작업·표식·Handoff | 원격 설정, 장치 이동 |
| 에이전트 완료 주장·충돌 | 책임·재현 증거 | 품질, 통합 |
| 예약 시간 초과·중복 | 저장 설정·활동 run | 자동화 복구 |
| JSON 답변·프로세스 실패 | 종료·이벤트·최종 자료 | JSON/JSONL |
Skill은 보이나 오동작: 기술 검증Skill 선택과 결과 검증형식, 선택, 결과를 나누어 시험하고 맞는 요청과 맞지 않는 요청으로 설명을 개선합니다.전체 글 읽기
설치 Plugin 읽기 실패: 플러그인 문제Plugin 연결과 도구 문제 해결설치, 계정 연결, 승인, 도구 사용 가능 상태를 구분해 원인에 맞게 재연결하거나 제거합니다.전체 글 읽기
MCP 설정 있지만 도구 없음: MCP 문제MCP 연결 진단과 복구프로세스, 전송, 인증, 도구 목록을 차례로 확인하고 오류를 보존해 최소 동작을 검증합니다.전체 글 읽기
휴대전화 오래된 자료: 원격 설정Remote 설정, 진단, 연결 해제기기를 연결하고 호스트 상태와 새 파일 읽기를 검증합니다. 중지할 때 원격 접근, 기기 페어링, 작업 실행 상태를 구분합니다.전체 글 읽기 · 장치 이동기기 간 인계와 파일 환경 확인대화, 호스트, 작업 경로, 브랜치를 추적해 의도한 작업을 이어 갑니다.전체 글 읽기
에이전트 완료 주장·충돌: 품질하위 에이전트 범위와 품질 확인독립 입력, 수정 범위, 증거를 정하고 하위 에이전트 결과와 누락을 확인합니다.전체 글 읽기 · 통합병렬 작업 통합과 검증파일과 인터페이스 계약에 따라 변경을 통합하고 충돌과 전체 동작을 검증합니다.전체 글 읽기
예약 시간 초과·중복: 자동화 복구자동화 실패, 재시도, 중지실행 기록으로 기존 결과를 확인하고 중복을 피하며 조건을 고쳐 일정 중지를 검증합니다.전체 글 읽기
JSON 답변·프로세스 실패: JSON/JSONLJSON 출력과 결과 검증이벤트 스트림과 최종 결과를 구분하고 구조화 출력을 해석해 누락과 잘못된 형식을 거부합니다.전체 글 읽기
증상 관련 계층만 처리하며 플러그인 설치와 원본 계정 읽기 권한은 구분합니다.
문제 해결을 마치고 작업 복귀
수정 후 원래 실패 동작과 인접 동작을 검증합니다. Completed 수정 후 Active, 설정 수정 후 이전 정상 항목, MCP 재연결 후 초록 아이콘뿐 아니라 가상 문서 실제 읽기입니다. 증상·원인·단일 수정·검증을 issue-notes.md에 적고 인계에는 최소 입력·시도 절차를 제공합니다. 미해결이면 그대로 기록하고 사용 가능한 상태·다음 증거를 보존하세요.
자신의 임시 표식·설정을 되돌리고 필요한 수정·백업·기록은 유지합니다. 문제 해결을 이유로 전체 설정 삭제·세션 제거·민감 내용 공개를 하지 않습니다. 색인을 처음부터 모두 수행하지 말고 증상에 맞는 한 행을 고르세요. 각 편 위아래에서 학습 목차Codex 학습 센터: 전체 튜토리얼 목차설치와 첫 작업부터 MD 지침과 고급 연동까지 60개 강의, 열 개 단원을 계획합니다. 수준, 환경, 목표, 명령으로 다음 글을 찾고 미게시 항목의 상태를 확인할 수 있습니다.전체 글 읽기로 돌아가 기능·명령·MD 이름으로 다음을 찾습니다. 플랫폼 미지원·미개방은 설치 장애와 구분합니다.
Codex 학습 목차로 돌아가기Codex 학습 센터: 전체 튜토리얼 목차설치와 첫 작업부터 MD 지침과 고급 연동까지 60개 강의, 열 개 단원을 계획합니다. 수준, 환경, 목표, 명령으로 다음 글을 찾고 미게시 항목의 상태를 확인할 수 있습니다.전체 글 읽기
자세한 설명 보기
Symptom to One check to Retry
이 정리가 도움이 되셨나요? 필요한 분께 공유해 보세요
같은 주제의 글
라이프스타일
Codex 학습 센터: 전체 튜토리얼 목차
설치와 첫 작업부터 MD 지침과 고급 연동까지 60개 강의, 열 개 단원을 계획합니다. 수준, 환경, 목표, 명령으로 다음 글을 찾고 미게시 항목의 상태를 확인할 수 있습니다.
라이프스타일
Worktree와 작업 격리
Worktree는 하나의 Git 저장소에 다른 브랜치의 작업 폴더를 만듭니다. 파일이 분리되어도 DB, 포트와 외부 서비스는 공유될 수 있습니다.
라이프스타일
실습: 작은 웹사이트 만들기
brief.md에서 Small Steps 할 일 사이트를 계획하고 추가·완료·삭제·필터·로컬 저장을 구현합니다. HTML·CSS·데이터 함수·화면 이벤트·시험을 분리하고 Node와 브라우저로 검증한 뒤 재시작·복원 인계 기록을 남깁니다.
이 글을 인용한 글
출처
위에 기재된 참고 자료와 확인일 기준 정보를 바탕으로 정리했습니다. 요금, 시간표, 기능, 이용 약관은 바뀔 수 있으므로 여행, 예약 또는 구매 전에 해당 공식 사이트에서 최신 정보를 확인해 주세요.