Claude Code가 VS Code에서 안 될 때는 VS Code를 다시 설치하거나 확장을 내리거나 API key를 바꾸기 전에 실패 지점을 먼저 나눠야 합니다. 문제는 공식 확장 UI, 통합 terminal, 로그인 또는 상태, Windows shell, provider 설정, VS Code 충돌, 아니면 다른 VS Code assistant 중 하나에서 발생합니다.
| 보이는 증상 | 먼저 확인할 소유 지점 | 첫 확인 | 검증 또는 중단 기준 |
|---|---|---|---|
| Spark icon, panel, command가 없다 | 공식 Claude Code 확장 UI | 파일을 열고 Status Bar와 Command Palette를 확인한 뒤 Developer: Reload Window 를 실행한다. | 같은 VS Code 창에서 Claude Code command나 panel이 보인다. |
통합 terminal에서 claude가 없다 | CLI, PATH, 설치 route | claude --version 을 실행하고, claude가 보이는 shell에서 VS Code를 다시 연다. | VS Code terminal에서 claude doctor 가 통과한다. |
| login loop, 무응답, 장애처럼 보이는 동작 | session과 service status | 가능하면 /status 를 실행하고 Claude Status를 확인한다. UI가 열린 뒤에만 logout/login 한다. | active incident면 local 변경을 멈추고 회복 뒤 같은 경로를 다시 시도한다. |
| Windows, Git Bash, WSL, PowerShell 결과가 다르다 | shell과 launch context | 외부 shell과 VS Code terminal의 claude --version 을 비교한다. | 양쪽이 같은 claude path를 본다. |
| API key, Bedrock, Vertex, Foundry, gateway가 관련된다 | provider mode | ANTHROPIC_API_KEY 와 provider config를 먼저 확인한다. | VS Code가 의도한 provider route를 물려받는다. |
| 다른 extensions, workspace trust, Restricted Mode가 의심된다 | VS Code environment | extensions를 끄고 Troubleshoot Issue와 Extension Bisect를 사용한다. | conflict 또는 Restricted Mode 경계가 분리된다. |
| Continue, Cline, Roo Code, Copilot Chat이 실패한다 | third-party VS Code assistant | Claude Code 분기에서 나와 그 tool의 model/provider 설정을 본다. | 공식 Claude Code 문서가 다음 수정을 소유하지 않는다. |
첫 분기가 실패해도 evidence를 좁게 유지하세요. Claude Code version, VS Code version, OS, install method, command output, Claude Status timestamp, provider route, relevant logs가 필요합니다. 이 packet은 “여러 번 다시 설치했다”보다 훨씬 actionable 합니다.
공식 확장 UI부터 확인한다
Spark icon, sidebar panel, Claude Code command가 보이지 않으면 VS Code UI 분기에 머물러야 합니다. Anthropic의 공식 VS Code 문서는 VS Code 1.98.0 이상을 요구하고, Marketplace나 Extensions view 설치를 설명하며, 설치 뒤 보이지 않으면 Developer: Reload Window 를 실행하라고 합니다. 이 확인은 editor 재설치보다 싸고 evidence를 보존합니다.
입구는 세 개입니다. 먼저 실제 파일을 엽니다. editor 오른쪽 위 Spark icon은 파일이 열려야 보일 수 있습니다. 다음으로 Status Bar를 확인합니다. 파일이 없어도 작동할 수 있습니다. 마지막으로 Command Palette에서 Claude Code를 검색해 새 탭, logs, terminal 관련 command가 보이는지 확인합니다.
아무것도 보이지 않으면 window를 reload합니다. reload 뒤 panel 또는 command가 보이면 UI 분기는 회복입니다. panel이 보이지만 login이 실패하면 auth/status 분기로 이동합니다. 다른 extensions를 끌 때만 보이면 conflict 분기입니다. 여전히 보이지 않으면 VS Code version, extension version, install source, logs를 남깁니다.
rollback은 첫 UI fix가 아닙니다. community에는 command 'claude-vscode.editor.openLast' not found, sidebar loading failure, Windows에서 CLI는 되지만 extension은 안 되는 report가 있습니다. 그러나 exact symptom, version, platform context가 맞을 때만 evidence로 써야 합니다.
통합 terminal에서 CLI와 PATH를 증명한다
통합 terminal은 extension UI 문제와 binary 문제를 빠르게 나눕니다. VS Code terminal에서 실행합니다.
bashclaude --version
여기서 command not found가 나오면 extension settings를 바꾸지 마세요. 소유 지점은 CLI, PATH, shell, install route입니다. 먼저 외부 shell에서 같은 command가 되는지 확인합니다. 외부 shell은 되는데 VS Code terminal은 안 되면 launch context 또는 shell profile inheritance가 원인입니다.
claude --version 이 되면 diagnostics를 실행합니다. Claude Code 안에서는 /doctor, shell에서는 claude doctor 를 사용합니다. 중요한 것은 doctor를 실행했다는 사실이 아니라 같은 실패 지점에서 doctor가 통과하거나, doctor가 install, login, permission 문제를 정확히 가리키는 것입니다.
binary가 없다면 Claude Code 설치 가이드로 이동합니다. 이 복구 경로의 목적은 설치 설명을 반복하는 것이 아니라 실패 지점을 분류하는 것입니다.
Windows에서는 PowerShell, Git Bash, WSL을 분리한다
Windows 문제는 VS Code 안에 보이기 때문에 extension failure처럼 보입니다. 하지만 소유 지점은 PowerShell, Git for Windows, Git Bash, WSL, PATH, 또는 VS Code를 어디서 시작했는지일 수 있습니다. 그래서 claude --version 을 여러 곳에서 비교해야 합니다.
외부 PowerShell에서 claude --version 을 실행하고, VS Code integrated terminal에서 같은 command를 실행합니다. Git Bash를 쓰면 Git Bash에서도, WSL을 쓰면 WSL에서도 확인합니다. PowerShell만 되면 Git Bash route를 고칩니다. WSL만 되면 Windows side terminal을 고칩니다. 어디에서도 안 되면 install 또는 PATH로 돌아갑니다.
안전한 순서는 이렇습니다. 목표 shell이 설치되어 있는지 확인합니다. claude 가 보이는 shell에서 VS Code를 시작합니다. integrated terminal이 같은 path를 보는지 확인합니다. claude doctor 를 실행합니다. 그 다음에 extension UI로 돌아갑니다. 이렇게 해야 성공했을 때 이유가 남습니다.
provider variables도 launch context의 영향을 받습니다. ANTHROPIC_API_KEY, Bedrock, Vertex, Foundry, gateway variables가 특정 shell에만 있으면 VS Code가 물려받지 않을 수 있습니다. binary를 먼저 증명하고, route를 나중에 증명합니다.
login, Claude Status, provider mode를 분리한다
login loop나 무응답은 missing UI나 missing CLI와 같은 첫 행동을 쓰지 않습니다. Claude Code surface가 command를 받을 수 있으면 /status 를 실행하고 Claude Status를 확인합니다. 2026년 4월 29일 확인 시점에는 Claude Status가 Claude Code를 포함해 operational이었지만, 4월 28-29일 근처에는 availability, errors, API behavior, login path incident가 있었습니다. status는 timestamp가 있는 branch signal이지 local health proof가 아닙니다.
관련 incident가 active라면 local churn을 멈춥니다. service 또는 login incident 중에 reinstall, downgrade, credential rotation, random extension disable을 하지 마세요. timestamp를 남기고 회복 뒤 같은 intended path를 다시 실행합니다. status가 green인데 같은 path가 계속 실패하면 local UI, CLI, session, provider, VS Code state를 다시 봅니다.
provider mode는 별도 분기입니다. ANTHROPIC_API_KEY, Bedrock, Vertex, Foundry, compatible gateway가 관련되면 credential precedence나 environment inheritance가 소유 지점일 수 있습니다. variables, settings, provider selection은 Claude Code API configuration guide를 사용합니다. 계정 또는 meter 소유가 문제라면 API key vs subscription billing guide로 이동합니다.
좁은 확인은 이렇게 합니다. /status 를 확인합니다. intended auth 또는 provider owner를 확인합니다. 해당 환경을 가진 shell에서 VS Code를 다시 시작합니다. 같은 task를 다시 실행합니다. 고쳐지면 route mismatch입니다. 아니면 route evidence를 모읍니다.
VS Code 충돌과 Restricted Mode를 격리한다
Claude Code install과 CLI가 정상이어도 VS Code가 실패를 소유할 수 있습니다. extension conflicts, special profiles, workspace trust, Restricted Mode는 모두 extension path를 바꿀 수 있습니다. 공식 문서는 Restricted Mode를 언급하고, VS Code에는 Troubleshoot Issue와 Extension Bisect가 있습니다.
먼저 되돌릴 수 있는 격리를 합니다.
bashcode --disable-extensions
다른 extensions를 껐을 때 Claude Code가 작동하면 official extension이 첫 의심 대상이 아닙니다. Command Palette에서 Disable All Installed Extensions 또는 Help: Troubleshoot Issue를 사용하고, Extension Bisect로 conflict를 찾습니다. 수동으로 extension을 절반씩 지우지 않아도 됩니다.
workspace trust는 다른 경계입니다. restricted workspace에서는 extension이 필요한 capability를 얻지 못할 수 있습니다. repository와 local policy를 이해할 때만 workspace를 trust합니다. 검증은 같습니다. trust 또는 conflict 변경 뒤 같은 workspace에서 command, panel, terminal route가 작동하는지 봅니다.
version regression은 좁은 evidence로만 쓴다
version-specific breakage는 실제로 있습니다. 하지만 모든 사람에게 적용되는 first fix는 아닙니다. 공개 report에는 command registration error, sidebar loading failure, Windows-specific issue가 있습니다. 이것들은 symptom language와 version clue로만 유용합니다.
regression branch는 세 가지가 맞을 때만 켭니다. exact command 또는 panel symptom, extension 또는 Claude Code version range, platform과 shell context입니다. 맞으면 logs, version, VS Code version, OS, exact command error를 저장하고 current release에서 수정되었는지 확인합니다.
temporary rollback은 controlled local workaround입니다. default answer가 아닙니다. exact error가 API Error: 500 이면 Claude Code API error 500 guide로 이동합니다. overloaded 또는 529 면 Claude Code overloaded error guide입니다. quota나 usage limit이면 Claude Code usage limits guide를 봅니다.
다른 assistant가 소유하면 Claude Code 분기를 떠난다
넓은 “Claude가 VS Code에서 안 된다”는 말에는 owner mistake가 섞일 수 있습니다. 실패한 panel이 Continue, Cline, Roo Code, Copilot Chat일 수 있습니다. 이런 tools는 자체 provider settings로 Claude models를 사용할 수 있지만, UI failure, model dropdown, API key field, base URL error는 Claude Code docs로 고칠 수 없습니다.
exit rule은 단순합니다. panel, command, settings surface가 다른 extension이라면 Claude Code-specific command를 멈춥니다. 그 extension의 model provider, key, base URL, workspace permissions, logs를 확인합니다. tool이 Anthropic API를 직접 부른다면 failure owner는 app provider config 또는 Anthropic API status일 수 있습니다.
이 구분은 destructive fix를 막습니다. official Claude Code extension을 지워도 Continue provider setting은 고쳐지지 않습니다. API key를 바꿔도 Spark icon은 나타나지 않습니다. owner를 먼저 맞춰야 복구가 빠릅니다.
검증하고 escalation packet을 만든다
좋은 검증은 branch-specific change 하나 뒤에 같은 intended surface를 반복합니다. 나쁜 검증은 version, shell, auth, provider, workspace, task shape를 한 번에 바꿉니다.
같은 branch가 계속 실패하면 아래를 모읍니다.
- Claude Code version과 extension version
- VS Code version
- OS와 shell. PowerShell, Git Bash, WSL, launch context 포함
- install method와 VS Code terminal 안의
claude --version결과 /status,claude doctor,/doctoroutput. secrets 제거- Claude Status timestamp와 active incident 여부
- provider route. subscription login,
ANTHROPIC_API_KEY, Bedrock, Vertex, Foundry, gateway - Claude Code logs와 exact command 또는 panel error
중단 기준도 분명합니다. service incident면 기다립니다. terminal이 binary를 보지 못하면 install 또는 PATH를 고칩니다. provider route가 소유하면 credential precedence를 고칩니다. 다른 assistant가 UI를 소유하면 Claude Code path를 떠납니다. 그래도 official extension이 실패하면 packet으로 escalation합니다.
자주 묻는 질문
Claude Code가 VS Code에 표시되지 않는 이유는?
official extension UI부터 시작합니다. 파일을 열고 Status Bar와 Command Palette를 확인한 뒤 Developer: Reload Window 를 실행합니다. 계속 없으면 VS Code 1.98.0 이상, Claude Code logs, Restricted Mode, extension conflict를 확인합니다.
외부 terminal에서는 되는데 VS Code terminal에서 claude 가 없는 이유는?
VS Code가 다른 shell context에서 시작되었거나 같은 PATH를 물려받지 않았을 가능성이 큽니다. claude --version 이 되는 shell에서 VS Code를 열고 integrated terminal에서 다시 실행합니다. Windows에서는 PowerShell, Git Bash, WSL, Git for Windows를 따로 비교합니다.
VS Code를 다시 설치해야 하나요?
보통은 아닙니다. reload, Command Palette, Status Bar, claude --version, doctor diagnostics, extension isolation을 먼저 하세요. 너무 이른 reinstall은 evidence를 지우고 실제 owner를 건드리지 못할 수 있습니다.
Claude Status가 정상이어도 extension이 실패할 수 있나요?
가능합니다. status는 그 순간 service incident branch를 볼 뿐입니다. local VS Code extension, shell PATH, provider environment, workspace trust, 다른 assistant settings의 건강을 증명하지 않습니다.
VS Code의 Claude Code에는 API key가 필요한가요?
일반 subscription-login route에서는 반드시 필요하지 않습니다. API key는 provider mode, direct Anthropic API, Bedrock, Vertex, Foundry, compatible gateway에서 중요합니다. ANTHROPIC_API_KEY 가 있으면 active route를 먼저 확인하세요.
extension rollback은 언제 시도하나요?
exact command/panel error, platform, version range가 known regression과 맞을 때만 시도합니다. reload, logs, CLI proof, status, extension isolation 뒤에 하고, rollback을 temporary workaround로 기록하세요.