터미널 CLI 20단계로 따라하기

Claude Code는 Node.js 위에서 돌아갑니다. 그래서 Node.js를 먼저 깔고, 그다음 Claude Code를 깝니다. 쓰는 운영체제를 아래에서 고르면 그 순서만 보입니다. 오른쪽 필버튼의 복사 버튼을 눌러 명령을 그대로 붙여넣으면 됩니다.

먼저 내 컴퓨터 OS를 고르세요 처음이면 10분 정도 걸립니다. 중간에 막히면 각 순서 아래의 "막히면 여기를 보세요"를 확인하세요.

Codex는 공식 설치 스크립트 한 줄로 끝납니다. Node.js를 먼저 깔지 않아도 됩니다. 쓰는 운영체제를 아래에서 고르면 그 순서만 보입니다. 오른쪽 필버튼의 복사 버튼을 눌러 명령을 그대로 붙여넣으면 됩니다.

먼저 내 컴퓨터 OS를 고르세요 처음이면 5분 정도 걸립니다. 중간에 막히면 각 순서 아래의 "막히면 여기를 보세요"를 확인하세요.

대화가 길어지면 처음에 무엇을 하려던 것인지가 흐려집니다. /goal은 이번 작업에서 끝내야 할 것을 한 줄로 못 박아 두고, 대화가 길어져도 그 목표를 계속 붙들게 합니다.

• ① /goal로 이번에 끝낼 것을 한 줄로 적기
  "로그인 화면을 만들고 테스트까지 통과시킨다"처럼 끝났는지 아닌지 판정할 수 있는 문장으로 적습니다. "코드 정리"처럼 끝이 없는 문장은 목표로 쓰기 어렵습니다.
• ② /status로 지금 어디까지 왔는지 보기
  지금 세션의 상태와 진행 정도를 보여 줍니다. 목표를 적어 두었다면 그 목표도 여기서 같이 확인됩니다.
• ③ 다 끝냈으면 /goal로 목표 지우기
  목표는 지우기 전까지 계속 붙어 있습니다. 다음 작업으로 넘어갈 때 지우지 않으면 끝난 목표를 계속 붙들게 됩니다.

Codex는 어디까지 물어보지 않고 해도 되는지를 /permissions에서 세 단계로 정합니다. 기본값은 가운데인 Auto라서, 아무것도 건드리지 않아도 대체로 무난합니다.

• ① /permissions로 지금 단계 확인
  고를 수 있는 세 단계가 목록으로 나옵니다. 지금 어떤 단계인지도 함께 표시됩니다.
• ② Read only로 읽기만 시켜 보기
  파일을 읽기만 하고 고치지도 만들지도 않습니다. 남의 코드를 처음 훑어볼 때, 또는 아직 무엇을 시킬지 정하지 못했을 때 안전하게 둘러보는 단계입니다.
• ③ Auto가 기본값임을 확인
  지금 작업 폴더 안에서는 파일을 고치고 명령을 돌리는 것까지 묻지 않고 진행합니다. 대신 작업 폴더 바깥을 건드리거나 네트워크가 필요한 명령에서는 그때마다 물어봅니다. 대부분의 작업은 이 단계로 충분합니다.
• ④ Full access는 무엇을 푸는지만 알아 두기
  울타리를 전부 걷어내는 단계입니다. 컴퓨터의 모든 파일과 네트워크에 접근할 수 있게 됩니다. 편하지만 되돌리기 어려운 일도 묻지 않고 하므로, 버려도 되는 폴더나 격리된 환경이 아니면 권하지 않습니다.
• ⑤ /plan으로 계획부터 받아 보기
  /plan복사 코드를 쓰기 전에 계획을 먼저 세우는 모드입니다. 명령 뒤에 부탁할 내용을 이어서 적으면 그 자리에서 계획을 만들어 줍니다. 구조를 바꾸는 작업은 여기서 한 번 걸러 보고 시작하는 편이 낫습니다.

거절한 명령을 한 번만 통과시키려면 /approve를 씁니다. 권한 단계 자체를 올리지 않고 방금 막힌 것 하나만 다시 시도합니다.

지금 모델들은 스스로 "이건 깊게 생각할 문제인지" 매번 판단합니다. 그 판단의 기준선을 사람이 정해 주는 것이 추론 강도입니다. 낮추면 빠르고 싸지고, 올리면 느리고 비싸지는 대신 답이 깊어집니다. Codex는 이것을 따로 명령으로 두지 않고 /model 화면 안에서 모델과 함께 고릅니다.

• ① /model을 열어 추론 강도 목록 확인
  모델 목록 옆에 추론 강도가 함께 나옵니다. Low, Medium, High, Extra High, Max, Ultra 여섯 단계이고 기본값은 Medium입니다.
• ② 단순한 일에 Low를 걸어 보기
  오타 수정, 파일 이름 정리, 짧은 요약처럼 판단할 것이 없는 일입니다. 답이 눈에 띄게 빨라지고 토큰도 덜 씁니다.
• ③ 어려운 문제에 High나 Extra High를 걸어 보기
  원인을 모르는 버그, 구조를 바꾸는 리팩토링처럼 한 번에 맞히기 어려운 일에 씁니다. 같은 질문을 Low와 Extra High로 각각 한 번씩 던져 보면 차이가 바로 체감됩니다. 이 비교를 해 보는 것이 이 단계의 핵심입니다.
• ④ Max와 Ultra가 무엇인지 알아 두기
  Max는 가장 어려운 문제에 쓰는 최대 깊이입니다. Ultra는 한 단계 더 나아가, 스스로 일을 쪼개 나눠 맡기면서 풉니다. 둘 다 느리고 비싸므로 늘 쓰기보다 정말 막혔을 때만 꺼내는 편이 낫습니다.
• ⑤ 급할 때 /fast로 바꿔 보기
  /fast복사 쓸 수 있는 상황이면 응답을 빠른 쪽으로 바꿔 줍니다. 생각의 깊이를 낮추는 것과는 다른 스위치이므로, 둘을 섞어 쓰기 전에 각각 따로 눌러 차이를 먼저 봐 두는 편이 낫습니다.

지금 모델들은 스스로 "이건 깊게 생각할 문제인지" 매번 판단합니다. 그 판단의 기준선을 사람이 정해 주는 것이 effort입니다. 낮추면 빠르고 싸지고, 올리면 느리고 비싸지는 대신 답이 깊어집니다.

• ① /effort로 지금 단계 확인
  low, medium, high, xhigh, max 다섯 단계가 있습니다. Fable 5.1, Opus 5, Sonnet 5는 high로 시작합니다. 아무것도 안 건드렸다면 이미 균형점에 있는 것이니, 굳이 바꾸지 않아도 됩니다. 지금 단계는 화면 위쪽 모델 이름 옆에 "with high effort"처럼 같이 표시됩니다. /model 목록에서 좌우 방향키로도 조절할 수 있습니다.
• ② 단순한 일에 low를 걸어 보기
  /effort low복사 오타 수정, 파일 이름 정리, 짧은 요약처럼 판단할 것이 없는 일입니다. 답이 눈에 띄게 빨라지고 토큰도 덜 씁니다.
• ③ 어려운 문제에 xhigh를 걸어 보기
  /effort xhigh복사 원인을 모르는 버그, 구조를 바꾸는 리팩토링처럼 한 번에 맞히기 어려운 일에 씁니다. 더 위인 max도 있지만 오히려 과하게 생각하다 겉돌 때가 있어서, 늘 쓰기보다 먼저 시험해 보고 정하는 편이 낫습니다. 같은 질문을 low와 xhigh로 각각 한 번씩 던져 보면 차이가 바로 체감됩니다. 이 비교를 해 보는 것이 이 단계의 핵심입니다.
• ④ 이번 한 번만 깊게: ultrathink
  프롬프트 아무 데나 ultrathink 라고 적으면 됩니다 설정을 바꾸지 않고 그 질문 하나만 깊게 생각시킵니다. 참고로 "잘 생각해봐", "think hard" 같은 말은 그냥 문장으로 읽힐 뿐 아무 기능도 하지 않습니다. 실제로 동작하는 단어는 ultrathink 하나입니다.
• ⑤ 생각 과정 펼쳐 보기
  Ctrl + O 평소에는 접혀 있는 추론 과정을 회색 글씨로 펼쳐 봅니다. 답이 왜 그렇게 나왔는지 확인할 때 씁니다. 접어 두어도 생각한 만큼 요금은 나가니, 안 볼 이유가 없습니다.
• ⑥ 생각 기능 자체를 끄고 켜기
  Option + T (Mac) · Alt + T (Windows) 깊이 조절이 아니라 생각을 아예 안 하게 만드는 스위치입니다. 웬만하면 켠 채로 두고 /effort로 조절하는 편이 낫습니다. Fable 5.1에서는 이 스위치가 동작하지 않습니다. Fable 5.1은 생각을 끌 수 없게 만들어진 모델이라, 항상 스스로 판단해서 생각합니다.

Codex 안에서 도는 모델은 세 가지입니다. 위로 갈수록 똑똑하고 느리고 비쌉니다. 일의 난도에 맞춰 골라 쓰는 것이 요령이고, 전부 외울 필요 없이 어려우면 위로, 단순하면 아래로만 기억하면 됩니다.

• ① /model로 지금 고를 수 있는 모델 확인
  이름 옆에 어떤 일에 맞는지 한 줄 설명이 같이 나옵니다. 앞 순서에서 본 추론 강도도 같은 화면에서 고릅니다. 아무것도 안 건드렸다면 지금은 gpt-5.6-sol로 돌고 있습니다. Codex CLI의 기본 모델입니다.
• ② 가장 어려운 일: GPT-5.6 Sol
  GPT-5.6 계열의 최상위 모델이자 Codex CLI의 기본값입니다. 복잡한 코딩, 컴퓨터 조작, 조사, 보안처럼 깊게 파고들어야 하는 문제에 가장 강합니다. 기본값이므로 따로 고르지 않아도 이걸로 시작합니다.
• ③ 매일 하는 일: GPT-5.6 Terra
  기능 추가, 화면 수정처럼 평소에 반복하는 작업입니다. 속도와 값의 균형이 가장 좋은 자리라, Sol이 과하다 싶은 작업은 여기로 내려도 결과가 크게 다르지 않습니다.
• ④ 단순한 일: GPT-5.6 Luna
  오타 수정, 요약, 파일 정리처럼 판단할 것이 없는 일입니다. 셋 중 가장 빠르고 가장 쌉니다. 같은 요청을 Luna와 Sol로 한 번씩 던져 보면 어디까지가 Luna의 몫인지 감이 잡힙니다.
• ⑤ 실행할 때부터 모델 지정하기
  codex -m gpt-5.6-terra복사 설정을 바꾸지 않고 이번 실행에만 다른 모델을 씁니다. -m은 --model의 줄임입니다. 가벼운 작업을 하러 들어갈 때 미리 낮춰 두면 편합니다.

같은 클로드라도 안에서 도는 모델은 네 가지입니다. 위로 갈수록 똑똑하고 느리고 비쌉니다. 일의 난도에 맞춰 골라 쓰는 것이 요령이고, 전부 외울 필요 없이 어려우면 위로, 단순하면 아래로만 기억하면 됩니다.

• ① /model로 지금 고를 수 있는 모델 확인
  이름 옆에 어떤 일에 맞는지 한 줄 설명이 같이 나옵니다. 좌우 방향키를 누르면 앞 순서에서 본 effort도 같은 화면에서 조절됩니다. 처음 시작하는 모델은 요금제마다 다릅니다. Max와 Team 프리미엄은 Opus 5, Pro와 Team 스탠다드는 Sonnet 5로 시작합니다.
• ② 가장 어려운 일: Fable 5.1
  /model fable복사 2026년 9월 1일에 나온 최상위 모델입니다. 한 번에 끝나지 않는 큰 작업, 원인을 모르는 버그 추적, 구조를 결정하는 일처럼 오래 파고들어야 하는 문제에 씁니다. 사실 정확도와 대학원 난도 추론에서 가장 높은 점수를 냅니다. 값이 Opus 5의 두 배이고 어느 요금제에서도 기본값이 아니라서, 쓰려면 이렇게 직접 골라야 합니다. 쓰는 방식이 조금 다릅니다. 절차를 하나하나 지시하기보다 원하는 결과만 주고 방법은 맡기는 쪽이 잘 맞습니다. "테스트도 꼭 해봐" 같은 확인 지시도 대개 필요 없습니다. 알아서 검증합니다.
• ③ 어려운 일: Opus 5
  /model opus복사 2026년 7월에 나온 모델입니다. 설계, 리팩토링, 판단이 필요한 문제를 맡깁니다. 어려운 작업 대부분은 여기서 충분합니다. Fable 5.1의 절반 값이고, 터미널에서 스스로 단계를 밟아 끝내는 에이전틱 작업 점수는 두 점 차이입니다.
• ④ 매일 하는 일: Sonnet 5
  /model sonnet복사 기능 추가, 화면 수정처럼 평소에 반복하는 작업입니다. 속도와 품질의 균형이 가장 좋은 자리라, 하루 작업의 대부분은 여기서 처리됩니다.
• ⑤ 단순한 일: Haiku 4.5
  /model haiku복사 오타 수정, 요약, 파일 정리처럼 판단할 것이 없는 일입니다. 눈에 띄게 빠릅니다. 같은 요청을 Haiku와 Opus로 한 번씩 던져 보면 어디까지가 Haiku의 몫인지 감이 잡힙니다.
• ⑥ 섞어 쓰기: opusplan
  /model opusplan복사 Plan 모드에서는 Opus로 계획을 세우고, 실제 코드를 쓸 때는 Sonnet으로 자동으로 내려갑니다. 계획은 똑똑하게, 실행은 싸게 가져가는 방식입니다. 8번 순서의 Plan 모드와 같이 쓰면 효과가 좋습니다.
• ⑦ 고른 모델이 다음에도 유지되는지 확인
  목록에서 엔터를 누르면 앞으로 여는 창에서도 그 모델로 시작합니다. s를 누르면 지금 이 창에서만 바뀝니다. 비싼 모델을 잠깐만 쓰고 싶다면 s를 눌러야 다음에 돌아오지 않습니다.

매번 똑같이 설명하는 일이 있다면 스킬로 묶어 둡니다. 폴더 하나에 SKILL.md를 넣어 두면 Codex가 그 설명을 읽고, 맞는 부탁이 들어올 때 스스로 꺼내 씁니다.

• ① 스킬 폴더 만들기
  폴더 이름이 곧 스킬 이름입니다. 홈의 .agents/skills에 두면 어느 프로젝트에서 열든 쓸 수 있습니다. .codex가 아니라 .agents라는 점에 주의하세요.
• ② 그 안에 SKILL.md 쓰기
  ~/.agents/skills/my-skill/SKILL.md 파일 맨 위에 name과 description 두 줄을 YAML 앞머리로 적고, 그 아래에 실제로 따라야 할 순서를 씁니다. 이 description을 보고 Codex가 꺼내 쓸지 정하므로 여기가 가장 중요합니다.
• ③ /skills로 목록에 잡혔는지 확인
  /skills복사 지금 쓸 수 있는 스킬이 목록으로 나옵니다. 방금 만든 것이 안 보이면 폴더 경로와 파일 이름(SKILL.md, 대문자)을 다시 확인합니다.
• ④ 직접 불러서 써 보기
  프롬프트에 $스킬이름 이름 앞에 $를 붙여 부르면 그 스킬로 실행합니다. 부르지 않아도 요청이 description과 맞으면 알아서 꺼내 씁니다.
• ⑤ 프로젝트 전용 스킬은 저장소 안에 두기
  .agents/skills/ Codex는 지금 폴더에서 저장소 루트까지 올라가며 만나는 .agents/skills를 모두 읽습니다. 저장소 안에 두면 같이 일하는 사람도 그대로 씁니다. 이름이 겹쳐도 합치지 않습니다. 같은 이름의 스킬이 여러 곳에 있으면 둘 다 목록에 나옵니다. 하나가 다른 하나를 덮어쓰지 않으니, 헷갈리지 않게 이름을 다르게 두는 편이 낫습니다.

예전 방식인 커스텀 프롬프트(~/.codex/prompts에 넣고 /prompts:이름으로 부르는 방식)는 공식 문서에서 더 이상 권장하지 않는다고 못 박았습니다. 새로 만든다면 스킬로 시작하세요.