CoreCode문서

연결

Claude Code

Claude Code의 base URL을 CoreCode로 지정하세요. 명령줄, VS Code 확장, JetBrains 플러그인이 하나의 설정을 공유합니다.

설치

이미 설치했다면 건너뛰세요.

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

npm으로도 설치할 수 있습니다: npm install -g @anthropic-ai/claude-code, Node.js 22 이상이 필요합니다. sudo로 설치하지 마세요. 이어서 claude --version을 실행해 버전이 출력되면 설치가 된 것입니다. Windows 관련 내용과 자주 겪는 문제는 Windows에서 Claude Code 사용에 있습니다.

설정

방법 1: 설정 파일 (권장)

~/.claude/settings.json(Windows는 %USERPROFILE%\.claude\settings.json)을 편집하고, 없으면 새로 만드세요. 이미 내용이 있다면 env 섹션만 병합하세요.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://corecode.live",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key"
  }
}

저장하고 새 터미널을 열어 claude를 실행하면, 이제 모든 프로젝트가 CoreCode를 거칩니다.

방법 2: 환경 변수

export ANTHROPIC_BASE_URL=https://corecode.live
export ANTHROPIC_AUTH_TOKEN=sk-your-key
claude

영구 적용하려면 export 두 줄을 ~/.zshrc 또는 ~/.bashrc에 추가하세요. Windows에서는 setx ANTHROPIC_BASE_URL https://corecode.live와 setx ANTHROPIC_AUTH_TOKEN sk-your-key를 실행한 뒤 터미널을 다시 여세요.

동작 확인

claude -p "reply ok"

ok가 돌아오면 연결된 것입니다. Claude Code에서 /status를 입력하면 Base URL에 https://corecode.live가 표시됩니다. 요청과 과금은 콘솔의 Usage Logs에서 볼 수 있습니다.

공식 로그인과 섞어 쓰지 마세요ANTHROPIC_API_KEY를 함께 설정하지 말고, claude.ai 계정으로 Claude Code에 로그인하지도 마세요. 둘 다 키와 충돌합니다. 이전에 로그인했다면 먼저 Claude Code에서 /logout을 실행하세요. 모델을 바꿀 필요는 없으며, Claude Code 기본 Opus / Sonnet / Haiku가 모두 동작합니다. 모델을 직접 고르려면 claude --model claude-sonnet-5-5를 사용하세요.

VS Code / JetBrains

VS Code용 Claude Code 확장은 명령줄과 ~/.claude/settings.json을 공유합니다. 방법 1처럼 이 파일에 env를 쓰고 VS Code를 완전히 종료한 뒤 다시 열면 확장이 CoreCode를 거칩니다. JetBrains 플러그인은 IDE 터미널에서 명령줄 Claude Code를 실행하므로 설정 방법이 같습니다. 전체 절차와 자주 겪는 문제는 VS Code 및 JetBrains에 있습니다.

이전에 확장에 claude.ai 계정으로 로그인했다면 먼저 로그아웃하세요. 그렇지 않으면 계속 공식 계정을 사용합니다.

권장 설정

ANTHROPIC_BASE_URL과 ANTHROPIC_AUTH_TOKEN만 있으면 됩니다. 아래 옵션은 선택 사항이며, 필요에 따라 ~/.claude/settings.json에 병합하세요.

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://corecode.live",
    "ANTHROPIC_AUTH_TOKEN": "sk-your-key",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_1M_CONTEXT": "1"
  },
  "language": "english"
}
설정효과
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFICAnthropic으로 가는 필수적이지 않은 요청(자동 업데이트, 텔레메트리, 오류 보고, 피드백 명령, 릴리스 노트 등)을 끕니다. Anthropic 서비스에 접속할 수 없을 때 권장합니다. 자동 업데이트가 꺼져 있으면 claude update로 업그레이드하세요.
CLAUDE_CODE_DISABLE_1M_CONTEXT기본이 1M 컨텍스트인 모델을 200K로 제한합니다. 매 턴 보내는 컨텍스트가 줄어 비용이 낮아지는 대신 더 일찍 압축됩니다.
CLAUDE_CODE_PROMPT_CACHE_TTL1h로 설정하면 1시간 캐시를 기록하며, 수십 분씩 자주 쉬는 경우에 유용합니다. 1시간 캐시를 참고하세요.
languageClaude가 답하는 언어입니다. 예: "english", "chinese".
필요 없는 설정일부 릴레이는 Anthropic의 beta 헤더를 전달하지 못해 CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS나 ENABLE_TOOL_SEARCH=false 설정을 요구합니다. CoreCode는 헤더를 그대로 전달하므로 둘 다 설정하지 마세요. 앞의 것은 1시간 캐시와 MCP 도구 검색에 필요한 헤더를 없애고 auto 모드의 서버 측 검토도 꺼서, 도구 호출마다 유료 확인 요청이 앞서게 되며 Anthropic의 안전 분류기가 그 확인을 거부할 수도 있습니다(auto 모드의 비용 참고). 뒤의 것은 매 턴 모든 MCP 도구 정의를 보내므로 MCP가 바뀔 때마다 캐시가 깨집니다.

자주 쓰는 명령어

기본 명령어입니다. 슬래시 명령과 단축키는 명령어 레퍼런스, MCP 서버는 MCP 설정 가이드를 참고하세요.

명령어효과
claude -c이 디렉터리의 가장 최근 세션을 이어서 진행
claude -r이전 세션을 골라 재개
claude -p "…"한 번 질문하고 결과를 출력한 뒤 종료; 스크립트에 적합
claude --model claude-sonnet-5-5특정 모델로 시작
claude updateClaude Code 업그레이드. 현재 버전과 최근 변경 사항은 최신 버전과 릴리스 노트에 있습니다
/status버전, 모델, Base URL, 설정 출처를 표시해 CoreCode를 쓰는지 확인
/usage (or /cost)이 세션의 토큰 사용량과 비용 표시
/context컨텍스트를 차지하는 내용 표시
/compact대화 기록을 압축해 긴 세션에서도 계속 작업
/model모델 전환. 세션 도중에 전환하면 캐시가 무효화됩니다
Shift + Tab권한 모드 순환(기본, 편집 수락, 계획, auto 등)