터미널 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 다섯 단계가 있습니다. Opus 5, Fable 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에서는 이 스위치가 동작하지 않습니다. Fable 5는 생각을 끌 수 없게 만들어진 모델이라, 항상 스스로 판단해서 생각합니다.

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
  /model fable복사 2026년 6월에 나온 최상위 모델입니다. 한 번에 끝나지 않는 큰 작업, 원인을 모르는 버그 추적, 구조를 결정하는 일처럼 오래 파고들어야 하는 문제에 씁니다. 사실 정확도와 대학원 난도 추론에서 가장 높은 점수를 냅니다. 값이 Opus 5의 두 배이고 어느 요금제에서도 기본값이 아니라서, 쓰려면 이렇게 직접 골라야 합니다. 쓰는 방식이 조금 다릅니다. 절차를 하나하나 지시하기보다 원하는 결과만 주고 방법은 맡기는 쪽이 잘 맞습니다. "테스트도 꼭 해봐" 같은 확인 지시도 대개 필요 없습니다. 알아서 검증합니다.
• ③ 어려운 일: Opus 5
  /model opus복사 2026년 7월에 나온 최신 모델입니다. 설계, 리팩토링, 판단이 필요한 문제를 맡깁니다. 어려운 작업 대부분은 여기서 충분합니다. Fable 5보다 싸고 빠르며, 터미널에서 스스로 단계를 밟아 끝내는 에이전틱 작업은 오히려 앞섭니다.
• ④ 매일 하는 일: 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:이름으로 부르는 방식)는 공식 문서에서 더 이상 권장하지 않는다고 못 박았습니다. 새로 만든다면 스킬로 시작하세요.