Claude Code는 CLI(Command Line Interface) 도구입니다. VS Code나 JetBrains와 같은 GUI 기반의 IDE(Integrated Development Environment)는 없습니다.

처음에는 "IDE가 없으면 불편하지 않을까?"라고 느낄지도 모릅니다. 하지만 적절하게 환경을 갖춘다면, 오히려 쾌적하게 개발할 수 있습니다.

이 기사에서는 Claude Code를 CLI로 사용할 때의 추천 설정을 소개합니다.

Windows 사용자는 Windows Terminal을 사용하세요. 페인 분할(Pane Split)을 사용할 수 있습니다.

세로 분할(좌우): Alt + Shift + +
가로 분할(상하): Alt + Shift + -
페인 간 이동: Alt + 방향키

왼쪽 페인에서 Claude Code를 구동하고, 오른쪽 페인에서 파일을 확인하거나 명령어를 실행하는 방식이 기본이 됩니다.

IDE 대신 VS Code를 파일 뷰어(File Viewer)로 열어두는 것을 추천합니다.

# 현재 디렉토리를 VS Code로 열기
code .

VS Code는 편집은 하지 않고, 파일 트리 확인과 코드 열람 전용으로 사용합니다. 실제 편집은 Claude Code에게 맡깁니다.

CLAUDE.md는 프로젝트 루트(Project Root)에 두는 설정 파일입니다. Claude Code가 가장 먼저 읽어 들여 프로젝트의 문맥(Context)을 파악합니다.

# 프로젝트 개요
○○를 위한 Web Application
## 기술 스택
...

작성하면 작성할수록 Claude Code의 이해도가 깊어져, 빗나간 제안이 줄어듭니다.

~/.claude/settings.json (글로벌 설정) 또는 .claude/settings.json (프로젝트 설정)에서 동작을 세밀하게 제어할 수 있습니다.

{
"permissions": {
"allow": [
...

자주 사용하는 명령어를 미리 허용해 두면, 실행할 때마다 승인을 요청받는 스트레스가 사라집니다.

deny에 운영 환경(Production Environment) 명령어를 넣어 두면 오조작을 방지할 수 있습니다.

ls, grep, git log 등의 읽기 계열 명령어는 매번 승인하는 것이 번거롭습니다. 한꺼번에 허용해 두도록 합시다.

{
"permissions": {
"allow": [
...

파괴적인 작업(rm, git reset --hard 등)은 허용하지 않고, 그때마다 확인하는 것을 추천합니다.

Hooks는 특정 타이밍에 자동으로 명령어를 실행하는 메커니즘입니다.

{
"hooks": {
"PostToolUse": [
...

파일 편집 후에 자동으로 lint를 실행하거나, 작업 완료 시 알림을 보내는 등 반복적으로 수동으로 수행하던 작업을 자동화할 수 있습니다.

CLAUDE.md는 디렉토리별로 둘 수 있습니다.

project/
├── CLAUDE.md # 프로젝트 전체 규칙
├── frontend/
...

프론트엔드 디렉토리에서 작업할 때, Claude Code는 프로젝트 루트와 frontend/ 양쪽의 CLAUDE.md를 모두 읽습니다. 서브 디렉토리에 특유의 규칙을 작성할 수 있습니다.

MCP(Model Context Protocol)를 사용하면 외부 도구와 연동할 수 있습니다.

{
"mcpServers": {
"github": {
...

GitHub와 연동하면 Claude Code가 직접 PR(Pull Request) 생성이나 Issue 확인을 할 수 있게 됩니다.

토큰을 프로젝트 로컬의 .claude/settings.json에 작성하는 경우에는 .gitignore에 추가하여 커밋을 방지하세요.

# .gitignore
.claude/settings.json

글로벌 설정(~/.claude/settings.json)에 작성하는 편이 더 안전합니다.

환경이 갖춰지면 작업 흐름은 다음과 같습니다.

1. Windows Terminal을 연다 (페인 분할)
왼쪽: Claude Code 실행
오른쪽: 파일 확인 / 명령어 실행용
...

IDE적인 조작(파일 찾기, 함수로 점프하기)은 전부 Claude Code에게 맡길 수 있으므로, 의외로 불편하지 않습니다.

Claude Code CLI 환경을 쾌적하게 만드는 포인트:

"IDE가 없다"는 것은 단점이 아니라, AI에게 전부 맡긴다는 결단입니다. 익숙해지면 IDE 시대보다 더 빠르게 개발할 수 있습니다.