실습 노트
AI 코딩 CLI 설치 후 처음 세팅할 것 7가지: Codex·Claude Code·Antigravity 공통 가이드
Codex CLI, Claude Code CLI, Antigravity CLI를 설치한 뒤 바로 확인해야 할 작업 폴더, Git 백업, 규칙 파일, 권한, 민감정보, 검증 루틴을 초보자 기준으로 정리했습니다.
Codex CLI, Claude Code CLI, Antigravity CLI를 설치했다면 이제부터가 진짜 시작입니다.
설치 명령어를 따라 하는 것보다 더 중요한 것은 어디에서 실행할지, 무엇까지 허용할지, 어떤 규칙을 줄지를 정하는 일입니다.
AI 코딩 CLI는 단순한 챗봇이 아닙니다. 현재 폴더의 파일을 읽고, 수정하고, 명령어를 실행할 수 있는 도구입니다. 그래서 처음부터 중요한 업무 폴더에서 실행하면 불안하고, 반대로 너무 아무 규칙 없이 쓰면 결과가 들쭉날쭉합니다.
이 글은 아래 설치 글 3개를 따라 한 뒤 바로 이어서 보면 됩니다.
설정까지 끝났다면 다음 실습으로 AI 코딩 CLI로 첫 홈페이지 만들기를 보면 됩니다.
공식 문서는 OpenAI Codex 매뉴얼, Claude Code Docs, Google Antigravity 문서, AGENTS.md 공식 사이트를 기준으로 확인했습니다.
참고: OpenAI Codex CLI →, Claude Code Quickstart →, Claude Code Memory →, Antigravity Rules & Workflows →, AGENTS.md →
먼저 결론
설치 후 처음 세팅은 아래 7가지만 하면 됩니다.
- 연습용 폴더에서 먼저 실행하기
- 어떤 CLI를 쓰는지 버전과 로그인 상태 확인하기
- Git으로 되돌릴 수 있는 상태 만들기
AGENTS.md또는CLAUDE.md로 작업 규칙 적기- 권한 모드를 처음부터 너무 넓게 열지 않기
- 민감한 파일과 폴더를 피하기
- 변경 전 설명, 변경 후 검증 루틴 만들기
이 7개만 해도 AI 코딩 CLI를 훨씬 안전하게 시작할 수 있습니다.
1. 연습용 폴더에서 먼저 실행하기
처음 실행은 반드시 연습용 폴더에서 합니다.
초보자라면 터미널 명령어로 폴더를 만들지 말고, 먼저 눈에 보이는 곳에서 직접 만듭니다.
- 바탕화면으로 갑니다.
- 빈 곳에서 마우스 오른쪽 버튼을 누릅니다.
- 새로 만들기 → 폴더를 누릅니다.
- 폴더 이름을
ai-cli-practice로 바꿉니다.
그다음 바탕화면 위치에서 PowerShell을 엽니다.
- 파일 탐색기에서 바탕화면을 엽니다.
- 위쪽 주소창을 클릭합니다.
powershell을 입력하고 Enter를 누릅니다.
PowerShell 창이 열리면 아래처럼 입력합니다.
cd ai-cli-practice
그다음 자신이 설치한 도구 하나만 실행합니다.
codex
claude
agy
처음부터 바탕 화면, 다운로드, 회사 문서, 계약서, 개인정보가 들어 있는 폴더에서 실행하지 않습니다.
여기서 말하는 바탕화면은 바탕화면 전체가 아니라, 바탕화면 안에 새로 만든 빈 연습 폴더입니다. AI 코딩 CLI는 현재 폴더를 기준으로 파일을 읽고 수정합니다. 연습용 폴더에서 작게 테스트한 뒤, 실제 프로젝트 폴더로 옮기는 편이 안전합니다.
2. 버전과 로그인 상태 확인하기
설치가 끝났다고 바로 되는 것은 아닙니다.
먼저 버전 확인을 합니다.
| 도구 | 버전 확인 | 실행 |
|---|---|---|
| Codex CLI | codex --version |
codex |
| Claude Code CLI | claude --version |
claude |
| Antigravity CLI | agy --version |
agy |
예를 들어 PowerShell에서 이렇게 확인합니다.
codex --version
claude --version
agy --version
전부 설치할 필요는 없습니다.
ChatGPT 계정을 주로 쓰면 Codex CLI, Claude 구독을 쓰면 Claude Code, Google 계정 기반 흐름을 써보고 싶으면 Antigravity CLI부터 시작하면 됩니다.
3. Git으로 되돌릴 수 있는 상태 만들기
AI 코딩 CLI를 실제 프로젝트에서 쓰기 전에는 Git 상태를 먼저 확인합니다.
git status
이미 Git 저장소라면 현재 변경사항이 있는지 봅니다.
변경사항이 많다면 먼저 커밋하거나 백업합니다.
git add .
git commit -m "Backup before AI CLI work"
아직 Git 저장소가 아니라면 새로 만들 수 있습니다.
git init
git add .
git commit -m "Initial backup"
이렇게 해두면 AI가 파일을 잘못 바꿔도 git diff로 확인하고 되돌릴 수 있습니다.
git diff
초보자에게 제일 중요한 안전장치는 복잡한 설정이 아니라 되돌릴 수 있는 상태입니다.
4. 작업 규칙 파일 만들기
AI 코딩 CLI에게 매번 같은 말을 반복하지 않으려면 프로젝트 루트에 규칙 파일을 둡니다.
Codex는 공식 문서 기준으로 AGENTS.md를 읽습니다. Claude Code는 CLAUDE.md를 읽습니다. Claude Code 문서에서는 이미 AGENTS.md를 쓰고 있다면 CLAUDE.md에서 @AGENTS.md로 가져오는 방식도 안내합니다.
Antigravity는 Global Rules와 Workspace Rules처럼 작업 규칙을 Markdown으로 관리하는 흐름을 제공합니다.
처음에는 어렵게 쓰지 말고 아래 정도만 적어도 충분합니다.
# AGENTS.md
## 기본 원칙
- 작업 전 어떤 파일을 바꿀지 먼저 설명한다.
- 파일 삭제 전 반드시 확인을 받는다.
- 수정 후 가능한 경우 `npm run build` 또는 관련 테스트를 실행한다.
- `.env`, 비밀번호, 계약서, 개인정보 파일은 건드리지 않는다.
- 사용자가 명시하지 않으면 직접 push하지 않는다.
Claude Code도 함께 쓴다면 프로젝트 루트에 CLAUDE.md를 만들고 이렇게 적을 수 있습니다.
@AGENTS.md
## Claude Code
- 큰 변경 전에는 먼저 계획을 보여준다.
- Windows에서는 경로 표기를 사용자가 이해하기 쉽게 설명한다.
Windows에서는 심볼릭 링크보다 @AGENTS.md import 방식이 더 편합니다.
5. 권한 모드를 처음부터 너무 넓게 열지 않기
AI 코딩 CLI는 파일 수정과 명령 실행을 할 수 있습니다.
처음부터 모든 권한을 열면 편해 보이지만, 초보자에게는 오히려 위험합니다.
Codex는 공식 문서에서 sandbox와 approval을 구분합니다. sandbox는 실제로 어디까지 읽고 쓰고 네트워크를 쓸 수 있는지의 경계이고, approval은 그 경계를 넘을 때 사용자에게 물어볼지 정하는 정책입니다.
처음에는 이런 방향이 좋습니다.
| 상황 | 권장 방식 |
|---|---|
| 폴더 구조 설명만 받고 싶음 | 읽기 중심으로 시작 |
| 파일을 조금 수정해보고 싶음 | 현재 작업 폴더 안에서만 허용 |
| 네트워크나 외부 설치가 필요함 | 실행 전 반드시 이유 확인 |
| 전체 PC를 마음대로 다루게 하고 싶음 | 초보 단계에서는 피하기 |
Codex CLI에서는 세션 안에서 /permissions로 권한 모드를 바꿀 수 있습니다.
Claude Code와 Antigravity도 실행 중 제안되는 파일 수정, 명령 실행, 작업 폴더 신뢰 여부를 무조건 승인하지 말고 먼저 내용을 봅니다.
6. 민감한 파일과 폴더를 피하기
처음에는 아래 폴더에서 실행하지 않는 편이 좋습니다.
C:\Users\내이름\DownloadsC:\Users\내이름\Desktop전체, 즉 바탕화면 루트- 회사 문서 폴더
- 계약서 폴더
- 개인정보가 들어 있는 폴더
.env파일이 많은 실제 서비스 폴더
특히 .env 파일에는 API 키, 비밀번호, 토큰이 들어 있을 수 있습니다.
AI 코딩 CLI에게 이렇게 말해두는 것도 좋습니다.
.env 파일은 읽지 말고, API 키나 비밀번호가 보이면 답변에 출력하지 마.
그리고 규칙 파일에도 같은 내용을 남겨둡니다.
- `.env`, `.pem`, `.key`, 인증 토큰, 개인정보 파일은 읽거나 출력하지 않는다.
완전히 강제되는 보안 정책이 필요한 조직이라면 단순한 지시문만으로 부족합니다. 이 경우에는 도구별 권한 설정, 관리형 설정, 훅, 별도 작업 계정 같은 운영 설계를 함께 잡아야 합니다.
7. 변경 전 설명, 변경 후 검증 루틴 만들기
AI 코딩 CLI에게 처음부터 이렇게 요청합니다.
파일을 수정하기 전에 어떤 파일을 바꿀지 먼저 설명해줘.
수정 후에는 변경 요약과 확인 명령어를 알려줘.
수정이 끝나면 바로 아래 순서로 확인합니다.
git diff
npm run build
npm run lint
프로젝트에 따라 npm이 아니라 pnpm, yarn, python, pytest, make test일 수 있습니다.
그래서 AGENTS.md에 프로젝트별 확인 명령어를 적어두는 것이 좋습니다.
## 확인 명령어
- 웹사이트 수정 후: `npm run build`
- 문서만 수정한 경우: 맞춤법과 링크 확인
- 배포 전: `git diff --check`
이렇게 해두면 AI가 매번 더 안정적인 순서로 작업합니다.
처음 시켜볼 만한 안전한 요청
처음에는 파일 삭제나 대규모 수정이 아니라 설명과 작은 생성부터 시작합니다.
이 폴더 구조를 초보자도 이해하게 설명해줘. 파일은 수정하지 마.
README.md 초안을 만들어줘. 기존 파일은 건드리지 말고 새 파일만 제안해줘.
이 프로젝트에서 실행 가능한 확인 명령어를 찾아줘. 실행은 하지 말고 먼저 목록만 보여줘.
AGENTS.md 초안을 만들어줘. 내 허락 없이 커밋하거나 push하지 마.
이런 요청으로 시작하면 도구가 어떤 방식으로 읽고, 제안하고, 수정하는지 감을 잡을 수 있습니다.
자주 하는 실수
| 실수 | 왜 문제인지 | 대신 할 일 |
|---|---|---|
| 다운로드 폴더에서 바로 실행 | 관련 없는 파일까지 읽을 수 있음 | 연습 폴더에서 시작 |
| Git 백업 없이 수정 | 되돌리기 어려움 | git status, git commit 먼저 |
| 모든 권한을 바로 허용 | 예상 밖 명령이 실행될 수 있음 | 처음에는 승인 단계 유지 |
| 규칙 파일 없이 매번 요청 | 결과가 매번 달라짐 | AGENTS.md 또는 CLAUDE.md 작성 |
| AI가 만든 변경을 바로 신뢰 | 빌드 실패나 오동작 가능 | git diff, 테스트, 빌드 확인 |
| 민감정보가 있는 폴더에서 실행 | API 키·개인정보 노출 위험 | 별도 작업 폴더 사용 |
초보자용 추천 흐름
처음 하루는 아래 순서로만 해보면 됩니다.
- 바탕화면에
ai-cli-practice폴더 직접 만들기 - 파일 탐색기에서 바탕화면을 열고 주소창에
powershell입력 - PowerShell에서
cd ai-cli-practice입력 codex,claude,agy중 하나만 실행- 폴더 설명 요청하기
hello.txt같은 작은 파일 하나 만들기- 실제 프로젝트에는 다음날 적용하기
도구를 많이 설치하는 것보다, 하나를 안전하게 쓰는 방식이 더 중요합니다.
Boilerplate AI 컨설팅
Boilerplate는 AI 도구 설치만 설명하는 곳이 아니라, 실제 업무에 맞게 AI를 적용하는 AI 업무자동화 컨설팅을 진행합니다.
Codex CLI, Claude Code, Antigravity CLI 같은 도구를 조직 안에서 어디까지 허용할지, 어떤 폴더에서 실행할지, 어떤 규칙 파일을 둘지, 어떤 업무부터 자동화할지 함께 설계할 수 있습니다.
AI 코딩 CLI를 설치했지만 실제 업무 적용이 막힌다면 아래 페이지로 연락주세요.