Claude Code IDE for Sublime Text

English | 日本語

Sublime Text 4를 위한 네이티브 Claude Code IDE 통합 — 에디터 내 diff 리뷰(수락/거절), 실시간 선택 영역 공유, @-멘션 기능을 제공하며, 공식 VS Code 및 JetBrains 확장과 동일한 WebSocket/MCP 프로토콜을 사용합니다.

비공식 커뮤니티 플러그인 — Anthropic과 제휴하거나 보증하지 않습니다. "Claude" 및 "Claude Code"는 Anthropic, PBC의 상표입니다.

상태: 핵심 기능 작동 중 — 서버 + 컨텍스트 공유(M1), 에디터 내 diff 리뷰(M2), 병렬 멀티 세션 지원이 구현되어 실제 Claude Code 클라이언트와 종단 간 테스트를 완료했습니다. Package Control 제출 진행 중; 아래 수동 설치는 지금도 작동합니다.

동기 — LLM 시대에 Sublime Text를 선택하는 이유?

이제 에이전트가 코드의 대부분을 작성한다면, 에디터는 어떤 역할을 해야 할까요? 저희의 답변:

• 즉각적이고 가볍게. Sublime은 눈 깜짝할 사이에 열리며, 에이전트 세션, 터미널, 브라우저가 나머지 RAM을 소모하는 동안에도 약 100~300MB를 유지합니다. 에디터는 코드를 읽고 판단하는 곳입니다; 절대 스택에서 무거운 부분이 되어서는 안 됩니다.

• 사용자가 직접 쉽게 확장 가능. LLM 우선 워크플로우에서 에디터는 개인 인프라입니다: Claude가 몇 분 만에 Sublime 플러그인을 작성할 수 있다면, 스크립트 가능한 Python API가 미리 구축된 기능의 마켓플레이스보다 낫습니다. 원하는 조종석을 정확히 구성할 수 있습니다 — 이 플러그인 자체가 그 증거입니다.

• 선택적으로 AI를 번들링하지 않음. AI 네이티브 IDE(Cursor, Windsurf, …)와 VS Code는 에이전트를 에디터에 결합합니다 — 자체 구독, 모델 마크업, 업그레이드 주기를 가지고 있습니다. Claude Code는 에디터에 구애받지 않습니다; 빠진 것은 Sublime이 Claude Code와 대화할 수 있게 해주는 얇은 프로토콜 레이어뿐이었습니다. 이 플러그인이 그 레이어를 추가하여, 에디터는 빠르고 사용자의 것이 유지되며, 에이전트는 일류로 유지됩니다.

더 긴 논증 — 에디터가 아니라 결합이 선택해야 할 것: 에디터를 바꾸지 말고, 에이전트를 연결하세요

Related MCP server: Claude Code MCP Server

기능

Claude Code가 연결되면(/ide 또는 자동 연결을 통해), 플러그인은 다음을 제공합니다:

• 에디터 내 diff 리뷰 — Claude의 제안된 편집이 나란히 diff로 열립니다; 수락, 거절, 또는 수락 전에 직접 편집 가능 (M2)

• 컨텍스트 공유 — 현재 선택 영역, 열린 탭, 워크스페이스 폴더, 더티 상태

• selection_changed 스트리밍 — Claude가 항상 사용자가 보고 있는 것을 인지

• @-멘션 — 현재 선택 영역 범위를 프롬프트로 전송

• Show-me CLI — scripts/open_file.py <path>가 터미널이나 에이전트 자체에서 모든 파일을 사이드 창에 표시 — "Claude, 네가 만든 것을 보여줘"를 위한 채널 (FAQ 참조)

• 잠금 파일 발견 — Sublime 내부의 Terminus 또는 외부 터미널에서 작동

설치 (개발 중 수동 설치)

1. 이 저장소를 아무 곳에나 클론합니다.

2. Sublime의 Packages에 Claude Code IDE로 링크합니다(모든 폴더 이름이 작동합니다 — 임포트는 상대적입니다 — 하지만 Package Control 설치와 일치하므로 Preferences 메뉴 항목이 해결됩니다):

   • Windows: mklink /J "%APPDATA%\Sublime Text\Packages\Claude Code IDE" "C:\path\to\repo"

   • macOS/Linux: ln -s /path/to/repo "~/Library/Application Support/Sublime Text/Packages/Claude Code IDE"

3. Sublime Text를 재시작합니다. 서버가 수신 중일 때 상태 표시줄에 Claude ○ :<port>가 표시됩니다.

4. 모든 터미널에서 claude를 실행한 다음, /ide를 입력하고 Sublime Text를 선택합니다.

개발

프로토콜 코어(claudeide/)는 순수 Python 3.8이며 종속성이 없고 sublime을 절대 임포트하지 않으므로 Sublime 외부에서 단위 테스트가 가능합니다:

uv venv --python 3.8
uv pip install pytest
uv run pytest

Sublime 관련 레이어는 adapters/sublime_bridge.py + plugin_main.py에 있습니다.

프로토콜

Claude Code의 IDE 통합 프로토콜(WebSocket + MCP 2025-03-26)을 구현합니다: ~/.claude/ide/<port>.lock의 잠금 파일, x-claude-code-ide-authorization을 사용하는 localhost 전용 WebSocket, 표준 도구 세트(openFile, openDiff, getCurrentSelection, getOpenEditors, …).

프로토콜 참조: coder/claudecode.nvim PROTOCOL.md — 문서화해준 해당 프로젝트에 큰 감사를 드립니다.

FAQ

Claude Code가 Sublime Text에서 작동하나요?

네 — 이 플러그인과 함께라면 가능합니다. Claude Code에는 내장된 Sublime Text 지원이 없지만(VS Code 및 JetBrains용 공식 확장이 존재), IDE 통합은 문서화된 WebSocket/MCP 프로토콜입니다. 이 플러그인은 Sublime에서 해당 프로토콜을 네이티브로 구현하므로, 에디터 내 diff 리뷰, 선택 컨텍스트, @-멘션과 같은 기능이 공식 확장과 동일하게 작동합니다.

이것은 공식 Anthropic 플러그인인가요?

아니요. 비공식 커뮤니티 플러그인으로, Anthropic과 제휴하거나 보증하지 않습니다. claudecode.nvim 프로젝트가 문서화한 대로 공식 IDE 확장이 사용하는 것과 동일한 프로토콜을 사용합니다.

Claude Code를 Sublime Text에 어떻게 연결하나요?

두 가지 방법:

1. 수동: 모든 터미널에서 claude를 실행하고, /ide를 입력한 다음 Sublime Text를 선택합니다.

2. 자동 연결: 플러그인 설정에서 고정 "port"를 설정하고 시스템 전체에 CLAUDE_CODE_SSE_PORT=<port> 및 ENABLE_IDE_INTEGRATION=true를 내보냅니다. 그러면 모든 새 claude 세션이 Sublime에 자동으로 연결됩니다(실행 후 약 2초), Sublime 내부의 Terminus를 포함한 모든 터미널에서 가능합니다.

Claude가 파일을 편집하면 어떻게 되나요?

제안된 변경 사항이 Sublime에서 나란히 diff 탭으로 열립니다. 제안 창의 ✓/✗ 버튼(명령 팔레트에도 있음; 복사 가능한 키 바인딩이 Example.sublime-keymap에 포함됨)으로 수락하거나 거절하거나, 수락 전에 제안을 직접 편집할 수 있습니다. Claude는 사용자가 결정할 때까지 차단됩니다 — 기본 권한 설정에서는 사용자의 검토 없이 디스크에 아무것도 기록되지 않습니다.

Claude가 결과를 보여주기 위해 파일을 열 수 있나요?

MCP를 통해서는 불가능합니다 — Claude Code는 ide 서버에서 getDiagnostics/executeCode만 모델에 노출하므로, 모델은 연결된 상태에서도 openFile을 직접 호출할 수 없습니다. 번들된 CLI가 지원되는 채널입니다: Claude Code와 동일한 잠금 발견 + 인증된 WebSocket 핸드셰이크를 수행하고 플러그인의 openFile을 직접 호출합니다 — 사이드 그룹 배치 및 --preview(임시 탭, 포커스 도용 없음) 포함. /ide를 실행한 적이 없는 세션에서도 모든 터미널에서 작동합니다:

python scripts/open_file.py path/to/report.html            # show + focus
python scripts/open_file.py path/to/notes.md --preview     # glance, no focus steal

그런 다음 에이전트에게 가르칩니다(예: CLAUDE.md에서): "제가 봐야 할 파일을 생성하면 scripts/open_file.py <path>를 실행하세요" — 결과물이 만들어지는 대로 Sublime에 나타나기 시작합니다.

CLI는 저장소에 있습니다(scripts/는 설치된 패키지에서 제외됨), 따라서 클론된 체크아웃에서 실행하세요 — 위의 수동 설치 설정에는 이미 하나가 있습니다.

내 코드가 어딘가로 전송되나요?

플러그인 자체는 네트워크로 아무것도 전송하지 않습니다. 127.0.0.1(localhost 전용, 토큰 인증)에서 WebSocket 서버를 실행하여 사용자 머신의 Claude Code 프로세스와 통신합니다. Claude Code 자체가 Anthropic으로 보내는 것은 IDE 없이 사용할 때와 정확히 동일하게 Claude Code에 의해 관리됩니다.

여러 Claude Code 세션을 동시에 실행할 수 있나요?

네. 서버는 동시 클라이언트를 허용하므로, 여러 Claude 세션(예: 프로젝트 또는 작업당 하나)이 동일한 Sublime 인스턴스에 병렬로 연결될 수 있습니다; 각 세션의 diff 리뷰는 독립적으로 추적됩니다.

어떤 플랫폼이 지원되나요?

프로토콜 코어는 종속성 없는 Python 3.8입니다(Sublime Text 4 플러그인 호스트). Windows에서 개발 및 종단 간 테스트 완료; macOS와 Linux는 동일한 코드 경로를 사용하며 작동할 것으로 예상됩니다 — 이슈 및 보고서 환영합니다.

AI 네이티브 IDE 대신 Sublime을 유지하는 이유는 무엇인가요?

에이전트가 에디터 내부에 있을 필요가 없기 때문입니다. Claude Code는 터미널에서 실행됩니다; 에디터의 역할은 에이전트가 제안하는 것을 읽고, 판단하고, 때때로 직접 편집하는 것입니다 — Sublime이 즉각적으로 약 100~300MB의 RAM으로 수행하는 작업입니다. 분리는 에이전트와 에디터를 독립적으로 업그레이드할 수 있음을 의미하며, 번들 구독이나 종속이 없습니다. 동기를 참조하세요.

정보

Cognisant LLC에서 개발 및 유지 관리 — 팀이 AI 에이전트를 이미 사용 중인 도구에 연결하는 것을 돕습니다. Cognisant Insights에서 더 많은 글을 볼 수 있으며, 동기 에세이의 일본어 동반 글인 에디터를 바꾸지 말고, 에이전트를 연결하세요도 포함됩니다.

라이선스

MIT