BSplus Rhymix AI Toolkit

사용자 설치 가이드 — 키가 없으시면 bsplus.net으로 문의해 주세요.

📌 방법 선택
💻 PowerShell
🔷 VS Code
🖥️ Windows Terminal
🔧 문제 해결

Claude Code는 터미널(명령어 창)에서 실행합니다. 아래 중 편한 방법을 골라 탭을 클릭하세요.

💻
PowerShell
Windows 기본 내장. 별도 설치 없이 바로 시작 가능.
✓ 입문자 추천
🔷
VS Code
코드 편집기와 터미널을 동시에. 개발하면서 바로 사용 가능.
개발자 추천
🖥️
Windows Terminal
탭, 테마, 분할 화면. PowerShell보다 훨씬 세련된 환경.
업그레이드 추천
PowerShell
VS Code
Windows Terminal
공통
별도 설치
불필요
VS Code 설치
스토어 설치
파일 편집
내장 에디터
탭/분할
MCP 연결
난이도
쉬움
보통
쉬움

💡 어떤 방법이든 Claude Code 설치 과정은 동일합니다. 터미널 종류만 다를 뿐이에요.

Windows에 기본 내장된 터미널. 별도 설치 없이 바로 시작할 수 있어 입문자에게 가장 좋습니다.

1
PowerShell 열기

키보드 Win + SPowerShell 검색 → 실행
또는 Win + R → powershell 입력 → 확인

2
Claude Code 설치

아래 명령어를 붙여넣고 Enter를 누르세요.

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

⚠️ 설치 완료 후 창을 닫고 새로 여세요.

3
로그인 최초 1회
claude

브라우저가 자동으로 열립니다
→ Claude 계정으로 로그인 → Authorize 클릭
→ 터미널에 "Login successful" 뜨면 Enter
→ 테마/설정 화면은 Enter로 넘기기
/exit 로 나오기

4
세팅 claude 명령어 인식 안 될 때만
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\.local\bin", "User") Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

⚠️ 실행 후 창을 닫고 새로 여세요.

5
키 연결

rxmcp_발급받은키 부분을 받은 키로 교체하세요.

claude mcp add --scope user --transport http rhymix-bsplus http://bsplus.net:3011/mcp --header "Authorization: Bearer rxmcp_발급받은키"
6
확인 및 사용 시작
claude mcp list
✔ rhymix-bsplus ... Connected 뜨면 완료!

이제 claude 를 실행하고 한국어로 말하면 됩니다.
예: "라이믹스 출석체크 모듈 골격 만들어줘"

Microsoft의 무료 코드 편집기. 왼쪽엔 파일, 오른쪽엔 Claude Code — 개발하면서 바로 AI 활용이 가능합니다.

1
VS Code 설치

code.visualstudio.com → Download for Windows → 설치 (기본값으로 Next 연타)

💡 설치 시 "Add to PATH" 옵션이 체크돼 있는지 확인하세요.

2
VS Code 내장 터미널 열기

VS Code 실행 후 상단 메뉴 → TerminalNew Terminal
또는 단축키: Ctrl + ` (백틱)

하단에 터미널 창이 열립니다. PowerShell이 기본으로 실행됩니다.

3
Claude Code 설치
irm https://claude.ai/install.ps1 | iex

⚠️ 설치 완료 후 터미널을 닫고 새로 여세요. (Ctrl + ` 두 번)

4
로그인 최초 1회
claude

브라우저 로그인 → Authorize → "Login successful" → Enter → /exit

5
세팅 claude 인식 안 될 때만
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\.local\bin", "User") Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

⚠️ 실행 후 터미널 닫고 새로 열기

6
키 연결
claude mcp add --scope user --transport http rhymix-bsplus http://bsplus.net:3011/mcp --header "Authorization: Bearer rxmcp_발급받은키"
7
확인 및 사용
claude mcp list
✔ Connected 뜨면 완료!

이제 VS Code 터미널에서 claude 실행 → 왼쪽 파일 보면서 오른쪽에서 AI와 대화 가능!

Microsoft Store에서 무료로 제공하는 현대적인 터미널. 탭, 테마, 분할 화면을 지원해 PowerShell보다 훨씬 편합니다.

1
Windows Terminal 설치

방법 A — Microsoft Store에서 "Windows Terminal" 검색 → 설치
방법 B — PowerShell에서:

winget install --id Microsoft.WindowsTerminal
2
Windows Terminal 실행

Win + S → "Terminal" 검색 → 실행
기본으로 PowerShell이 열립니다. 탭 옆 + 버튼으로 탭 추가 가능.

💡 탭을 여러 개 열어서 하나는 claude 실행용, 하나는 일반 명령용으로 분리하면 편해요.

3
Claude Code 설치
irm https://claude.ai/install.ps1 | iex

⚠️ 설치 완료 후 탭을 닫고 새 탭을 열거나, 앱을 재시작하세요.

4
로그인 최초 1회
claude

브라우저 로그인 → Authorize → "Login successful" → Enter → /exit

5
세팅 claude 인식 안 될 때만
[Environment]::SetEnvironmentVariable("Path", [Environment]::GetEnvironmentVariable("Path", "User") + ";$env:USERPROFILE\.local\bin", "User") Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned

⚠️ 실행 후 탭 닫고 새 탭 열기

6
키 연결
claude mcp add --scope user --transport http rhymix-bsplus http://bsplus.net:3011/mcp --header "Authorization: Bearer rxmcp_발급받은키"
7
확인 및 사용
claude mcp list
✔ Connected 뜨면 완료!

claude 실행 후 한국어로 말하면 됩니다 😊

🔧 문제 해결

claude 인식 안 됨
세팅 2줄 실행 후 터미널 새로 열기
npm 오류
Set-ExecutionPolicy 실행 후 터미널 새로 열기
401 오류
키 오타 확인. Bearer 뒤 공백 1칸 있는지 확인
403 오류
키 비활성화됨 → bsplus.net 문의
429 오류
잠시 후 재시도 (분당 60회 제한)
Connected 안 됨
터미널 완전 종료 후 재실행
브라우저 안 열림
터미널에 URL이 출력됨 → 복사해서 브라우저에 붙여넣기
?
그래도 안 된다면

오류 메시지 전체를 캡처해서 bsplus.net으로 문의해 주세요.