Claude Code를 VS Code에서 쓰는 이유: 1년 정착한 AI 작업환경 세팅

저는 주로 안티그래비티¹, VS코드²에서 클로드 코드를 설치하고 작업을 시작합니다. CLI³도 편하긴 하지만, 파일이 생성되는 것, 폴더구조 등을 시각적으로 보는 것이 이게 편하기 때문입니다.

(1) 안티그래비티(Antigravity) — AI 에이전트 기반 개발 환경 서비스.

(2) VS Code(Visual Studio Code) — Microsoft가 만든 무료 코드 편집기. 확장 프로그램으로 Claude Code를 설치하면 에디터 안에서 바로 AI와 대화하며 작업할 수 있습니다.

(3) CLI(Command Line Interface) — 마우스 없이 터미널에 명령어를 입력해서 사용하는 방식.

코덱스⁴나 제미나이 CLI⁵도 사용했으나, 사용성, 성능 측면에서 클로드가 가장 사용자 경험이 좋았습니다. 저 뿐만 아니라 개발자 및 에이전틱 AI⁶를 적극 활용하는 사람들은 대체로 클로드를 선호하거나 우수하다고 생각하는 것 같습니다.

어차피 이 하니스⁷들은 서로를 복제하면서 비슷해지는 경향이 있으니, 자신의 스타일에 맞는 서비스를 구독하면 됩니다. 최근 코덱스를 이용한 경험이 있는데, 코덱스는 지시에 따라 일을 모두 처리하는 성향이 있는 것 같고, 클로드는 같이 상의하면서 일을 개선해나가는 성향이 있는 것 같습니다. 안티그래비티에서 제공되는 에이전트는 충분히 상의하기 전에 빠르게 코드를 생성해버려 점점 사용하지 않게 되었습니다. (사용법을 잘 몰랐던 것일 수도 있겠지만)

최근 나온 클로드 코워크도 사용해봤으나 클로드 코드보다는 비교적 닫힌 환경이라 사용에 제한이 있습니다. 클로드 코드는 내 컴퓨터 환경을 활용하고, 코워크는 별도의 VM⁸에서 운영되는 것으로 보입니다.

(4) 코덱스(Codex) — OpenAI에서 만든 코딩 특화 AI 에이전트.

(5) 제미나이 CLI(Gemini CLI) — Google의 AI 모델 Gemini를 터미널에서 사용할 수 있는 도구.

(6) 에이전틱 AI(Agentic AI) — 단순히 질문에 답하는 것을 넘어, 스스로 계획을 세우고 파일을 만들거나 명령어를 실행하는 등 일련의 작업을 자율적으로 처리하는 AI.

Claude Code vs Cowork — 환경 차이

Claude Code (CLI) Cowork

실행 환경 내 Mac 그대로 별도 Linux VM

터미널 명령어 실행 ✅ ❌

로컬 도구 사용 (brew, python 등) ✅ ❌

Gmail / GWS 스킬 ✅ ❌

파일 읽기/쓰기 ✅ ✅

CLAUDE.md 읽기 ✅ ✅

VSCode 연동 ✅ ❌

쉽게 말하면 — Claude Code는 내 컴퓨터를 그대로 쓰고, Cowork는 깨끗하게 분리된 가상 공간에서 돌아갑니다. 자동화나 외부 도구를 써야 한다면 Claude Code가 맞습니다.

	Claude Code (CLI)	Cowork
실행 환경	내 Mac 그대로	별도 Linux VM
터미널 명령어 실행	✅	❌
로컬 도구 사용 (brew, python 등)	✅	❌
Gmail / GWS 스킬	✅	❌
파일 읽기/쓰기	✅	✅
CLAUDE.md 읽기	✅	✅
VSCode 연동	✅	❌

(7) 하니스(Harness) — LLM을 실제로 사용할 수 있게 감싸주는 도구 모음. Claude Code, Codex, Gemini CLI 같은 것들이 여기 해당합니다.

(8) VM(Virtual Machine, 가상 머신) — 실제 컴퓨터 안에 소프트웨어로 만든 또 다른 컴퓨터. 격리된 환경이라 내 Mac에 설치한 도구들을 쓸 수 없습니다.

CLAUDE.md⁹에는 클로드 코드, 코덱스에는 agent.md¹⁰ 파일을 만들어야 합니다. 클로드 기준으로는 글로벌 CLAUDE.md¹¹가 있고 프로젝트별 CLAUDE.md¹²가 있는데, 글로벌의 경우에는 작업의 대원칙, 나와 같이 일할 때 규칙 등을 지정하면 됩니다. 그리고 프로젝트별로 프로젝트의 성격, 파일 구조 등 LLM이 알아야 할 사항을 간략하게 설명해주면 됩니다. 세션을 실행하면 규칙에 따라 읽어야 할 파일을 읽으므로 지난 세션의 맥락을 이어나갈 수 있습니다.

CLAUDE.md, agent.md 등은 LLM과 얘기하면서 정하면 됩니다. 대화를 시작하고, 의견을 묻고 정리시키면 내가 직접 작성하는 것보다 깔끔하게 만들어집니다.

(9) CLAUDE.md — Claude Code에게 작업 규칙과 프로젝트 맥락을 알려주는 설명서 파일. 세션이 시작될 때 자동으로 읽힙니다.

(10) agent.md — 코덱스(Codex)에서 CLAUDE.md와 같은 역할을 하는 파일. 도구마다 파일 이름이 다릅니다.

(11) 글로벌 CLAUDE.md — 모든 프로젝트에 공통으로 적용되는 규칙. ~/.claude/CLAUDE.md 위치에 저장합니다.

(12) 프로젝트 CLAUDE.md — 해당 프로젝트 폴더에만 적용되는 규칙. 프로젝트 루트에 저장합니다.

AI 에이전트 컨설팅 문의

AI 에이전트는 설치보다 운영 구조가 더 중요합니다.

Boilerplate는 Codex CLI, Claude Code, Hermes Agent, OpenClaw, 자동화 서버, 개인 업무 자동화 흐름을 실제 사용 환경에 맞게 정리합니다.

윈도우 PC, Mac mini, Linux 홈서버, VPS 중 어디에 설치할지부터 정하고, 계정·보안·백업·자동 실행까지 함께 설계합니다.

AI 에이전트 컨설팅 문의하기