Claude Code 2.0: 출시일, 새 기능, 업데이트 방법

Claude Code 2.0은 2025년 9월 29일에 출시되었습니다. VS Code 확장, 새로 단장한 터미널 화면, /rewind로 되돌릴 수 있는 체크포인트가 추가되었습니다. 다만 지금 최신 버전은 2.0이 아닙니다. 2.0 계열은 2026년 1월 6일 2.0.77에서 끝났고, 2026년 10월 31일 기준 최신 릴리스는 2.1.316입니다.

native 설치를 업데이트하려면 다음을 실행합니다:

claude update
claude --version

Claude Code 2.0은 언제 출시되었나요?

Anthropic은 2025년 9월 29일 14:41 UTC에 2.0.0을 npm에 공개했습니다. 발표문 "Enabling Claude Code to work more autonomously"와 같은 날입니다(npm 레지스트리, 2026년 10월 31일 확인). 2.0 계열은 2026년 1월 6일 2.0.77까지 이어졌고, 공개된 버전은 모두 70개였습니다. 2.0.74는 2025년 12월 19일, 2.0.76은 2025년 12월 22일에 나왔습니다.

2.1.0은 다음 날인 2026년 1월 7일에 나왔습니다. 2026년 10월 31일 기준 레지스트리에는 모두 555개 버전이 있었습니다. 같은 날 latest 태그는 2.1.316을, stable 태그는 2.1.309를 가리켰습니다. Anthropic의 설정 페이지에 따르면 stable 채널은 보통 일주일 정도 늦게 배포되고 큰 문제가 있는 릴리스는 건너뜁니다(2026년 10월 31일 확인).

Claude Code 2.0의 새 기능은 무엇이었나요?

주요 변경 사항은 Anthropic의 2025년 9월 29일 발표와 2.0.0 체인지로그에 있습니다.

• 베타 단계의 native VS Code 확장. 사이드바 패널과 인라인 diff가 있습니다.
• 상태를 더 잘 볼 수 있고 Ctrl+r로 프롬프트 기록을 검색할 수 있게 새로 단장한 터미널 화면.
• 변경 전의 코드 상태를 저장하는 체크포인트.
• Claude Code SDK를 Claude Agent SDK로 이름 변경.
• 기본 모델이 Claude Sonnet 4.5로.

2.0.0 체인지로그는 10개 항목이고, 그중에는 "New native VS Code extension", "Fresh coat of paint throughout the whole app", "/rewind a conversation to undo code changes", "/usage command to see plan limits"가 들어 있습니다.

체크포인트는 지금도 같은 방식으로 동작합니다. 턴을 시작하는 프롬프트마다 하나가 만들어지고, 세션은 최근 100개를 보관합니다. 스냅샷은 그 세션이 마지막으로 저장한 뒤 약 30일이 지나면 삭제됩니다. /rewind를 실행하거나 빈 프롬프트에서 Esc를 두 번 누르면 선택지 네 개가 있는 메뉴가 열립니다. 코드와 대화 복원, 대화만 복원, 코드만 복원, 요약입니다. Bash 명령만으로 바뀐 파일은 추적되지 않고, 서브에이전트의 편집도 보통 기록되지 않습니다. 위험한 변경 전에는 git에 커밋해 두십시오.

2.0 이후에 무엇이 바뀌었나요?

2025년 12월 19일 2.0.74에서는 정의로 이동, 참조 찾기, 호버 설명을 하는 LSP(Language Server Protocol) 도구가 추가되었습니다. 2026년 1월 7일 2.1.0에는 항목이 15개 있었고, 그중에는 이런 것들이 있습니다.

• 스킬을 만들거나 고치면 재시작 없이 바로 다시 로드됩니다.
• 스킬을 context: fork로 포크한 서브에이전트 안에서 실행할 수 있습니다.
• language 설정으로 Claude가 답하는 언어를 고를 수 있습니다.
• Shift+Enter가 iTerm2, WezTerm, Ghostty, Kitty에서 바로 동작합니다.
• OAuth 토큰, API 키, 비밀번호가 디버그 로그에 남지 않게 하는 보안 수정.

버전 2.1.89(2026년 3월 31일)부터 릴리스 매니페스트에 서명이 붙습니다. 그 이전 버전은 체크섬만 제공합니다. npm 패키지는 Node.js 22 이상을 요구하며, 2.0.0의 Node.js 18에서 올라갔습니다. Pro, Max, Ultra, Team, Enterprise, Anthropic API의 기본 모델은 지금 Opus 5.5입니다.

CLI 옵션과 명령 줄은 2.0.76과 2.1.316의 claude --help 출력을 센 것입니다.

2.0.76과 비교하면 2.1.316의 도움말 출력은 이렇게 달라졌습니다.

• 새 명령에는 백그라운드 에이전트용 agents, 백그라운드 세션용 attach, logs, stop, rm, 인증용 auth, 다른 AI 코딩 에이전트에서 설정을 가져오는 import, 프로젝트의 Claude Code 데이터를 컴퓨터에서 지우는 purge, 클라우드에서 도는 멀티 에이전트 코드 리뷰 ultrareview가 있습니다.
• 새 옵션에는 새 git worktree를 만드는 --worktree, low부터 max까지 지정하는 --effort, 백그라운드로 시작하는 --bg, --remote-control, 커스터마이즈를 모두 끄고 시작하는 --safe-mode, --name이 있습니다.
• --permission-mode는 default와 delegate를 빼고 auto와 manual을 넣었습니다. default나 delegate를 넘기던 스크립트는 새 값을 써야 합니다.
• 사라진 옵션은 --mcp-debug 하나뿐입니다. 2.0.76에서도 이미 deprecated로 표시되어 있었습니다.

버전을 확인하고 업데이트하려면 어떻게 하나요?

claude --version을 실행하면 지금 버전을 볼 수 있습니다. 번호 뒤에 "(Claude Code)"가 붙어 예를 들어 2.1.316 (Claude Code)처럼 출력됩니다. 그다음 설치한 방식과 같은 방법으로 업데이트합니다.

# Native installer
claude update

# Homebrew, stable channel
brew upgrade claude-code
# Homebrew, latest channel
brew upgrade claude-code@latest

# WinGet
winget upgrade Anthropic.ClaudeCode

# npm
npm install -g @anthropic-ai/claude-code@latest

native 설치는 백그라운드에서 스스로 업데이트하며, 시작할 때와 실행 중에 확인합니다. 새 버전은 다음에 Claude Code를 시작할 때 적용됩니다. Homebrew, WinGet, Linux 패키지(apt, dnf, apk) 설치는 직접 업데이트해야 합니다. native 설치에서는 claude update가 아래 첫 두 줄 중 하나를 출력하고, Homebrew, WinGet, apk 설치에서는 세 번째 줄을 출력합니다.

Successfully updated from <old version> to version <new version>
Claude Code is up to date (<version>)
Claude is up to date!

claude doctor는 마지막 업데이트 시도의 결과와 자동 업데이트가 켜져 있는지를 보여 줍니다. VS Code 확장의 버전 번호는 그 확장이 포함한 Claude Code 버전입니다.

npm에서는 npm update -g를 피하십시오. 처음 설치할 때의 버전 범위를 그대로 유지해서 최신 릴리스에 닿지 않을 수 있습니다. sudo npm install -g도 쓰지 마십시오.

오래된 2.0을 업데이트하면 어떻게 되나요?

2026년 10월 31일, Node.js 26.12.1이 설치된 Mac에서 새로 설치를 다섯 번 했습니다. 각각 빈 홈 폴더에서 OmniaKey API를 통해 Claude 모델을 향하게 했습니다.

native 두 개는 모두 시작했고 claude update로 2.1.x가 되었습니다. 2.0.0은 설치에 36.6초, 업데이트에 35.6초가 걸렸고, 2.0.76은 설치에 51.6초, 업데이트에 29.6초가 걸렸습니다.

Successfully updated from 2.0.0 to version 2.1.308
Successfully updated from 2.0.76 to version 2.1.314

둘 다 그 시간에 npm에서 최신이던 2.1.316에는 닿지 않았습니다. 업데이트한 뒤에는 claude --version으로 확인하십시오.

npm 2.0.76은 시작했지만 업데이트에 실패했습니다:

New version available: 2.1.316 (current: 2.0.76)
Error: Failed to install update
Or consider using native installation with: claude install

버전은 2.0.76 그대로였습니다. npm 2.0.0은 거기까지 가지 못하고 Node.js 26.12.1에서 시작 중에 종료 코드 1로 크래시했습니다.

TypeError: Cannot read properties of undefined (reading 'prototype')

같은 컴퓨터에서 native 2.0.0 바이너리는 문제없이 시작했으므로, 이 크래시는 이 Node 버전에서의 npm 빌드 2.0.0 문제입니다. npm 2.1.316은 시작해서 2.1.316 (Claude Code)를 출력했습니다. npm으로 설치했다면 위의 npm 명령으로 업데이트하거나, 메시지가 권하는 대로 claude install을 실행해 native 설치로 옮기십시오.

native로 업데이트해도 두 버전 모두 ~/.local/share/claude/versions/에 남고 런처는 새 버전을 가리킵니다. 측정한 바이너리는 2.0.0이 74 MB, 2.0.76이 182 MB, 2.1.308이 275 MB, 2.1.314가 279 MB였고, 업데이트할 때마다 예전 바이너리가 디스크에 남았습니다.

버전을 고정하거나 되돌리거나 업데이트를 늦출 수 있나요?

특정 버전은 같은 스크립트에 버전 번호를 넘겨 설치합니다:

curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89

& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89

번호 대신 stable을 쓰면 stable 채널로 시작합니다. 설치할 때 고른 채널이 자동 업데이트의 기본이 되고, 나중에 settings.json에서 바꿀 수 있습니다:

{"autoUpdatesChannel": "stable"}

기본값인 latest는 새 릴리스가 나오는 대로 설치합니다. stable은 보통 일주일 정도 지난 버전이고 큰 문제가 있는 릴리스는 건너뜁니다. 같은 스위치는 /config에도 있습니다. 새로 나온 모델은 stable 채널이 배포하는 버전보다 새 버전을 요구할 수 있으니, 바로 쓰려면 latest로 바꾸십시오.

minimumVersion은 하한을 정하고, 자동 업데이트와 claude update는 그보다 오래된 버전을 설치하지 않습니다:

{"minimumVersion": "2.1.143"}

settings.json의 env 키에서 DISABLE_AUTOUPDATER를 1로 두면 백그라운드 확인만 멈추고 claude update는 그대로 동작합니다. DISABLE_UPDATES는 직접 하는 업데이트까지 모든 경로를 막습니다.

GitHub 사용자의 버그 리포트 두 건이 이런 부분의 거친 면을 보여 줍니다. 2026년 2월 12일 한 사용자가 이렇게 보고했습니다. "When running curl -fsSL https://claude.ai/install.sh | bash -s <version> to install a specific version, the script downloads the new binary but fails to update the symlink, leaving the user on the old version" (특정 버전을 지정해도 새 바이너리를 받은 뒤 symlink를 갱신하지 못해 예전 버전에 머문다는 뜻입니다)(issue #25165, 종료됨).

2026년 5월 17일에는 한 Windows 사용자가 stable 채널에서 2.1.143을 설치한 뒤 자동 업데이터가 당시 stable 빌드인 2.1.133으로 되돌려 놓았다고 보고했습니다. autoUpdatesChannel: "latest"와 minimumVersion: "2.1.143"을 함께 두니 "stopped the revert", 즉 되돌림이 멈췄습니다(issue #60065, 종료됨).

고정한 뒤에는 claude --version을 실행해 기대한 번호가 나오는지 확인하십시오.

오래된 Claude Code 버전도 계속 동작하나요?

Anthropic은 오래된 빌드의 지원 종료일을 공개하지 않았고, 확인한 페이지 어디에도 2.0.x를 거부한다는 내용이 없습니다. 다만 고른 모델이 더 새 빌드를 요구하거나 조직 정책이 빌드를 요구하면 API가 400 claude_code_version_too_old로 요청을 거절할 수 있습니다(Anthropic 오류 페이지, 2026년 10월 31일 확인).

게이트웨이 뒤에서는 오래된 설치의 내장 기본 모델 때문에 요청이 깨질 수 있습니다. 모델을 지정하지 않고 시작한 2.0.76은 내장 기본값인 claude-sonnet-4-5-20250929를 요청했고, 저희 게이트웨이가 그 모델을 제공하지 않아 요청이 실패했습니다. 2.1.316은 claude-opus-5-5를 요청해 응답했습니다.

모델은 --model이나 환경 변수 ANTHROPIC_MODEL로 직접 지정하십시오. --model claude-sonnet-5-5를 주면 2.0.76도 아래 버그 수정을 문제없이 해냈습니다.

초기 2.0 빌드에도 문제가 있었습니다. 2025년 10월 1일 한 사용자가 Claude Code 2.0.0과 2.0.1이 Emacs와 Linux 셸에서 계속 멈춘다고 보고했습니다(issue #8657, 종료됨).

그러니 남아 있을 이유가 없다면 업데이트하십시오. 2.0에 남는다면 세션마다 모델을 지정하십시오.

같은 작업에서 새 버전이 더 나은가요?

2.0.76과 2.1.316에서 같은 버그 수정 작업을, 둘 다 --model claude-sonnet-5-5로 비대화형으로 실행했습니다.

작업:

The tests in test_wordcount.py fail. Find the bug in wordcount.py, fix it, and run python3 test_wordcount.py to confirm. Do not change the test file.

버그는 대소문자를 구분해 세던 단어 수였습니다.

두 버전 모두 같은 한 줄을 고쳤고, 세기 전에 text.lower()로 텍스트를 소문자로 바꿨으며 테스트 파일은 건드리지 않았습니다. 테스트는 둘 다 통과했고 두 diff는 바이트 단위로 같았습니다. 새 빌드가 바꾼 것은 걸린 시간이고 답이 아닙니다.

2.1.316은 15.9초에 끝나 25.8초보다 38% 빨랐고, Claude Code 비용 추정은 $0.055로 $0.129보다 낮았습니다. 주된 이유는 읽고 쓴 캐시 토큰이 적었기 때문입니다. 이 두 달러 금액은 Claude Code 자체의 비용 추정이고 저희가 실제로 낸 금액이 아닙니다. 작업 하나를 버전마다 한 번씩 실행한 작은 표본입니다.

구독 대신 API 키로 Claude Code를 쓰려면 어떻게 하나요?

Claude Code에는 Pro, Max, Ultra, Team, Enterprise, Console 계정 중 하나가 필요하고 무료 claude.ai 플랜에는 들어 있지 않습니다. 게이트웨이는 변수 두 개를 씁니다. ANTHROPIC_BASE_URL은 요청이 가는 곳이고, 자격 증명은 ANTHROPIC_AUTH_TOKEN이 Authorization: Bearer로, ANTHROPIC_API_KEY가 x-api-key로 전송됩니다. 베이스 URL은 요청이 가는 곳만 바꾸고 어떤 모델이 답하는지는 바꾸지 않으니 모델도 지정하십시오.

export ANTHROPIC_BASE_URL="https://api.omniakey.com"
export ANTHROPIC_AUTH_TOKEN="your-omniakey-api-key"
claude --model claude-sonnet-5-5

위 테스트는 이 방식으로, ANTHROPIC_AUTH_TOKEN에 OmniaKey 키를 넣어 실행했습니다.

Claude Code API 키 가이드에서 변수와 Windows 설정을 다룹니다. 더 긴 설명은 설치 가이드와 구독 없이 Claude Code 쓰기에 있습니다. Claude Opus 5.5와 Claude Sonnet 5.5 모델 페이지에서 각각의 용도를, 플랜 가격은 Claude Code 요금 가이드에서 볼 수 있습니다.

자주 묻는 질문

Claude Code 2.0이 최신 버전인가요?

아니요. 2.0 계열은 2026년 1월 6일 2.0.77에서 끝났고, 2026년 10월 31일 기준 최신 릴리스는 2.1.316입니다. 지금 버전은 claude --version으로 확인할 수 있습니다.

Claude Code 2.0은 언제 출시되었나요?

Claude Code 2.0은 2025년 9월 29일에 출시되었습니다. 2.0.0이 npm에 도착한 날이 Anthropic의 발표와 같은 날입니다. 2.1 계열은 2026년 1월 7일에 시작했습니다.

Claude Code는 어떻게 업데이트하나요?

native 설치라면 claude update를 실행하거나 백그라운드 자동 업데이트에 맡깁니다. Homebrew는 brew upgrade claude-code 또는 brew upgrade claude-code@latest, WinGet은 winget upgrade Anthropic.ClaudeCode, npm은 npm install -g @anthropic-ai/claude-code@latest입니다. 그 뒤 claude --version으로 결과를 확인합니다.

Claude Code의 예전 버전은 어떻게 설치하나요?

설치 스크립트에 버전을 넘깁니다. macOS, Linux, WSL에서는 curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89, PowerShell에서는 & ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89입니다.

무료 플랜에서도 Claude Code를 쓸 수 있나요?

아니요. 무료 claude.ai 플랜에는 Claude Code가 들어 있지 않고, Pro, Max, Ultra, Team, Enterprise, Console 계정 중 하나가 필요합니다. 다른 방법은 API 키이고, Anthropic Console이나 게이트웨이에서 받아 사용량만큼 과금됩니다.

확인한 출처

• npm: @anthropic-ai/claude-code — 2026년 10월 31일 확인
• Anthropic: Enabling Claude Code to work more autonomously — 2026년 10월 31일 확인
• Claude Code changelog — 2026년 10월 31일 확인
• Claude Code setup — 2026년 10월 31일 확인
• Claude Code checkpointing — 2026년 10월 31일 확인
• Claude Code with an LLM gateway — 2026년 10월 31일 확인
• Claude Code model configuration — 2026년 10월 31일 확인
• Claude Code errors — 2026년 10월 31일 확인
• Claude Code in VS Code — 2026년 10월 31일 확인
• Use Claude Code with Pro, Max or Ultra — 2026년 10월 31일 확인
• GitHub issue #8657 — 2026년 10월 31일 확인
• GitHub issue #25165 — 2026년 10월 31일 확인
• GitHub issue #60065 — 2026년 10월 31일 확인