Anthropic이 Claude Code v2.1.118을 공개했습니다. 이번 릴리스에서는 Vim Visual Mode의 완전한 지원, 커스텀 테마 시스템, 그리고 MCP 툴을 직접 호출할 수 있는 훅 기능이라는, 개발 경험을 크게 변화시키는 세 가지 기능이 추가되었습니다.
본 기사에서는 이들 신기능의 작동 방식과 구체적인 설정 방법을 공식 문서를 기반으로 설명합니다.
- Vim Visual Mode 사용법 및 텍스트 객체 조작
- JSON 파일로 Claude Code UI 색상 커스터마이징 방법
- 훅에서 MCP 툴을 직접 실행하는 설정 패턴
- /usage
통합과 DISABLE_UPDATES
환경 변수 등 주변의 변경점
-
Claude Code를 일상적으로 사용하는 엔지니어
-
Vim 키 바인딩으로 터미널을 조작하는 데 익숙한 분
-
MCP를 사용한 에이전트 워크플로우를 구성하는 분
-
Claude Code v2.1.118 이상 버전 ( claude --version 으로 확인) - macOS / Linux / WSL
-
Vim Visual Mode: :v (문자 단위), :V (줄 단위) 선택이 추가되었습니다. d, c, y 등의 연산자와 텍스트 객체(iw, `i
| 필드 | 설명 | 필수 |
|---|
name | 테마의 표시명 | 선택적 |
base | 기본 테마 ("dark" 또는 "light") | 선택적 |
overrides | 덮어쓸 컬러 토큰 | 선택적 |
컬러 값 형식: #rrggbb,
#rgb,
rgb(r,g,b),
ansi256(n),
ansi:<이름> 중 하나를 사용할 수 있습니다.
~/.claude/themes/my-theme.json 파일을 생성하고 - Claude Code에서 /theme을 실행한 후 - 목록에서 my-theme (파일 확장자 제외)을 선택합니다.
테마 설정 값 경로: 선택하면 custom:my-theme 형식으로 설정에 저장됩니다.
기존 파일을 수정하는 것이 아니라, 마법사(wizard) 형태로도 생성할 수 있습니다.
/theme을 실행 - 목록의 끝에 있는 **"New custom theme…"**을 선택 - 테마 이름을 입력합니다.
- 덮어쓰고 싶은 컬러 토큰을 대화 형식으로 선택합니다.
~/.claude/themes/ 내의 파일을 외부 에디터로 편집하면, 실행 중인 세션을 재시작하지 않아도 변경 사항이 즉시 반영됩니다. Ctrl+E로 하이라이트된 커스텀 테마를 직접 에디터에서 열 수 있는 단축키도 이용 가능합니다.
주의: 알 수 없는 토큰 이름이나 유효하지 않은 컬러 값은 무시되므로, 오타 때문에 렌더링이 깨지는 일은 없습니다.
v2.1.118 이전의 훅(hook) 설정에서는 검증 및 후처리 로직을 셸 스크립트나 HTTP 엔드포인트로 구현해야 했습니다. v2.1.118부터는 "type": "mcp_tool"을 지정함으로써, 설정된 MCP 서버의 도구를 훅에서 직접 호출할 수 있게 되었습니다.
.claude/settings.json 파일의 훅 설정에 다음과 같이 작성합니다.
{
"hooks": {
"PreToolUse": [
...
에서 할 수 있습니다.
Claude Code v2.1.118에서의 주요 변경점을 요약합니다.
| 기능 | 개요 |
|---|
| Vim Visual Mode | v /V를 이용한 비주얼 선택, 텍스트 객체・연산자와의 조합 |
| 커스텀 테마 | ~/.claude/themes/*.json에서 UI 색상 사용자 정의, 라이브 리로드 지원 |
| MCP Hook | Hook 설정에 ` |