Claude Code는 Anthropic이 만든 터미널 기반 코딩 에이전트입니다. 코드베이스를 읽고, 파일을 편집하고, 명령을 실행하며, Anthropic의 기본 API만 사용하는 대신 Anthropic 호환 백엔드에 연결할 수 있습니다. 이 가이드에서는 Claude Code CLI 설정, 슬래시 명령, 사용자 정의 스킬, 그리고 Novita AI를 통해 요청을 라우팅하는 방법을 다룹니다.
데이터베이스, 브라우저 또는 기타 외부 도구가 필요하다면 Claude MCP 구성 가이드와 함께 사용하세요.
핵심 요약
- Claude Code는 단순한 프롬프트 상자가 아니라 명령줄 에이전트입니다.
/compact,/resume,/permissions,/model은 세션 명령이고,-p와--resume은 CLI 플래그입니다.- 사용자 정의 슬래시 명령은 이제 스킬로 관리되므로
.claude/skills/와.claude/commands/모두 중요합니다. - Novita AI는
ANTHROPIC_BASE_URL을 통해 Anthropic 호환 백엔드로 사용할 수 있습니다. - Claude Code는 IDE 스타일 워크플로우와 자동화된 에이전트 실행 모두에 적합합니다.
Claude Code란 무엇인가?
Claude Code는 Anthropic의 에이전트형 코딩 도구입니다. CLI는 터미널에서 실행되지만, 동일한 에이전트가 데스크톱 앱, 브라우저 인터페이스, 에디터 통합에서도 사용할 수 있습니다.
CLI는 가장 유연한 인터페이스입니다. Unix 규칙을 따르므로 파일을 파이프로 전달하고, -p로 비대화형 실행을 하고, 스크립트나 CI에 연동할 수 있습니다. 구성은 CLAUDE.md, .claude/settings.json, 환경 변수에 저장되어 반복적인 코딩 워크플로우에 적합합니다.
내부적으로 Claude Code는 Anthropic 호환 API 엔드포인트로 요청을 보냅니다. 기본 엔드포인트는 Anthropic 자체 서비스이지만, 환경 변수 하나만으로 Novita AI의 LLM API로 리디렉션할 수 있습니다.
Claude Code 설정
설치
Node.js 18 이상에서 CLI를 설치합니다.
npm install -g @anthropic-ai/claude-code
첫 실행
프로젝트 디렉터리에서 Claude Code를 실행합니다.
cd your-project
claude
처음 사용하면 Claude Code가 로그인을 요청합니다. 인증이 완료되면 프로젝트를 읽고 지시를 기다립니다.
프로젝트 설정
새 저장소에서 /init을 실행하면 스타터 CLAUDE.md 파일이 생성됩니다. Claude Code는 모든 세션 시작 시 CLAUDE.md를 읽으므로 코딩 표준, 선호 라이브러리, 아키텍처 노트, 리뷰 체크리스트를 기록하기에 적합합니다.
/init
/init 후에는 /memory를 사용해 파일을 편집하거나 자동 메모리를 활성화할 수 있습니다. 자동 메모리는 Claude가 프로젝트에 대해 관찰한 내용을 세션 간에 저장합니다.
CLI 명령 참조
| 명령 | 설명 |
|---|---|
claude |
현재 디렉터리에서 대화형 세션 시작 |
claude "query" |
초기 프롬프트로 세션 시작 |
claude -p "query" |
쿼리를 실행하고 종료 |
cat file | claude -p "query" |
파일 내용을 쿼리로 파이프 |
claude -c |
현재 디렉터리에서 가장 최근 세션 계속 |
claude -r "name" "query" |
이름 또는 ID로 세션 재개 |
claude update |
최신 버전으로 업데이트 |
claude install stable |
안정적인 바이너리 설치 또는 재설치 |
claude auth login |
Anthropic 계정에 로그인 |
claude auth login --console |
구독 대신 API 키 결제로 로그인 |
claude auth status |
인증 상태 표시 |
claude mcp |
MCP 서버 구성 |
claude doctor |
설치 및 설정 진단 표시 |
CLI 플래그 참조
| 플래그 | 기능 |
|---|---|
-p, --print |
비대화형 모드; 응답을 출력하고 종료 |
-c, --continue |
가장 최근 대화 불러오기 |
-r, --resume |
ID 또는 이름으로 세션 재개 |
--model |
이 세션에서 사용할 모델 설정 |
--permission-mode |
권한 모드로 시작 |
--add-dir |
추가 디렉터리에 파일 액세스 권한 부여 |
--system-prompt |
시스템 프롬프트를 완전히 대체 |
--append-system-prompt |
기본 시스템 프롬프트에 추가 |
--max-turns |
-p 모드에서 에이전트 턴 수 제한 |
--max-budget-usd |
-p 모드에서 API 지출 상한 설정 |
--output-format |
-p 모드의 출력 형식: text, json, stream-json |
--bg |
백그라운드 에이전트로 시작하고 즉시 반환 |
--worktree, -w |
격리된 git worktree에서 시작 |
--bare |
더 빠른 스크립트 호출을 위해 훅, 스킬, 플러그인, MCP 자동 검색 건너뛰기 |
--verbose |
턴별 전체 출력 표시 |
--mcp-config |
JSON 파일에서 MCP 서버 로드 |
--effort |
추론 노력 설정 |
--print + --output-format json 조합은 스크립팅의 표준 패턴입니다. 예산 제약이 있는 CI 파이프라인에서는 --max-budget-usd와 --max-turns를 함께 사용하세요.
슬래시 명령 문서
슬래시 명령은 활성 세션 내에서 실행됩니다. /를 입력하면 사용 가능한 모든 명령을 볼 수 있고, / 다음에 문자를 입력하면 필터링할 수 있습니다. 명령은 메시지 시작 부분에서만 작동합니다.
세션 및 컨텍스트 관리
| 명령 | 용도 |
|---|---|
/clear |
새 대화 시작; 이전 세션은 /resume에 유지 |
/compact |
컨텍스트 창 공간을 확보하기 위해 대화 요약 |
/context |
컨텍스트 사용량을 시각화하고 최적화 제안 보기 |
/resume |
이름 또는 선택기에서 이전 세션 다시 열기 |
/branch |
다른 방향을 시도하기 위해 대화 포크 |
/rewind |
코드와 대화를 체크포인트로 롤백 |
프로젝트 설정
| 명령 | 용도 |
|---|---|
/init |
프로젝트용 스타터 CLAUDE.md 생성 |
/memory |
CLAUDE.md 파일 편집 및 자동 메모리 관리 |
/mcp |
MCP 서버 연결을 대화형으로 관리 |
/agents |
서브에이전트 설정 구성 |
/permissions |
도구에 대한 허용, 묻기, 거부 규칙 설정 |
/hooks |
훅 구성 보기 |
개발 워크플로우
| 명령 | 용도 |
|---|---|
/plan |
큰 변경 전에 플랜 모드 진입 |
/model |
활성 모델 전환 |
/effort |
추론 노력 수준 조정 |
/diff |
대화형 diff 뷰어 열기 |
/code-review [--fix] |
현재 diff 리뷰; --fix는 발견 사항을 적용 |
/security-review |
대기 중인 변경 사항에 대한 심층 보안 점검 |
/batch <instruction> |
큰 변경을 분해하여 병렬 worktree에서 실행 |
/background |
세션을 분리하여 백그라운드 에이전트로 실행 |
유틸리티
| 명령 | 용도 |
|---|---|
/help |
사용 가능한 명령 표시 |
/doctor |
설치 및 설정 문제 진단 |
/usage |
세션 비용 및 플랜 사용량 표시 |
/export |
대화를 일반 텍스트로 내보내기 |
/config |
설정 열기 또는 값을 직접 설정 |
/skills |
사용 가능한 스킬 나열 |
사용자 정의 슬래시 명령
사용자 정의 슬래시 명령은 이제 스킬로 관리됩니다. 기존 .claude/commands/ 파일도 여전히 동작하지만 .claude/skills/ 형식이 권장됩니다.
사용자 정의 명령을 만드는 방법
.claude/skills/(프로젝트 수준) 또는 ~/.claude/skills/(개인 수준) 아래에 디렉터리를 만듭니다.
mkdir -p .claude/skills/review-pr
해당 디렉터리 안에 SKILL.md 파일을 만듭니다.
---
description: Review an open GitHub PR for security issues and test coverage gaps.
---
## Instructions
Review the pull request with these priorities:
1. Identify security vulnerabilities.
2. Check test coverage for new code paths.
3. Flag missing error handling at system boundaries.
이렇게 하면 직접 호출할 수 있는 /review-pr 명령이 생성됩니다.
/review-pr
Claude는 설명과 일치하는 요청을 하면 스킬을 자동으로 로드합니다.
스킬 위치 및 우선순위
~/.claude/skills/ → personal, all projects
.claude/skills/ → this project only
.claude/commands/의 사용자 정의 명령도 여전히 동작합니다. .claude/commands/deploy.md 파일과 .claude/skills/deploy/SKILL.md 스킬 모두 /deploy 명령을 생성합니다.
Novita AI를 LLM 백엔드로 사용하기
Claude Code는 ANTHROPIC_BASE_URL을 통해 API 트래픽을 라우팅합니다. 이 값을 Novita AI의 Anthropic 호환 엔드포인트로 설정하면 Claude Code 워크플로우를 변경하지 않고도 Novita 모델을 사용할 수 있습니다.
Novita AI API 키 받기
무료 체험 크레딧을 받으려면 Novita AI 계정에 가입하세요. 그런 다음 키 관리 페이지를 열고 Create New Key 버튼을 클릭한 후 키를 즉시 복사하세요.
환경 변수 설정
Mac 및 Linux에서:
export ANTHROPIC_BASE_URL="https://api.novita.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="<Your Novita API Key>"
export ANTHROPIC_MODEL="moonshotai/kimi-k2-instruct"
export ANTHROPIC_SMALL_FAST_MODEL="moonshotai/kimi-k2-instruct"
Windows(명령 프롬프트)에서:
set ANTHROPIC_BASE_URL=https://api.novita.ai/anthropic
set ANTHROPIC_AUTH_TOKEN=<Your Novita API Key>
set ANTHROPIC_MODEL=moonshotai/kimi-k2-instruct
set ANTHROPIC_SMALL_FAST_MODEL=moonshotai/kimi-k2-instruct
ANTHROPIC_SMALL_FAST_MODEL은 파일 조회, 빠른 요약 같은 내부 작업에 사용되는 경량 모델을 제어합니다.
Claude Code 시작
cd your-project
claude
스크립팅 및 CI에서도 동일한 방법이 적용됩니다.
cat logs.txt | claude -p "find any error patterns" --output-format json
Novita AI의 LLM API는 도구 사용, 구조화된 출력, 스트리밍을 포함한 Anthropic 메시지 형식을 지원하므로 Claude Code를 수정 없이 사용할 수 있습니다.
격리된 실행을 위한 에이전트 샌드박스
Claude Code 위에 자동화 파이프라인을 구축하고 있다면 Novita AI의 Agent Sandbox가 에이전트 실행을 위한 격리된 환경을 제공합니다. CI 워크플로우와 다단계 코딩 작업에 유용합니다.
IDE 도구로서의 Claude Code
Claude Code는 기존 워크플로우를 대체하지 않고 그 안에 위치하기 때문에 "IDE"라고 자주 설명됩니다. 더 정확히 말하면 터미널, 에디터, 프로젝트 컨텍스트와 함께 작동하는 에이전트 레이어입니다.
VS Code 및 Cursor
VS Code Marketplace 또는 Cursor 마켓플레이스에서 Claude Code 확장 프로그램을 설치합니다. 설치 후 명령 팔레트를 열고 "Claude Code"를 입력한 다음 Open in New Tab 옵션을 선택하세요.
VS Code 통합은 에디터 패널에서 인라인 diff 리뷰, 파일 언급, 편집 전 플랜 리뷰, 대화 기록을 제공합니다. 또한 확장 프로그램과 함께 통합 터미널에서도 Claude Code를 사용할 수 있습니다.
JetBrains
JetBrains Marketplace에서 Claude Code 플러그인을 설치하고 IDE를 재시작합니다. IntelliJ IDEA, PyCharm, WebStorm 등 JetBrains IDE에서 대화형 diff 보기와 선택 컨텍스트 공유를 제공합니다.
데스크톱 앱 및 웹
Claude Code 데스크톱 앱을 사용하면 diff를 시각적으로 검토하고 여러 세션을 나란히 실행할 수 있습니다. claude.ai/code의 웹 인터페이스는 로컬 설정 없이 브라우저에서 세션을 실행합니다.
FAQ
ANTHROPIC_BASE_URL이란 무엇이며 왜 중요한가요?
ANTHROPIC_BASE_URL은 Claude Code에 요청을 보낼 API 엔드포인트를 지정합니다. 기본값은 Anthropic API입니다. 이 값을 https://api.novita.ai/anthropic로 설정하면 Novita AI의 Anthropic 호환 엔드포인트로 트래픽이 라우팅됩니다.
CLI 플래그와 슬래시 명령의 차이점은 무엇인가요?
CLI 플래그는 셸에서 claude를 실행할 때 설정합니다. 슬래시 명령은 활성 세션 안에서 실행되며 대화 중에 동작을 변경합니다.
Claude 구독 없이 Claude Code를 사용할 수 있나요?
네. claude auth login --console은 Anthropic Console API 키 결제로 로그인합니다. ANTHROPIC_BASE_URL을 통해 Novita AI로 라우팅하는 경우 Novita AI 계정만 있으면 됩니다.
사용자 정의 슬래시 명령은 CLAUDE.md와 어떻게 다른가요?
CLAUDE.md는 모든 세션 시작 시 로드되어 컨텍스트에 유지됩니다. 스킬은 호출할 때만 로드되므로 항상 필요한 프로젝트 정보는 CLAUDE.md에, 반복적인 절차는 스킬에 저장하세요.
Claude Code는 CI에서 동작하나요?
네. 비대화형 모드로 claude -p "query" --output-format json을 사용하세요. 지출 상한은 --max-budget-usd, 실행 시간 제한은 --max-turns로 설정할 수 있습니다.
Novita AI는 개발자들이 간단한 API를 사용해 AI 모델을 쉽게 배포할 수 있도록 지원하는 AI 클라우드 플랫폼입니다. 또한 구축과 확장을 위한 저렴하고 안정적인 GPU 클라우드를 제공합니다.
