VS Code에서 Claude Code 쓰기: 패널과 터미널 차이

VS Code에서 Claude Code를 쓰는 두 가지 방법

VS Code에서 Claude Code를 쓰는 방법은 두 가지입니다. 하나는 확장 프로그램이 띄우는 그래픽 패널입니다. 다른 하나는 통합 터미널에서 실행하는 독립형 CLI(command-line interface, 명령줄 도구)입니다. 내 PC에 있는 프로젝트라면 패널로 시작하세요. Anthropic 공식 문서가 VS Code에서 Claude Code를 쓰는 권장 방법으로 소개하는 것이 이 패널입니다.

코드가 VPS(virtual private server, 가상 사설 서버)에 있고 Remote-SSH로 연다면 선택이 달라집니다. 이 경우 문서로 뒷받침되는 경로는 서버에 독립형 CLI를 설치하고 Remote-SSH 터미널에서 claude를 실행하는 방법입니다. 아래에서는 두 방법의 차이를 먼저 설명합니다. 그다음 Windows와 한글 환경에서 막히기 쉬운 지점, 원격 서버에서 작업하는 순서를 다룹니다.

시작 전에: 어떤 Claude 요금제가 필요한가요?

Claude Code는 claude.ai 무료 요금제에 포함되지 않습니다. 설치 문서는 Pro, Max, Team, Enterprise 구독이나 Console 계정이 필요하다고 적고 있습니다. Bedrock, Google Cloud의 Agent Platform, Microsoft Foundry 같은 서드파티 제공자를 통해 쓰는 방법도 있습니다.

VS Code 확장도 같은 계정으로 로그인합니다. 유료 구독이나 Console 계정이면 되고, API 키는 따로 필요하지 않습니다. 요금제별 가격과 사용량 한도는 자주 바뀌므로 여기서 다시 적지 않습니다. 지금 쓰는 요금제로 충분한지는 Claude Pro 구독에 Claude Code가 포함되는지 정리한 글에서 확인하세요. 구독 계정과 API 키 중 무엇으로 로그인할지 고민된다면 구독 로그인과 API 키 로그인의 차이도 함께 읽어 보세요.

방법 1: VS Code 확장의 Claude Code 패널

확장을 설치하면 VS Code 안에 채팅 패널이 생깁니다. 문서는 이 패널을 Claude Code의 네이티브 그래픽 인터페이스라고 부릅니다. 터미널 화면 대신 편집기 UI에서 계획을 검토하고 수정 사항을 비교합니다. 지난 대화 기록을 다시 열 수 있고, 대화 여러 개를 탭이나 창으로 나눠 띄울 수도 있습니다.

Claude Code 패널은 어디서 여나요?

패널을 여는 방법은 네 가지입니다.

• 편집기 툴바(편집기 오른쪽 위)의 Spark 아이콘을 누릅니다. 파일이 하나 열려 있어야 이 아이콘이 보입니다.
• 왼쪽 액티비티 바의 Spark 아이콘을 누릅니다. 이 아이콘은 세션 목록을 엽니다.
• 명령 팔레트에서 Claude Code를 검색해 실행합니다.
• 아래쪽 상태 표시줄의 ✻ Claude Code를 누릅니다. 파일을 하나도 열지 않은 상태에서도 동작합니다.

Spark 아이콘이 보이지 않으면 먼저 파일이 열려 있는지 확인하세요. 문서는 폴더만 열어 둔 상태로는 부족하다고 적고 있습니다. 파일을 하나 열거나 상태 표시줄 항목을 쓰면 됩니다. 그래도 보이지 않으면 작업 공간 신뢰 상태를 확인하세요. 확장은 VS Code의 Restricted Mode(제한 모드)에서 동작하지 않습니다. 이 부분은 아래 Restricted Mode 절에서 다시 설명합니다.

처음 열 때 로그인하기

패널을 처음 열면 로그인 화면이 나옵니다. Sign in을 누르고 브라우저에서 승인을 마치면 됩니다. 회사에서 Team이나 Enterprise 좌석을 받았다면 그 계정으로 로그인하세요.

권한 모드: Auto, Manual, Plan, Edit automatically

패널의 모드 표시기는 Claude가 파일을 고치기 전에 얼마나 자주 허락을 구할지 정합니다. 모드는 네 가지입니다.

• Manual: 파일을 고칠 때마다 원본과 수정안을 나란히 보여 주고 허락을 구합니다. 수락하거나 거절할 수 있고, 대신 무엇을 하라고 지시할 수도 있습니다. 설정 파일에서는 이 모드의 값을 default라고 씁니다.
• Plan: 무엇을 할지 먼저 설명하고 승인을 기다립니다. VS Code가 계획을 마크다운 문서로 열어 주므로, 문서 안에 의견을 달아 피드백한 뒤에 작업을 시작시킬 수 있습니다.
• Edit automatically: 작업 공간 안의 파일 대부분을 묻지 않고 고칩니다.
• Auto: 이 모드에서도 작업 공간 안의 파일 대부분을 묻지 않고 고칩니다.

처음 시작할 때 어떤 모드가 선택되는지는 Claude Code 버전과 요금제에 따라 다릅니다. 그러니 첫 작업을 맡기기 전에 모드 표시기를 직접 확인하세요. 처음 보는 저장소라면 Manual이나 Plan으로 시작하는 편이 안전합니다. 수정이 일어나기 전에 사람이 한 번 읽게 되기 때문입니다. Auto 모드가 어떤 기준으로 동작하는지는 Claude Code Auto 모드와 권한 설정에서 자세히 다룹니다.

선택한 코드를 Claude에게 보여 주기: @-멘션

편집기에서 코드를 선택하면 Claude가 그 선택 영역을 자동으로 봅니다. 위치를 정확히 짚고 싶다면 Alt+K(macOS는 Option+K)를 누르세요. 입력창에 @app.ts#5-10처럼 파일 경로와 줄 번호가 들어간 @-멘션이 삽입됩니다. "app.ts의 5번째 줄부터 10번째 줄까지"를 말로 설명할 필요가 없습니다.

입력창에 @와 파일 이름 일부를 입력하면 퍼지 검색(fuzzy match, 이름이 대략 일치하는 파일 찾기)으로 파일을 고를 수 있습니다. 이름 끝에 /를 붙이면 폴더를 고릅니다.

패널과 CLI 사이에는 한 가지 차이가 있습니다. 패널은 files.exclude나 search.exclude에 걸린 파일에서 선택한 텍스트를 보내지 않습니다. respectGitIgnore가 켜져 있으면 gitignore된 파일도 마찬가지입니다. 반면 통합 터미널에서 실행한 CLI는 어떤 파일이든 선택한 텍스트를 보냅니다. 비밀 값이 든 파일을 편집기에 열어 둔 채 터미널에서 작업한다면 이 차이를 기억해 두세요.

수정 비교와 체크포인트 되감기

Manual 모드에서는 수정마다 원본과 수정안을 나란히 놓은 비교 화면이 뜹니다. 여기서 수정을 하나씩 확인하고 수락할지 정합니다.

작업이 잘못된 방향으로 갔다면 체크포인트로 되돌릴 수 있습니다. 메시지 위에 마우스를 올리면 되감기 버튼이 나타납니다. 선택지는 다음과 같습니다.

• Fork conversation from here: 이 지점에서 대화를 갈라 새로 이어 갑니다.
• Rewind code to here: 코드를 이 시점의 상태로 되돌립니다.
• Fork conversation and rewind code: 대화를 가르고 코드도 되돌립니다.

CLI에서는 /rewind 명령이나 Esc 키 두 번으로 같은 기능을 씁니다. 메뉴 문구는 패널과 다릅니다.

체크포인트에는 분명한 한계가 있습니다. Claude가 rm, mv, cp 같은 Bash 명령으로 바꾼 파일은 추적하지 않습니다. 그래서 이런 변경은 되감을 수 없습니다. 세션 밖에서 바뀐 내용, 예를 들어 사용자가 직접 편집기에서 고친 내용도 추적하지 않습니다. 문서는 체크포인트가 세션 안에서 빠르게 복구하기 위한 기능이며 버전 관리를 대신하지 않는다고 설명합니다. 커밋은 계속 git으로 하세요. 스냅샷은 최근 체크포인트 100개까지만 보관됩니다.

방법 2: 통합 터미널에서 Claude Code CLI 실행하기

두 번째 방법은 VS Code의 통합 터미널을 열고 claude를 실행하는 것입니다. Windows와 Linux에서는 Ctrl+`로 터미널을 엽니다. 이렇게 실행한 CLI도 IDE와 연동됩니다. 수정 비교 화면을 편집기에 띄우고, 편집기가 표시하는 오류와 경고 같은 진단 정보(diagnostics)를 Claude와 공유합니다.

확장을 설치했는데 터미널에서 claude를 못 찾는 이유

확장을 설치했으니 터미널에서도 claude가 될 거라고 생각하기 쉽습니다. 하지만 그렇지 않습니다. 확장은 채팅 패널에서 쓰려고 CLI의 비공개 사본을 자체적으로 들고 있습니다. 그런데 이 사본을 셸의 PATH(셸이 명령을 찾는 디렉터리 목록)에 등록하지 않습니다. 그래서 확장만 설치한 상태로 Bash 터미널에 claude를 입력하면 셸이 명령을 찾지 못합니다.

bash: claude: command not found

해결 방법은 하나입니다. 독립형 CLI를 따로 설치하세요. 운영체제별 설치 명령은 아래 Windows 절과 VPS 절에 있습니다. 설치한 뒤에도 명령을 찾지 못하면 Claude Code 설치 문제 해결 문서의 Fix your PATH 항목을 따르세요.

CLI에서만 되는 기능은 무엇인가요?

확장 문서의 비교표가 CLI 쪽에만 있다고 밝히는 기능은 다음과 같습니다.

• 모든 명령과 스킬. 패널은 그중 일부만 지원합니다. 패널 입력창에 /를 입력하면 쓸 수 있는 목록이 나옵니다.
• !로 시작하는 Bash 단축 입력.
• 탭 자동 완성.
• 스크립트 실행과 Agent SDK. 플랫폼 문서가 이 둘을 CLI 전용이라고 적고 있습니다.

반대로 MCP(Model Context Protocol, 외부 도구를 연결하는 규약) 서버 설정과 체크포인트는 양쪽 모두에서 됩니다. 패널에서는 /mcp로 MCP 서버를 관리합니다. 그러니 MCP가 필요하다는 이유만으로 CLI로 옮길 필요는 없습니다.

패널과 CLI는 대화 기록을 공유합니다

확장과 CLI는 같은 대화 기록을 씁니다. 패널에서 시작한 대화를 터미널에서 이어 가려면 터미널에서 claude --resume을 실행하세요. 둘 중 하나만 고를 필요가 없다는 뜻입니다. 계획은 패널에서 검토하고, 탭 완성이 필요한 작업은 터미널에서 이어 가는 식으로 섞어 써도 됩니다. 세션을 이어 가고 기록을 정리하는 방법은 Claude Code 세션 이어 가기와 기록 관리에 정리되어 있습니다.

패널 대신 터미널만 쓰고 싶다면

확장 설정에는 Use Terminal(useTerminal) 항목이 있습니다. 기본값은 꺼짐(false)입니다. 이 항목을 켜면 Claude Code가 그래픽 패널 대신 터미널 모드로 실행됩니다.

확장을 아예 지우고 싶다면 알아 둘 점이 있습니다. VS Code 통합 터미널에서 claude를 실행하면 Claude Code가 확장을 자동으로 다시 설치합니다. 이를 막으려면 다음 방법 중 하나를 쓰세요.

• CLI에서 /config를 열고 Auto-install IDE extension을 끕니다.
• 설정에서 autoInstallIdeExtension을 false로 둡니다.
• 환경 변수 CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL을 1로 설정합니다.

환경 변수를 쓴다면 셸 설정 파일(Bash라면 ~/.bashrc)에 아래 줄을 넣으세요. 그러면 새로 여는 터미널에도 적용됩니다.

export CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL=1

Windows와 Cursor에서 Claude Code CLI 설치하기

Windows: 네이티브 설치와 WSL

Claude Code는 Windows 10 1809 이상과 Windows Server 2019 이상에서 네이티브로 동작합니다. VS Code 통합 터미널을 PowerShell로 열고 다음 명령을 실행합니다.

irm https://claude.ai/install.ps1 | iex

WinGet을 쓴다면 이렇게 설치할 수도 있습니다.

winget install Anthropic.ClaudeCode

설치가 끝나면 터미널을 새로 열고 claude --version을 실행하세요. 버전 번호가 출력되면 PATH까지 제대로 잡힌 것입니다.

설치 방법에 따라 업데이트 방식이 다릅니다. 설치 스크립트로 설치한 네이티브 버전은 백그라운드에서 자동으로 업데이트됩니다. WinGet, Homebrew, Linux 패키지 관리자로 설치했다면 자동으로 업데이트되지 않습니다. 이 경우 직접 업데이트해야 합니다.

네이티브 Windows에서는 Git for Windows 설치가 권장됩니다. Claude Code는 Git for Windows가 있어야 Bash 도구를 씁니다. 설치하지 않으면 셸 도구로 PowerShell을 대신 씁니다. 필수는 아니지만, 프로젝트 스크립트가 Bash 기준으로 작성되어 있다면 설치해 두는 편이 낫습니다.

샌드박스(sandboxing, 명령이 접근할 수 있는 범위를 제한하는 기능)는 네이티브 Windows에서 지원되지 않습니다. WSL 2에서는 지원됩니다. 샌드박스가 필요하다면 WSL 2에 설치하세요. WSL 환경에서는 Git for Windows가 필요하지 않습니다.

Cursor와 다른 VS Code 계열 편집기

Cursor도 지원됩니다. 문서는 Cursor용 설치 링크(cursor:extension/anthropic.claude-code)를 따로 제공합니다. Devin Desktop이나 Kiro 같은 다른 VS Code 포크에서는 확장 보기에서 "Claude Code"를 검색하거나 Open VSX 레지스트리에서 설치합니다. 편집기에 확장을 설치할 수 없다면 CLI를 설치하고 그 편집기의 통합 터미널에서 claude를 실행하세요. CLI는 어느 터미널에서나 동작합니다. 저희는 Cursor에서 확장을 직접 테스트하지는 않았습니다.

통합 터미널에서 한글이 네모나 깨진 글자로 보일 때

VS Code 통합 터미널에서 Claude Code를 실행하면 한글이 네모 상자로 나오거나, 글자가 번진 것처럼 보이거나, 엉뚱한 글자로 바뀌어 보일 수 있습니다. 문서는 VS Code, Cursor, Devin Desktop의 통합 터미널에서 글자가 이렇게 깨지면 터미널의 GPU 렌더러가 원인일 가능성이 높다고 설명합니다. GPU 렌더러는 터미널 글자를 그래픽 카드로 그리는 기능입니다. 문서가 한글을 콕 집어 말하지는 않습니다. 다만 증상이 같다면 같은 해결책을 먼저 시도해 볼 만합니다.

가장 간단한 해결 방법은 Claude Code 안에서 다음 명령을 한 번 실행하는 것입니다.

/terminal-setup

VS Code 계열 편집기에서 /terminal-setup은 terminal.integrated.gpuAcceleration을 "off"로 바꿉니다. 그러면 터미널이 GPU 렌더러를 쓰지 않습니다. 같은 명령이 Shift+Enter 키 바인딩도 추가합니다. 전체 화면 모드의 스크롤을 위해 terminal.integrated.mouseWheelScrollSensitivity도 설정합니다.

직접 바꾸고 싶다면 편집기의 settings.json에 다음 값을 넣으세요.

{
  "terminal.integrated.gpuAcceleration": "off"
}

저장한 뒤 창을 다시 로드하세요. 명령 팔레트의 Developer: Reload Window가 이 일을 합니다. 원래대로 되돌리려면 값을 "auto"로 바꾸고 다시 로드하면 됩니다.

주의할 점이 하나 있습니다. /terminal-setup은 tmux나 screen 안에서 실행하면 안 됩니다. 호스트 터미널의 설정에 값을 써야 하기 때문입니다. 서버의 tmux 세션 안에서 작업하는 중이라면 tmux 밖에서 한 번 실행하거나 위 설정을 직접 바꾸세요.

/terminal-setup을 실행하기 전에도 여러 줄 입력은 할 수 있습니다. Ctrl+J를 누르거나, 줄 끝에 \를 입력하고 Enter를 누르면 줄이 바뀝니다. VS Code와 Cursor에서 Shift+Enter로 줄을 바꾸려면 /terminal-setup을 한 번 실행해야 합니다.

패널 입력창의 한글 IME 조합은 괜찮은가요?

패널 입력창에서 IME(input method editor, 입력기)로 한글을 조합해 입력할 때 문제가 없는지는 저희가 확인하지 못했습니다. 저희 테스트 환경에는 VS Code GUI와 한국어 IME가 없었습니다. 확장 문서에도 한글이나 IME 조합에 관한 언급이 없습니다. 그래서 된다고도, 안 된다고도 말하지 않겠습니다. 문제가 보이면 확장 보기에 표시되는 확장 버전과 재현 순서를 기록해 Claude Code GitHub 이슈에 보고하세요.

Remote-SSH로 VPS의 코드를 다룰 때

Claude Code 패널은 Remote-SSH에서 동작하나요?

문서만으로는 알 수 없습니다. VS Code 확장 문서 페이지에는 Remote-SSH나 원격 개발을 다루는 절이 없습니다. 개발 컨테이너(dev container)는 다루지만 SSH 원격 접속은 다루지 않습니다.

GitHub 이슈 기록도 답을 주지 않습니다.

• #72448 "Hope Claude Code for VSCode supports remote SSH"는 2026-06-30에 열렸고 2026-08-20에 not planned(계획 없음)로 닫혔습니다. 닫은 이유를 설명하는 관리자 댓글은 보이지 않았습니다.
• #37919는 확장 2.1.81 버전에서 보고된 버그입니다. 원격 서버의 CPU가 AVX 명령어를 지원하지 않아 확장이 서버에서 멈췄습니다. 확장을 로컬에서 실행하도록 강제하자 사이드바가 빈 화면으로 나왔습니다. 이 이슈는 2026-06-04에 not planned로 닫혔습니다.

두 번째 이슈는 특수한 CPU 환경에서 생긴 문제입니다. Remote-SSH에서 패널이 전반적으로 안 된다는 증거로 읽으면 안 됩니다. 첫 번째 이슈도 기능 요청이 닫혔다는 기록일 뿐입니다. 지금 확장이 어떻게 동작하는지는 말해 주지 않습니다.

저희는 Remote-SSH 환경에서 패널을 직접 테스트하지 않았습니다. 직접 시도해 본다면 확장 보기에 표시되는 확장 버전을 함께 기록하세요. 이 번호는 확장에 들어 있는 Claude Code 버전과 같습니다. 동작 여부는 버전에 따라 달라질 수 있으므로, 버전 없이 남긴 "된다"나 "안 된다"는 다른 사람에게 쓸모가 적습니다.

문서로 뒷받침되는 경로: 서버에 CLI 설치하기

Claude Code 플랫폼 문서는 CLI를 터미널 작업, 스크립트, 원격 서버에 맞는 도구로 소개합니다. Remote-SSH 창에서 통합 터미널을 열면 그 셸은 서버에서 실행됩니다. 여기에 독립형 CLI를 설치하면 Claude Code가 코드와 같은 서버에서 돌아갑니다. 파일을 읽고 테스트를 실행하는 일이 모두 그 서버에서 일어납니다.

Linux 서버 요구 사항은 다음과 같습니다.

• 운영체제: Ubuntu 20.04 이상, Debian 10 이상, Alpine 3.19 이상
• 메모리: 4 GB 이상
• CPU 아키텍처: x64 또는 ARM64
• 인터넷 연결

메모리가 4 GB보다 작은 VPS라면 설치 전에 플랜을 먼저 확인하세요. Remote-SSH 터미널에서 다음 명령을 실행합니다.

curl -fsSL https://claude.ai/install.sh | bash
claude --version

claude --version이 버전 번호를 출력하면 설치된 것입니다. command not found가 나오면 설치된 실행 파일의 위치가 PATH에 없다는 뜻입니다. 앞에서 말한 설치 문제 해결 문서의 Fix your PATH 항목을 따르세요. 설치 문서에는 apt, dnf, apk 저장소와 npm(Node.js 22 이상 필요)으로 설치하는 방법도 있습니다. 다만 apt, dnf, apk 같은 패키지 관리자로 설치하면 자동 업데이트가 되지 않습니다.

SSH 세션에서 처음 로그인하기

서버에서 claude를 처음 실행하면 로그인 절차가 시작됩니다. 서버에는 보통 브라우저가 없으므로 브라우저가 자동으로 열리지 않을 수 있습니다. 그럴 때는 c를 눌러 로그인 URL을 클립보드에 복사한 뒤 내 PC의 브라우저에 붙여 넣으세요. 복사한 URL이 내 PC 클립보드까지 오지 않는다면 아래 클립보드 절을 보세요.

브라우저에서 로그인을 마치면 Claude Code로 자동으로 돌아가는 대신 로그인 코드가 화면에 나올 수 있습니다. 브라우저가 Claude Code의 로컬 콜백 서버에 접근하지 못하면 이렇게 됩니다. 문서는 이 상황이 SSH 세션에서 흔하다고 설명합니다. 브라우저의 코드를 복사해 터미널의 다음 프롬프트에 붙여 넣으면 로그인이 끝납니다.

Paste code here if prompted

Linux에서 로그인 정보는 ~/.claude/.credentials.json에 권한 0600으로 저장됩니다. 즉 파일 소유자만 읽고 쓸 수 있습니다. 홈 디렉터리를 백업하거나 다른 서버로 복사할 때 이 파일도 함께 옮겨진다는 점을 기억하세요.

연결이 끊겨도 작업을 이어 가려면

노트북을 덮거나 네트워크가 바뀌면 SSH 연결이 끊깁니다. 긴 작업을 맡겼다면 연결 상태와 상관없이 서버에서 계속 돌아가야 합니다. 이럴 때는 tmux(터미널 세션을 서버에 유지해 주는 도구) 안에서 claude를 실행하세요. 다시 접속한 뒤 같은 세션에 붙으면 작업이 그대로 남아 있습니다. 설정 방법은 VPS에서 tmux로 Claude Code 세션 유지하기에 단계별로 정리되어 있습니다. 앞에서 말했듯 /terminal-setup은 tmux 밖에서 실행해야 합니다.

서버에서 복사한 텍스트가 내 PC에 붙여지지 않을 때

SSH를 거쳐 Claude Code에서 텍스트를 복사하면 OSC 52라는 터미널 제어 시퀀스로 내 PC 클립보드에 전달됩니다. 일부 터미널은 이 시퀀스를 처리하지 않습니다. 그런데 /copy는 텍스트가 실제로 도착했는지와 상관없이 Copied to clipboard라고 표시합니다. tmux 밖에서는 선택 안내 문구가 sent N chars via OSC 52로 나옵니다. 이 문구가 보이는데 붙여 넣기가 안 된다면, Claude Code는 시퀀스를 보냈지만 터미널이 그것을 클립보드로 옮기지 않은 것입니다. VS Code 터미널이 OSC 52를 처리하는지는 저희가 확인하지 못했습니다.

신뢰할 수 없는 저장소는 Restricted Mode로 여세요

남이 만든 저장소를 클론해서 열 때는 한 가지를 더 생각해야 합니다. 문서에 따르면 자동 수정 권한이 켜져 있을 때 Claude Code는 settings.json이나 tasks.json 같은 VS Code 설정 파일도 고칠 수 있습니다. 문제는 VS Code가 이런 파일을 자동으로 실행할 수 있다는 점입니다. 그래서 수정된 내용이 사람의 검토 없이 실행될 수 있습니다.

문서는 신뢰할 수 없는 코드를 다룰 때 다음을 권합니다.

• 신뢰할 수 없는 작업 공간은 VS Code Restricted Mode로 엽니다.
• Edit automatically나 Auto 대신 Manual 모드로 수정을 받습니다.
• 수정 사항을 수락하기 전에 꼼꼼히 검토합니다.

VS Code 문서에 따르면 Restricted Mode는 자동 코드 실행을 막으려는 모드입니다. 작업(tasks)과 디버깅을 제한하고, .vscode 폴더의 작업 공간 설정을 제한합니다. Workspace Trust를 지원하지 않는 확장도 기본으로 꺼집니다.

여기서 하나를 기억하세요. Claude Code 확장은 Restricted Mode에서 동작하지 않습니다. 그러니 순서가 중요합니다. 먼저 Restricted Mode로 열어 저장소를 읽어 보세요. 특히 .vscode 폴더에 무엇이 들어 있는지 확인하세요. 내용을 믿을 수 있다고 판단한 뒤에 작업 공간을 신뢰하고, Manual 모드로 Claude Code를 시작하면 됩니다.

패널과 터미널, 무엇을 골라야 하나요?

• 내 PC의 프로젝트에서 수정 비교를 눈으로 확인하고 싶다면 패널을 쓰세요. Plan 모드의 계획 문서에 의견을 다는 기능도 패널에서 씁니다.
• 모든 명령과 스킬, ! Bash 단축 입력, 탭 완성, 스크립트 실행이 필요하다면 터미널의 CLI를 쓰세요.
• 코드가 VPS에 있고 Remote-SSH로 연다면 서버에 CLI를 설치하고 Remote-SSH 터미널에서 실행하세요. 연결이 끊겨도 이어 가야 한다면 tmux 안에서 실행하세요.
• 한쪽만 고를 필요는 없습니다. 패널과 CLI는 대화 기록을 공유하므로 claude --resume으로 오가며 쓸 수 있습니다.

FAQ

VS Code에 Claude Code 확장을 설치했는데 터미널에서 claude 명령을 찾을 수 없다고 나옵니다. 왜 그런가요?

확장은 채팅 패널에서 쓰는 CLI의 비공개 사본을 자체적으로 들고 있지만, 그 사본을 셸의 PATH에 등록하지 않습니다. 그래서 확장만 설치하면 터미널에서 claude를 찾지 못합니다. Linux와 macOS에서는 curl -fsSL https://claude.ai/install.sh | bash로, Windows PowerShell에서는 irm https://claude.ai/install.ps1 | iex로 독립형 CLI를 따로 설치하세요. 그다음 새 터미널에서 claude --version으로 확인합니다.

무료 Claude 계정으로 VS Code에서 Claude Code를 쓸 수 있나요?

쓸 수 없습니다. Claude Code는 claude.ai 무료 요금제에 포함되지 않습니다. Pro, Max, Team, Enterprise 구독이나 Console 계정이 필요합니다. Bedrock 같은 서드파티 제공자를 통해 쓰는 방법도 있습니다. 유료 구독이나 Console 계정으로 로그인하면 VS Code 확장에 API 키를 따로 넣을 필요가 없습니다.

VS Code 터미널에서 Claude Code를 실행하면 한글이 네모나 깨진 글자로 나옵니다. 어떻게 고치나요?

문서는 VS Code 계열 편집기의 통합 터미널에서 글자가 상자나 번진 모양으로 깨지면 GPU 렌더러를 원인으로 봅니다. Claude Code 안에서 /terminal-setup을 실행하면 terminal.integrated.gpuAcceleration이 "off"로 바뀝니다. 직접 settings.json에서 이 값을 "off"로 바꾸고 창을 다시 로드해도 됩니다. /terminal-setup은 tmux 밖의 호스트 터미널에서 실행하세요. 되돌리려면 값을 "auto"로 바꿉니다.

Remote-SSH로 연 VPS에서 Claude Code 패널을 쓸 수 있나요?

공식 VS Code 확장 문서는 Remote-SSH에서의 패널 동작을 다루지 않습니다. 관련 GitHub 이슈 #72448과 #37919는 모두 not planned로 닫혔고, 저희는 직접 테스트하지 않았습니다. 문서로 뒷받침되는 방법은 서버에 독립형 CLI를 설치하고 Remote-SSH 터미널에서 claude를 실행하는 것입니다. 연결이 끊겨도 작업이 이어져야 한다면 tmux 안에서 실행하세요.

체크포인트로 되감으면 모든 변경이 되돌아가나요?

아닙니다. Claude가 rm, mv, cp 같은 Bash 명령으로 바꾼 파일은 체크포인트가 추적하지 않으므로 되감을 수 없습니다. 세션 밖에서 직접 고친 내용도 추적하지 않습니다. 체크포인트는 세션 안에서 빠르게 복구하기 위한 기능입니다. 오래 남겨야 하는 기록은 git 커밋으로 관리하세요.