스킬캠퍼스
3강 · Claude Code·Codex 시작
강의

오늘 끝나면

Claude Code·Codex 시작

  • Claude Code·Codex 시작의 핵심 문제를 한 문장으로 설명한다
  • 오른쪽 실습에서 Claude이 어떻게 움직이는지 관찰한다
  • 다음 강의와 이어지는 한계를 말할 수 있다

실습 미션

설치·첫 세션 — 터미널에서 일 시키기 이 문장이 실제로 무슨 뜻인지 실습에서 한 번 손으로 확인한다.

성공 조건

  • 실습의 기본값을 먼저 관찰
  • 입력값이나 모드를 한 번 이상 바꿔 결과 비교
  • 왜 결과가 바뀌었는지 한 문장으로 설명

바이브코딩 · 03

Claude Code·Codex
시작

웹 챗봇이 아님. 내 터미널에서 도는 코딩 에이전트임.
설치하고 프로젝트에서 켜면 끝.
자연어로 시키면 파일을 직접 고치고 테스트까지 돌림.

P.01바이브코딩 · 03

터미널에서 도는 코딩 에이전트

Claude Code·Codex는 웹 탭에 떠 있는 챗봇이 아님.
내 컴퓨터 터미널에서 도는 프로그램임.

그래서 내 프로젝트 폴더에 직접 붙음.
파일을 읽고 · 고치고 · 명령을 실제로 실행함.
복붙으로 코드를 옮길 필요가 없음.

2강에서 본 LLM + 도구 루프가 그대로 들어있음.
모델이 머리고 / 파일 읽기·쓰기·셸 실행이 손임.
이 손이 닿는 범위가 곧 내 로컬 프로젝트임.

챗봇 ↔ 코딩 에이전트
같은 모델 · 다른 손
웹 챗봇

텍스트로 답함

코드는 복붙

내 파일 못 봄

코딩 에이전트

파일 직접 편집

명령 실행

내 프로젝트에 붙음

머리(LLM)는 같음 · 차이는 손이 내 폴더에 닿느냐
P.02바이브코딩 · 03

설치하고 프로젝트에서 켜기

시작은 세 줄임. 설치하고 · 프로젝트 폴더로 들어가고 · 켬.

한 번 설치해 두면 어느 프로젝트에서든 씀.
중요한 건 켜는 위치임.
작업할 프로젝트 폴더 안에서 켜야 그 폴더가 작업 범위가 됨.

엉뚱한 폴더에서 켜면 엉뚱한 파일을 봄.
그래서 첫 동작은 늘 같음 — 프로젝트 폴더로 cd 한 뒤 실행.
켜는 순간 에이전트가 그 폴더 구조를 스캔함.

설치 → 폴더 진입 → 실행
터미널 · 켜는 위치가 곧 작업 범위
설치한 번만

$ npm i -g @anthropic-ai/claude-code

이동작업할 폴더로

$ cd my-project

실행여기서 켬

$ claude

Codex도 흐름 같음 — 설치·폴더 진입·실행

P.03바이브코딩 · 03

자연어로 작업을 지시한다

켰으면 명령어를 외울 필요 없음. 그냥 할 일을 말로 시킴.

“로그인 버그 고쳐줘” · “이 함수에 테스트 짜줘” 처럼.
에이전트가 폴더를 뒤져 관련 파일을 찾고 계획을 세움.

잘 시키는 요령은 한 가지임 — 또렷하게.
무엇을 · 어디를 · 어떻게 끝났다고 볼지 적어주면 헤매지 않음.
“대충 정리해줘”보다 “이 파일 import 순서만 정렬해줘”가 훨씬 잘 됨.

모호한 지시 ↔ 또렷한 지시
잘 시키는 법 · 또렷하게
모호대충 정리해줘
또렷import 순서만 알파벳순 정렬

범위가 또렷

모호버그 고쳐
또렷로그인 시 500 에러 원인 찾아 고쳐

증상이 또렷

모호테스트 좀
또렷add() 함수 단위 테스트 3개 추가

끝점이 또렷

P.04바이브코딩 · 03

첫 세션 — 직접 시켜 보기

오른쪽이 가짜 터미널임. 작업을 시키면 에이전트 루프가 한 줄씩 돎.

버튼을 누르면 보임.
할 일 파악(생각) → 파일 쓰기(도구) → 실행 → 결과 확인.
이게 매 작업마다 도는 한 사이클임.

“임시 파일 다 지워줘”를 눌러 보셈.
삭제 같은 위험 작업 앞에선 멈추고 권한 승인을 물음.
승인해야만 실행됨 / 거부하면 그 작업만 건너뜀.

명령 → 생각 → 파일 쓰기 → 실행
가짜 터미널 · 첫 세션
agent 세션 시작 — 이 프로젝트 폴더에 연결됨
작업 지시 — 눌러 보셈
you ▸
P.05바이브코딩 · 03

위험 작업은 승인을 받는다

파일을 직접 고치고 명령을 실행하니, 안전장치가 필요함.
그게 권한 승인임.

읽기·작은 편집 같은 건 그냥 진행함.
삭제 · 외부 설치 · 시스템 변경처럼 되돌리기 어려운 건 멈추고 물음.
사람이 한 번 확인한 뒤에야 손이 움직임.

그래서 흐름은 이럼.
시킴 → 에이전트가 계획·편집 → 위험하면 승인 요청 → 실행 → 결과 확인.
이 루프를 반복하며 일을 끝냄 / 키는 늘 내가 쥐고 있음.

Q. Claude Code·Codex가 실제로 도는 곳은? (브라우저 탭 · 내 터미널·프로젝트 · 회사 클라우드 · 별도 가상머신)정답은 내 터미널·프로젝트임.
내 컴퓨터 터미널에서 돌며 켠 폴더의 로컬 파일에 직접 접근함.
그래서 복붙 없이 파일을 고치고 명령을 실행할 수 있음.
대신 위험 작업은 권한 승인을 거침.
안전 작업 ↔ 승인이 필요한 작업
그냥 진행 ↔ 승인 받고 진행
그냥 진행
파일 읽기
작은 편집
테스트 실행
승인 필요
rm -rf 삭제
패키지 설치
시스템 설정 변경

위험 작업 → 멈춤 → 승인 → 실행

3줄 요약

  1. 1설치·첫 세션 — 터미널에서 일 시키기
  2. 2Claude Code·Codex 시작은 에이전트 원리 → 도구·권한 → 스킬·하네스 → 멀티에이전트 → 실전 흐름 안의 한 칸이다.
  3. 3개념을 외우는 것보다 입력을 바꾸면 무엇이 달라지는지 보는 것이 우선이다.

완료 전 점검

복습 카드

Claude

설치·첫 세션 — 터미널에서 일 시키기

에이전트

스스로 도구를 써가며 일하는 LLM 프로그램

도구

에이전트가 호출하는 기능(파일·실행·검색)