도구를 골랐으면
이제 자리를 고를 차례입니다.

00 — Before You Read

도구와 환경은 다른 이야기입니다

입문자가 가장 자주 엉키는 지점입니다. "클로드코드 vs 커서 뭐가 나아요?"라는 질문이 성립하지 않는 이유이기도 합니다. 둘은 비교 대상이 아닙니다.

같은 에이전트가 옷만 갈아입습니다. 터미널에서 부르든 VS Code에서 부르든 클로드코드는 같은 클로드코드입니다. 달라지는 건 화면과 승인 절차와 "한 번에 몇 개를 돌릴 수 있나"입니다. 그래서 환경은 도구를 바꾸지 않고도 바꿀 수 있습니다. 마음에 안 들면 내일 다른 환경으로 옮겨도 프로젝트는 그대로입니다.

01 — Four Environments

네 개의 환경

흔히 CLI·GUI·IDE 셋으로 나누지만 2026년에는 네 번째가 생겼습니다. 여러 에이전트를 한 판에 놓고 돌리는 오케스트레이터입니다. 이 문서에서 색이 곧 환경입니다.

비유로 한 번 더

학교에서 유인물을 만든다고 해봅시다. 같은 한글 프로그램을 쓰는데:

• CLI 단축키만으로 다 하는 사람. 빠르지만 단축키를 알아야 합니다.
• GUI 메뉴를 눌러 가며 하는 사람. 느리지만 뭘 누르는지 보입니다.
• IDE 편집 화면 옆에 도우미 창을 띄워 놓은 사람. 문서를 보면서 시킵니다.
• 오케스트레이터 유인물 네 종류를 동시에 만들면서 넷을 나란히 비교하는 사람.

비유는 여기까지입니다. 실제 차이는 다음 장의 표에 있습니다.

02 — Head to Head

정면 비교표

느낌이 아니라 공식 문서로 확인된 차이만 담았습니다. 조회일 2026-08-25 기준이며 기능은 몇 주 단위로 바뀝니다.

03 — Command Line

CLI 터미널에서 직접

검은 창에 claude 또는 codex를 치면 시작됩니다. 가장 기능이 많고 처음엔 가장 무섭게 느껴지며 사고도 여기서 제일 많이 납니다.

윈도우에서 뭘 깔아야 하나

학교 PC는 대개 윈도우입니다. 다행히 둘 다 관리자 권한 없이 설치됩니다.

한글이 깨질 때

윈도우 기본 PowerShell 5.1은 출력 기본 인코딩이 UTF-8이 아닙니다. 그래서 파일을 만들면 한글이 깨지거나 ?로 바뀌는 일이 있었습니다.

• 클로드코드 v2.1.214부터 대부분 고쳐졌습니다. 먼저 최신 버전인지 확인하세요
• 그래도 깨지면 그 창에서 chcp 65001을 한 번 치면 해당 세션은 해결됩니다
• 근본 해결은 PowerShell 7을 쓰는 것입니다. 7부터는 모든 출력이 BOM 없는 UTF-8입니다

윈도우 권장 조합

1. Windows Terminal

   사실상 표준입니다. Shift+Enter 줄바꿈이 설정 없이 동작하는 몇 안 되는 터미널입니다.

2. PowerShell 7

   한글 인코딩 문제의 근본 해결책. 5.1을 그대로 쓰면 언젠가 한 번은 겪습니다.

3. Git for Windows

   설치해 두면 에이전트가 Bash 도구를 씁니다. 없으면 PowerShell 도구로 대체되는데, 공식 문서는 설치를 권장합니다.

4. 도구 본체 설치

   PowerShell에서 한 줄이면 끝납니다. 관리자 권한 없이 됩니다.

04 — Graphical

GUI 앱과 웹

도구를 만든 회사가 직접 내놓은 앱과 웹사이트입니다. 비개발자 교사에게 가장 먼저 권하는 환경이고 설치가 막힌 PC의 유일한 탈출구이기도 합니다.

데스크톱 앱 — 터미널 없이

클로드코드 데스크톱 앱은 macOS·Windows(x64·ARM64)·Linux로 나옵니다. 공식 문서가 "터미널 없이 클로드코드를 쓰게 해준다"고 소개하는 도구입니다.

웹 — 설치가 막혔을 때의 답

브라우저만 있으면 됩니다. 설치도, 관리자 권한도, Node도 필요 없습니다. 학교 PC에서 아무것도 못 깔 때 남는 유일한 길입니다.

휴대폰에서 이어 보기

웹·클라우드 세션은 브라우저를 닫아도 계속 돌아갑니다. 그리고 모바일 앱에서 진행 상황을 볼 수 있습니다. 퇴근길에 확인하고 싶다면 이게 답입니다. 코덱스도 Plus 플랜부터 iOS에서 쓸 수 있습니다.

05 — Editor

IDE 에디터 안으로

쓰던 편집기를 안 바꾸는 게 가장 싼 선택입니다. VS Code는 무료이고 두 도구 모두 공식 확장을 냅니다.

왜 VS Code인가

• 무료입니다. 편집기 자체에 돈이 들지 않습니다
• 관리자 권한 없이 설치됩니다(사용자 설치). 학교 PC에서 통과할 확률이 높습니다
• 클로드코드·코덱스 둘 다 공식 확장이 있습니다. 나중에 도구를 바꿔도 편집기는 그대로입니다
• 커서·윈드서프도 VS Code 계열이라 여기서 배운 게 그대로 옮겨갑니다

확장이 실제로 더해주는 것

가장 큰 차이는 승인 화면입니다. 터미널이 글자로 묻는 것을, 확장은 바뀌기 전과 후를 좌우로 나란히 보여주고 묻습니다. 수락하기 전에 그 자리에서 직접 고칠 수도 있습니다. 고치면 에이전트에게 "사람이 손봤다"고 알려줍니다.

커서는 뭐가 다른가

커서는 VS Code를 바탕으로 만든 별개의 편집기입니다. 편집기 자체가 AI를 전제로 설계돼 있어 자동완성이 강합니다. 코덱스 확장도 커서를 공식 지원합니다. 다만 편집기를 갈아타는 결정이라 처음부터 고를 필요는 없습니다. VS Code에 확장을 얹어 보고 부족하다고 느낄 때 옮겨도 늦지 않습니다.

06 — Orchestrator

오케스트레이터 여러 개를 한 판에

2026년에 자리 잡은 네 번째 환경입니다. 에이전트를 여러 개 동시에 돌리고 각자 다른 사본에서 일하게 한 뒤 결과를 한 화면에 모아 검토합니다. 스스로를 IDE와 구분해 ADE(Agent Development Environment)라고 부르기도 합니다.

어떤 문제를 푸는 도구인가

창을 여러 개 띄워 본 사람이면 압니다. 두 작업이 같은 파일을 동시에 고쳐서 서로를 덮어쓰고 어느 창에서 뭘 시켰는지 헷갈립니다. 오케스트레이터는 이걸 작업마다 프로젝트 사본을 따로 펼쳐 해결합니다. git의 worktree 기능입니다. 작업끼리 물리적으로 다른 폴더에 있으니 부딪힐 수가 없습니다.

두 도구

교사에게 의미 있는 두 가지

07 — Decide

나는 어느 환경인가

가장 가까운 상황을 하나 고르면 추천이 나옵니다. 여러 개 해당되면 맨 위에 있는 것부터 보세요. 위쪽이 더 강한 제약입니다.

세 가지 질문으로 끝내기

도쌤은 이렇게 씁니다

중립적으로 늘어놓기만 하면 결국 아무것도 못 고릅니다. 그래서 지금 이 문서를 쓰는 사람의 조합을 밝힙니다.

08 — Same Task

같은 작업, 네 환경

"학급 자리 뽑기 웹앱 만들어줘"라는 똑같은 한 문장을 네 환경에 넣으면 무엇이 달라지는지 따라가 봅니다. 결과물은 비슷합니다. 달라지는 건 가는 길입니다.

09 — Accidents

사고와 복구

환경마다 잘 나는 사고가 다릅니다. 미리 알면 대부분 안 납니다.

승인을 어떻게 묻느냐가 사고를 가릅니다

에이전트가 파일을 고치거나 명령을 돌리기 전에 물어보는 정도를 승인 모드라고 합니다. 도구마다 이름이 다릅니다.

도구가 이미 막아 주는 것

다행히 맨몸은 아닙니다. 클로드코드에는 어떤 모드에서도 그냥 넘어가지 않는 경로가 정해져 있습니다.

• 보호 경로. .git, .claude, .vscode, .bashrc, .npmrc 같은 설정 파일·폴더는 쓰기 전에 항상 다시 묻습니다
• 치명 경로. 드라이브 루트나 홈 폴더를 통째로 지우는 명령은 허용 규칙을 넣어 둬도 거부됩니다

환경별로 잘 나는 사고

망가졌을 때 복구 순서

1. 일단 멈추세요

   더 시키지 마세요. 고치라고 또 시키면 더 꼬입니다.

2. 커밋했는지 확인

   "마지막 커밋이 언제고 지금 안 올라간 변경이 뭐야?"라고 물어보세요. 커밋이 있으면 거의 다 살아납니다.

3. 커밋이 있으면 되돌리기

   "방금 바꾼 거 취소하고 마지막 커밋 상태로 돌려줘." 이미 깃허브에 올렸다면 지우지 말고 취소하는 커밋을 새로 쌓으세요.

4. 커밋이 없으면

   돌아갈 지점이 없습니다. 편집기의 로컬 실행 취소가 마지막 희망입니다. 다음부터는 잘 될 때마다 커밋하세요.

5. 키가 새어 나갔다면 되돌리기 문제가 아닙니다

   파일을 지워도 기록에 남습니다. 발급처에서 그 키를 즉시 폐기하는 게 먼저입니다.

10 — School PC

학교 PC 진단

해당하는 것을 체크해 보세요. 체크가 많을수록 학교 PC에 설치하는 길이 막혀 있다는 뜻입니다.

막혔을 때의 정당한 우회로

보안 설정을 임의로 푸는 것은 답이 아닙니다. 기관 정보보안 지침 위반이 될 수 있고 공용 PC라면 다른 선생님까지 위험해집니다. 대신 이 세 가지를 보세요.

1. 브라우저로 되는 것부터

   웹앱은 설치가 없습니다. 학교 PC에서 시작할 때 가장 걸리는 게 없습니다.

2. 개인 노트북에 제대로 꾸리기

   본격적으로 만들 거면 이게 정답입니다. 학교 PC와 씨름하는 시간보다 훨씬 빠릅니다.

3. 필요하면 정식으로 신청

   수업·업무에 쓸 근거가 있으면 정보부에 정식 요청하세요. 무단 설치보다 훨씬 안전합니다.

크롬북·아이패드라면

차단됐을 때 — 신청서라는 정식 절차가 있습니다

학교 인터넷은 개별 PC가 아니라 교육지원청 구간에서 일괄 필터링됩니다. 그래서 내 PC 설정을 아무리 바꿔도 안 뚫립니다. 뚫으려 해서도 안 됩니다.

대신 시도교육청마다 인터넷서비스 일시해제 신청 절차가 있습니다. 업무상 필요를 적어 내면 기간을 정해 열어 줍니다. 소속 교육청 정보보안 담당 부서에 문의하세요.

＋ — Reference

레퍼런스

환경을 옮겨 다니다 보면 같은 것을 도구마다 다르게 부릅니다. 여기서 찾으세요.

용어 대응표

검색창에 우리말이든 영어든 넣으면 걸립니다.

월 얼마면 되나 2026-08-25 조회

환경이 아니라 도구에 돈이 듭니다. 오케스트레이터·VS Code·터미널은 전부 공짜입니다.

환경을 옮길 때 챙길 것

환경을 바꿔도 프로젝트 폴더는 그대로입니다. 옮겨야 하는 건 폴더 밖에 있는 것뿐입니다.

＋ — Sources

자료 출처

이 문서의 사실은 2026년 8월 25일에 각 사 공식 문서로 확인했습니다. 기능·요금은 몇 주 단위로 바뀌므로, 도입을 결정하기 전 원문을 다시 확인하시길 권합니다.

공식 문서

• Anthropic Claude Code 개요 · 설치 · 권한 모드 · VS Code · 데스크톱 앱 · 웹 · 샌드박스 · 비용
• OpenAI Codex 문서 · 샌드박스 · 승인·보안 · 요금 (옛 주소 developers.openai.com/codex 는 이쪽으로 넘어옵니다)
• 오케스트레이터 paseo.sh · onorca.dev
• Microsoft PowerShell 문자 인코딩 · WSL 설치 · Windows Terminal
• 기타 GitHub Education 교사 · 크롬북 리눅스 개발 환경 · Cursor 요금

법령

• 초·중등교육법 제30조의6 학생 관련 자료 제공의 제한
• 개인정보 보호법 제28조의8 개인정보의 국외 이전