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.md 작성 방법을 참조하세요.
내부적으로 Claude Code는 Anthropic 호환 API 엔드포인트로 요청을 보냅니다. 기본 엔드포인트는 Anthropic의 자체 서비스이지만, 단일 환경 변수로 Novita AI의 LLM API로 리디렉션할 수 있습니다. 가격 관련 내용은 Claude API 가격 vs 구독 요금제를 참조하세요.
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 "질문" |
초기 프롬프트로 세션 시작 |
claude -p "질문" |
질문 실행 후 종료 |
cat 파일 | claude -p "질문" |
파일 내용을 파이프로 전달하여 질문 |
claude -c |
현재 디렉토리의 가장 최근 세션 계속 |
claude -r "이름" "질문" |
이름 또는 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 워크트리에서 시작 |
--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 <지시사항> |
큰 변경을 분해하여 병렬 워크트리에서 실행 |
/background |
세션을 분리하여 백그라운드 에이전트로 실행 |
유틸리티
| 명령어 | 목적 |
|---|---|
/help |
사용 가능한 명령어 표시 |
/doctor |
설치 및 설정 문제 진단 |
/usage |
세션 비용 및 요금제 사용량 표시 |
/export |
대화를 일반 텍스트로 내보내기 |
/config |
설정 열기 또는 값 직접 설정 |
/skills |
사용 가능한 스킬 목록 |
커스텀 슬래시 명령어
커스텀 슬래시 명령어는 이제 스킬로 관리됩니다. 기존 .claude/commands/ 파일도 여전히 작동하지만, .claude/skills/가 권장 형식입니다.
커스텀 명령어 생성 방법
.claude/skills/(프로젝트 수준) 또는 ~/.claude/skills/(개인) 아래에 디렉토리를 생성하세요:
mkdir -p .claude/skills/review-pr
해당 디렉토리 안에 SKILL.md 파일을 생성하세요:
---
description: 보안 문제와 테스트 커버리지 격차에 대해 공개 GitHub PR을 검토합니다.
---
## 지침
다음 우선순위로 풀 리퀘스트를 검토하세요:
1. 보안 취약점 식별.
2. 새 코드 경로에 대한 테스트 커버리지 확인.
3. 시스템 경계에서 누락된 오류 처리 표시.
이렇게 하면 직접 호출할 수 있는 /review-pr 명령어가 생성됩니다:
/review-pr
Claude는 또한 설명과 일치하는 요청을 받으면 스킬을 자동으로 로드합니다.
스킬 위치 및 우선순위
~/.claude/skills/ → 개인, 모든 프로젝트
.claude/skills/ → 이 프로젝트만
.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 계정에 가입하면 무료 평가판 크레딧을 받을 수 있습니다. 그런 다음 키 관리 페이지를 열고 새 키 생성 을 클릭한 후 키를 즉시 복사하세요.
환경 변수 설정
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 (Command Prompt):
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가 사용하는 경량 모델을 제어합니다.
Claude Code 시작
cd your-project
claude
스크립팅 및 CI의 경우에도 동일한 방식이 적용됩니다:
cat logs.txt | claude -p "오류 패턴을 찾아줘" --output-format json
Novita AI의 LLM API는 도구 사용, 구조화된 출력, 스트리밍을 포함한 Anthropic 메시지 형식을 지원하므로 Claude Code가 수정 없이 작동합니다.
격리된 실행을 위한 에이전트 샌드박스
Claude Code 기반으로 자동화된 파이프라인을 구축하는 경우, Novita AI의 Agent Sandbox는 에이전트 실행을 위한 격리된 환경을 제공하므로 CI 워크플로우 및 다단계 코딩 작업에 유용합니다.
Claude Code를 IDE 도구로 사용하기
Claude Code는 기존 워크플로우를 대체하지 않고 그 안에서 작동하기 때문에 종종 "IDE"로 설명됩니다. 더 정확히 말하면, 터미널, 에디터 및 프로젝트 컨텍스트와 함께 작동하는 에이전트 계층입니다.
VS Code 및 Cursor
VS Code 마켓플레이스 또는 Cursor 마켓플레이스에서 Claude Code 확장을 설치하세요. 설치 후 명령 팔레트를 열고 "Claude Code"를 입력한 다음 새 탭에서 열기 를 선택하세요.
VS Code 통합은 인라인 diff 리뷰, 파일 언급, 편집 전 계획 검토, 에디터 패널 내 대화 기록을 제공합니다. 또한 확장과 함께 통합 터미널에서 Claude Code를 사용할 수 있습니다.
JetBrains
JetBrains 마켓플레이스에서 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 "질문" --output-format json을 사용하세요. --max-budget-usd로 지출을 제한하고 --max-turns로 실행 시간을 제한할 수 있습니다.
Novita AI는 개발자가 간단한 API를 사용하여 AI 모델을 쉽게 배포할 수 있는 AI 클라우드 플랫폼이며, 구축 및 확장을 위한 저렴하고 안정적인 GPU 클라우드도 제공합니다.
추천 문서
- Claude Code 에이전트 사용 방법: 설정, 도구, 권한 및 샌드박스 워크플로우
- Claude Code 플러그인: MCP 도구가 외부 기능으로 Claude Code를 확장하는 방법
- Claude Code 규칙: CLAUDE.md 작성 및 에이전트 코딩 컨텍스트 관리 방법
- Claude MCP: Claude Code 및 Claude Desktop에서 MCP 서버 설정 방법
- Novita AI를 통해 Claude Code에서 DeepSeek V4 Flash 사용 방법
- Claude Code에서 GLM-4.6에 접근하는 방법: 개발자를 위한 완전 설정 가이드
