내가 Claude Code를 VS Code에서 쓰는 이유
같은 Claude인데 환경에 따라 할 수 있는 게 다르다. 작업환경 세팅 1년의 기록.
나는 주로 안티그래비티1, VS코드2에서 클로드 코드를 설치하고 작업을 시작한다. CLI3도 편하긴 하지만, 파일이 생성되는 것, 폴더구조 등을 시각적으로 보는 것이 이게 편하기 때문이다.
코덱스4나 제미나이 CLI5도 사용했으나, 사용성, 성능 측면에서 클로드가 가장 사용자 경험이 좋았다. 나 뿐만 아니라 개발자 및 에이전틱 AI6를 적극 활용하는 사람들은 대체로 클로드를 선호하거나 우수하다고 생각하는 것 같다.
어차피 이 하니스7들은 서로를 복제하면서 비슷해지는 경향이 있으니, 자신의 스타일에 맞는 서비스를 구독하면 된다. 최근 코덱스를 이용한 경험이 있는데, 코덱스는 지시에 따라 일을 모두 처리하는 성향이 있는 것 같고, 클로드는 같이 상의하면서 일을 개선해나가는 성향이 있는 것 같다. 안티그래비티에서 제공되는 에이전트는 충분히 상의하기 전에 빠르게 코드를 생성해버려 점점 사용하지 않게 되었다. (사용법을 잘 몰랐던 것일 수도 있겠지만)
최근 나온 클로드 코워크도 사용해봤으나 클로드 코드보다는 비교적 닫힌 환경이라 사용에 제한이 있다. 클로드 코드는 내 컴퓨터 환경을 활용하고, 코워크는 별도의 VM8에서 운영되는 것으로 보인다.
(1) 안티그래비티(Antigravity) — AI 에이전트 기반 개발 환경 서비스.
(2) VS Code(Visual Studio Code) — Microsoft가 만든 무료 코드 편집기. 확장 프로그램으로 Claude Code를 설치하면 에디터 안에서 바로 AI와 대화하며 작업할 수 있다.
(3) CLI(Command Line Interface) — 마우스 없이 터미널에 명령어를 입력해서 사용하는 방식.
(4) 코덱스(Codex) — OpenAI에서 만든 코딩 특화 AI 에이전트.
(5) 제미나이 CLI(Gemini CLI) — Google의 AI 모델 Gemini를 터미널에서 사용할 수 있는 도구.
(6) 에이전틱 AI(Agentic AI) — 단순히 질문에 답하는 것을 넘어, 스스로 계획을 세우고 파일을 만들거나 명령어를 실행하는 등 일련의 작업을 자율적으로 처리하는 AI.
(7) 하니스(Harness) — LLM을 실제로 사용할 수 있게 감싸주는 도구 모음. Claude Code, Codex, Gemini CLI 같은 것들이 여기 해당한다.
(8) VM(Virtual Machine, 가상 머신) — 실제 컴퓨터 안에 소프트웨어로 만든 또 다른 컴퓨터. 격리된 환경이라 내 Mac에 설치한 도구들을 쓸 수 없다.
Claude Code vs Cowork — 환경 차이
Claude Code (CLI) Cowork 실행 환경 내 Mac 그대로 별도 Linux VM 터미널 명령어 실행 ✅ ❌ 로컬 도구 사용 (brew, python 등) ✅ ❌ Gmail / GWS 스킬 ✅ ❌ 파일 읽기/쓰기 ✅ ✅ CLAUDE.md 읽기 ✅ ✅ VSCode 연동 ✅ ❌ 쉽게 말하면 — Claude Code는 내 컴퓨터를 그대로 쓰고, Cowork는 깨끗하게 분리된 가상 공간에서 돌아간다. 자동화나 외부 도구를 써야 한다면 Claude Code가 맞다.
CLAUDE.md9에는 클로드 코드, 코덱스에는 agent.md10 파일을 만들어야 한다. 클로드 기준으로는 글로벌 CLAUDE.md11가 있고 프로젝트별 CLAUDE.md12가 있는데, 글로벌의 경우에는 작업의 대원칙, 나와 같이 일할 때 규칙 등을 지정하면 된다. (나는 형님이라 호칭하도록 설정하는 등 몇 가지 규칙을 정해 놓았다.) 그리고 프로젝트별로 프로젝트의 성격, 파일 구조 등 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 — 해당 프로젝트 폴더에만 적용되는 규칙. 프로젝트 루트에 저장.