charmbracelet/crush

Crush란 무엇인가?

Crush는 Charm bracelet 생태계의 터미널 기반 AI 코딩 어시스턴트입니다. 셸에서 직접 대규모 언어 모델(LLM)과 채팅할 수 있으며, 이미 사용 중인 도구(편집기, 언어 서버 프로토콜(LSP) 서버, 버전 관리, 사용자 정의 "Model Context Protocol"(MCP) 서비스)와 긴밀하게 통합됩니다. 요컨대, 명령줄을 코드 실행, 정보 검색, 외부 도구 호출이 가능한 대화형 코딩 파트너로 바꿔줍니다. 이 모든 것은 선택한 LLM에 의해 구동됩니다.

핵심 기능

기능	설명
멀티 모델 지원	OpenAI 호환, Anthropic 호환 또는 기타 제공자(예: OpenAI, Gemini, Claude, Ollama, Hyper)에 연결하고 대화 컨텍스트를 유지하면서 모델을 즉시 전환할 수 있습니다.
세션 기반 워크플로우	프로젝트별로 별도의 채팅 세션을 유지하고, 세션 간에 전환하고, 여러 터미널 창에서 세션을 공유할 수 있습니다.
LSP 강화 컨텍스트	언어 서버 프로토콜 서버(예: `gopls`, `nil`, `typescript-language-server`)를 로드하여 어시스턴트가 유형 정보, 진단 및 기타 언어별 데이터를 볼 수 있도록 합니다.
MCP를 통한 확장	`stdio`, `http`, `sse`의 세 가지 전송 유형을 통해 사용자 정의 도구 백엔드를 추가하여 어시스턴트가 임의의 서비스(GitHub, Linear, 사용자 정의 스크립트 등)를 호출할 수 있도록 합니다.
`crushrc`로 구성 가능	제공자, 모델, LSP, MCP, 권한을 선언할 수 있고 시작 시 셸 명령을 실행할 수도 있는 Bash 스타일 구성 파일입니다.
테마 및 UI	내장 TUI 테마(예: Charmtone Pantera, Gruvbox Dark)를 실시간으로 전환하거나 JSON 테마 파일로 편집할 수 있습니다.
크로스 플랫폼	macOS, Linux, Windows(PowerShell/WSL), FreeBSD, OpenBSD, NetBSD, 심지어 illumos/Solaris용 사전 빌드 바이너리를 제공합니다.
워크스페이스 공유	동일한 작업 디렉토리를 가리키는 여러 터미널 인스턴스가 자동으로 공유 워크스페이스에 참여하여 세션, 기록 및 도구 상태를 동기화합니다.

빠른 시작

설치 – 선호하는 패키지 관리자(Homebrew, NPM, Arch AUR, Nix, Debian/Ubuntu apt 저장소, Fedora/YUM, Winget, Scoop 등) 또는 go install github.com/charmbracelet/crush@latest를 사용합니다.
모델 선택 – Ctrl + L을 눌러 모델 선택기를 열고 제공자(예: 내장 Hyper 서비스 또는 모든 OpenAI 호환 API)를 선택한 다음 API 키를 붙여넣습니다(또는 OPENAI_API_KEY와 같은 해당 환경 변수를 설정합니다).
세션 시작 – 프로젝트 디렉토리에서 crush를 실행합니다. TUI가 열립니다. 자연어 프롬프트를 입력하고, 코드 생성을 요청하고, 어시스턴트에게 명령 실행을 요청하거나, 구성된 MCP 도구를 호출할 수 있습니다.
추가 컨텍스트 추가 – 선택적으로 crushrc 파일에 LSP 서버를 추가(lsp add go --command "gopls")하거나 사용자 정의 MCP 서비스를 등록(mcp add github --type http --url https://api.github.com/mcp/)할 수 있습니다.

구성 하이라이트

crushrc – provider add …, model add …, lsp add …, mcp add … 및 권한 설정을 할 수 있는 Bash 호환 스크립트입니다. 프로젝트 디렉토리에서 로드되며(./.crushrc → ./crushrc → ~/.config/crush/crushrc), 첫 번째로 존재하는 파일이 우선합니다.
환경 변수 – API 키(OPENAI_API_KEY, ANTHROPIC_API_KEY, HYPER_API_KEY 등)를 미리 채워 모델 선택기를 미리 채울 수 있습니다.
테마 – 명령 팔레트(Ctrl + P → Themes) 또는 JSON 구성에서 options.tui.active_theme를 설정하여 변경합니다.
전역 프롬프트 – 두 개의 선택적 Markdown 파일(~/.config/crush/CRUSH.md 및 ~/.config/AGENTS.md)이 시스템 프롬프트에 자동으로 주입되어 개인 규칙이나 공유 지침을 정의할 수 있습니다.

누가 혜택을 받을 수 있나요?

개발자 – 터미널에서 많은 시간을 보내고 셸을 떠나지 않고 AI 어시스턴트를 사용하려는 분.
팀 – macOS, Linux, Windows 워크스테이션에서 일관되고 구성 가능한 AI 도구가 필요한 분.
고급 사용자 – MCP를 통해 사용자 정의 서비스(이슈 트래커, CI 파이프라인, 코드 리뷰 봇)를 AI 워크플로우에 연결하려는 분.

더 알아보려면?

릴리스 페이지 – 바이너리 다운로드 및 변경 로그: https://github.com/charmbracelet/crush/releases
모델 카탈로그 – 커뮤니티 유지 관리 호환 모델 목록: https://github.com/charmbracelet/catwalk
문서 – 자세한 구성, 훅 및 MCP 가이드는 저장소의 docs/에 있습니다.
커뮤니티 – Charm Slack 또는 Discord(README에 링크)에 참여하여 도움을 받고 사용자 정의 구성을 공유하세요.

TL;DR

Crush는 주요 LLM과 작동하고, 언어 서버 데이터를 통합하고, 사용자 정의 도구 백엔드를 지원하고, 여러 터미널 창에서 공유할 수 있는 완전한 기능을 갖춘 터미널 네이티브 AI 코딩 컴패니언입니다. 패키지 관리자로 설치하고, crushrc(또는 환경 변수)에서 제공자를 구성하고, 명령줄에서 직접 코드와 채팅을 시작하세요.