| name | lsp-setup |
| description | Claude Code 의 LSP 툴이 Unity 프로젝트의 `.cs` 를 인식하도록 OmniSharp 를 설치·연결하는 자동 설정 스킬. `No LSP server available for file type: .cs` 응답을 받았거나, 처음 세팅할 때 에이전트가 자동 호출한다. |
Skill: /lsp-setup (LSP 자동 세팅)
프로그래밍을 몰라도 되게 설계됨. 아래 절차는 에이전트가 실행, 사용자는 brew 권한 프롬프트 1회 + Claude Code 재시작 1회만 눌러 주면 된다.
1. 왜 이게 필요한가
/debug 와 /qa 는 LSP 로 소스 구조 (심볼·참조·호출자) 를 읽는다. LSP 가 연결돼 있지 않으면 Grep 폴백으로 돌아가지만 정확도·속도가 떨어진다. Unity C# (.cs) 은 자동 연결 안 되므로 1회 세팅 필요.
핑거프린트: LSP.documentSymbol 호출 시 No LSP server available for file type: .cs 응답 → 세팅 안 됨.
2. 에이전트 자동 실행 순서
아래 순서를 그대로 돌린다. 중간 실패 시 다음 스텝으로 넘어가지 말고 사용자에게 한 줄 보고.
Step 1 — 현재 상태 점검
which omnisharp || echo "MISSING:omnisharp"
grep -q '"ENABLE_LSP_TOOL"' .claude/settings.json 2>/dev/null || echo "MISSING:flag"
Step 2 — OmniSharp 설치 (macOS)
MISSING:omnisharp 나왔으면:
brew install omnisharp
- 사용자 프롬프트 1회 발생 (brew 설치). 에이전트는 이 프롬프트가 뜬 직후 사용자에게 "OmniSharp 설치 권한을 눌러 주세요" 한 줄 고지.
- Windows/Linux 는 공식 릴리즈 에서 바이너리 다운로드 후 PATH 에 추가 — 이건 사용자에게 링크 제시 후 위임.
Step 3 — .claude/settings.json 에 LSP 활성화
파일이 없으면 새로 생성, 있으면 기존 키와 병합. settings.local.json 이 아니라 settings.json 에 쓴다 (프로젝트 공유 설정이라).
{
"env": {
"ENABLE_LSP_TOOL": "1"
},
"enabledPlugins": {
"omnisharp-lsp@claude-plugins-official": true
}
}
플러그인 이름이 다를 수 있음. 위 이름으로 Step 4 에서 설치 실패 시 claude plugin search omnisharp 또는 claude plugin search csharp 로 대체 이름 확인.
Step 4 — 플러그인 설치
claude plugin install omnisharp-lsp@claude-plugins-official
실패하면:
claude plugin search omnisharp
claude plugin search csharp
찾은 이름으로 재시도, 그에 맞춰 settings.json 의 enabledPlugins 키도 수정.
Step 5 — Unity .sln 생성 확인
OmniSharp 는 .sln 또는 .csproj 가 있어야 프로젝트 인덱싱. Unity 는 Editor 가 열리면 자동 생성.
ls *.sln 2>/dev/null || echo "MISSING:sln"
MISSING:sln 이면:
- Unity Hub 에서 프로젝트 1회 열기 (사용자) →
.sln / Assembly-CSharp.csproj 등 자동 생성
- 또는
/run editor 로 에이전트가 Editor 를 한 번 띄우면 자동 생성됨
Step 6 — Claude Code 재시작
설정 반영 위해 사용자가 Claude Code 재시작. 에이전트는 이 시점에 작업 일시 중단하고 "LSP 활성화를 위해 Claude Code 를 재시작해 주세요. 재시작 후 이어서 진행합니다." 로 안내.
Step 7 — 검증
재시작 후 첫 작업에서:
LSP.documentSymbol
filePath=Assets/Scripts/_Core/Any.cs # 프로젝트 안의 아무 .cs 파일
line=1 character=1
- 심볼 목록 반환 → ✅ 세팅 성공
No LSP server available for file type: .cs 여전 → Step 1 로 복귀, 어느 스텝이 안 먹혔는지 재점검.
3. 실패 시 대응 — Grep 폴백
세팅이 실패하거나 사용자가 재시작을 미루면 LSP 대신 Grep 을 정적 평가 1순위로 사용. debug.md §2 와 qa.md §3 의 Grep 스니펫이 모든 LSP 경로를 커버한다. 이 때 에이전트는 "LSP 미연결 상태 — Grep 폴백으로 진행" 을 세션 시작 시 1회 고지.
4. 금지 사항
- 사용자에게 개별 명령을 복붙 시키지 않는다. 에이전트가
Bash 툴로 직접 돌린다. 사용자는 권한 프롬프트만 본다.
brew install 실패를 무시하고 넘어가지 않는다. 실패 메시지 그대로 사용자에게 고지 후 중단.settings.local.json 에 쓰지 않는다 — 그 파일은 개인 설정 (.gitignore). LSP 는 프로젝트 공유 설정이 맞으므로 settings.json..sln 없다고 수동으로 만들지 않는다. Unity 에디터가 생성하게 한다. 수동 생성은 어셈블리 참조가 어긋난다.
5. 참고
- 이 스킬의 설치 파라미터는 Claude Code 플러그인 레지스트리 기반. 레지스트리 이름 변경 시 Step 4 의 대체 검색으로 대응.
- OmniSharp 는 deprecated 권고가 있지만 2026-04 기준 Unity C# 에 여전히 가장 안정. 대체로 Microsoft 공식 Roslyn Language Server 도 있지만 C# Dev Kit VSIX 번들이라 Claude Code 직접 사용은 설정 복잡.
