신규잘못된 모델을 올린 판매자를 어떻게 잡아내고 환불하는지 알려 드립니다.

Claude Code

Claude Code는 Anthropic 호환 주소, https://api.martllm.com를 통해 MartLLM과 통신합니다. 주소와 키가 설정되면 Claude Code의 명령 및 도구는 이전과 동일하게 작동하며, 요청은 MartLLM 잔액으로 청구됩니다.

직접 설정하기

Claude Code 자체만 실행하면 됩니다. 키 페이지]에서 키를 만드세요. 그런 다음:

export ANTHROPIC_BASE_URL=https://api.martllm.com
export ANTHROPIC_AUTH_TOKEN=ull_your_key
claude

Windows PowerShell:

$env:ANTHROPIC_BASE_URL = "https://api.martllm.com"
$env:ANTHROPIC_AUTH_TOKEN = "ull_your_key"
claude

이것은 현재 터미널에서만 지속됩니다. 쉘 프로필에 키 없이 유지하려면, 본인만 읽을 수 있는 파일에 키를 저장하세요:

mkdir -p ~/.uberllm && chmod 700 ~/.uberllm
printf '%s\n' 'ull_your_key' > ~/.uberllm/key && chmod 600 ~/.uberllm/key

그리고 이것을 ~/.claude/settings.json (모든 프로젝트) 또는 <project>/.claude/settings.local.json (하나의 프로젝트)에 넣으세요:

{
  "apiKeyHelper": "cat ~/.uberllm/key",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.martllm.com"
  }
}

또는 설치 프로그램을 사용하세요

Node.js가 있다면, 하나의 명령으로 Claude Code와 다른 코딩 도구들(Codex CLI, OpenCode 등)을 아래 설치 프로그램과 동일한 설정으로 컴퓨터에 설정할 수 있습니다:

npx uberllm init

uberllm init에서 무엇이 변경되는지, 그리고 어떻게 되돌릴 수 있는지 확인하세요.

설치 프로그램이 동일한 작업을 수행하며 브라우저를 통해 키를 가져옵니다. 원한다면 먼저 읽어보세요: 다음 주소에서 일반 텍스트로 확인할 수 있습니다: martllm.com/install/claude-code.sh.

  • claude-code.sh의 SHA-256: 34646d5a83e25a1c19057a6bca6aeaaf0118e0e43704d5dbb01e49ab15eb625f
  • claude-code.ps1의 SHA-256: 5caaa5f15f3e846c535e6668687fe9e0bdcf1e4f9a8a370af09a5137005f44b4

실행하기 전에 확인하려면:

curl -fsSL https://martllm.com/install/claude-code.sh -o claude-code.sh
shasum -a 256 claude-code.sh   # compare with the hash above
sh claude-code.sh

이 컴퓨터의 모든 프로젝트:

curl -fsSL https://martllm.com/install/claude-code.sh | sh

하나의 프로젝트만 (프로젝트 안에서 실행하세요; 다른 프로젝트는 Anthropic 플랜을 유지합니다):

curl -fsSL https://martllm.com/install/claude-code.sh | sh -s -- --project

--project 뒤에 폴더를 추가하여 현재 프로젝트 외의 다른 프로젝트를 설정하세요.

Windows PowerShell (모든 프로젝트):

irm https://martllm.com/install/claude-code.ps1 | iex

먼저 API key가 필요하지 않으며, 명령어를 붙여넣을 때 로그인할 필요도 없습니다. 설치 프로그램이 브라우저에서 링크(https://martllm.com/cli/link?code=XXXX-XXXX)를 열고 터미널에 동일한 확인 코드를 출력합니다. 로그인하고, 코드가 일치하는지 확인한 다음, 승인을 누르세요.

승인하면 계정에 API key가 생성되고 대기 중인 설치 프로그램에 전달됩니다. 터미널의 코드는 비밀이 아닙니다: 요청을 시작한 설치 프로그램만 키를 수집할 수 있으며, 키는 정확히 한 번만 전달되고, 요청은 15분 후에 만료됩니다.

이 컴퓨터에 Claude Code가 한 번도 설정된 적이 없다면, 먼저 모든 프로젝트 설치를 사용하세요. Claude Code는 해당 폴더를 신뢰한 후에만 프로젝트 자체 설정을 읽으므로, 새로운 설치라도 로그인하라고 요청할 수 있습니다.

아무것도 작성하지 않고 컴퓨터의 설정 블록을 출력하려면:

curl -fsSL https://martllm.com/install/claude-code.sh | sh -s -- --print

설치 프로그램이 쓰는 내용

키는 사용자만 읽을 수 있는 파일에 저장됩니다 (폴더 모드 700, 파일 모드 600):

설치 키 파일 설정 파일
모든 프로젝트 ~/.uberllm/key ~/.claude/settings.json (또는 $CLAUDE_CONFIG_DIR/settings.json)
단일 프로젝트 ~/.uberllm/key-<folder>-<number> <project>/.claude/settings.local.json

설정 파일은 주소와 키 파일을 읽는 apiKeyHelper을 가져옵니다. 키 자체는 설정 파일에 절대 기록되지 않으므로 백업, dotfiles 저장소 또는 화면 공유에 노출되지 않습니다.

{
  "apiKeyHelper": "cat \"/Users/you/.uberllm/key\"",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.martllm.com",
    "CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY": "1"
  }
}

Claude Code는 키를 가져오기 위해 apiKeyHelper을 실행하고 Authorization: Bearer과 x-api-key 둘 다로 보내므로 MartLLM과 같은 게이트웨이와 함께 작동합니다. 답변을 5분 동안 유지합니다 (CLAUDE_CODE_API_KEY_HELPER_TTL_MS이 이를 변경합니다).

설치 프로그램은 기존 파일을 교체하는 대신 병합하므로 훅, 권한 및 MCP 서버가 유지되며, 먼저 이전 파일을 <file>.bak-<timestamp>로 복사합니다. 이전 설치로 인해 남겨진 일반 텍스트 ANTHROPIC_AUTH_TOKEN를 제거합니다. 그런 다음 게이트웨이를 통해 실제 요청을 한 번 수행하므로 성공 메시지는 요청이 통과했음을 의미합니다.

Windows 설치 프로그램은 여전히 키를 settings.json에 ANTHROPIC_AUTH_TOKEN로 기록합니다.

어떤 설정이 우선할까요

Claude Code는 다음 순서로 설정을 읽으며, 첫 번째 설정이 우선합니다:

  1. 관리형 설정 (해당하는 경우 회사에서 설정)
  2. claude --settings <file>
  3. <project>/.claude/settings.local.json
  4. <project>/.claude/settings.json
  5. ~/.claude/settings.json

대부분의 세션에서 설정 파일의 env 블록에 있는 변수가 셸에 있는 동일한 변수보다 우선합니다. 여기서 중요한 두 가지 예외가 있습니다:

  • 키. Claude Code는 먼저 ANTHROPIC_AUTH_TOKEN를 사용하고, 그 다음 ANTHROPIC_API_KEY, 그리고 apiKeyHelper을 사용합니다. 셸에서 내보낸 token은 저장된 키를 대체합니다.
  • 모델. 세션의 /model이 우선하고, 그 다음 claude --model, 그 다음 ANTHROPIC_MODEL, 그리고 model 설정이 우선합니다. 셸 ANTHROPIC_MODEL는 model 설정을 이깁니다.

따라서 셸과 셸 프로필(~/.zshrc, ~/.bashrc)에서 모든 ANTHROPIC_* 변수를 제거하고 설정 파일에 보관하세요. 설치 프로그램은 해당 변수를 찾으면 경고합니다.

다른 모델 사용하기

기본적으로 아무것도 고정되어 있지 않습니다: Claude Code는 자체 모델 이름을 요청하며 (opus, sonnet, haiku, claude-opus-5-5…), MartLLM은 동일한 Claude 모델을 제공합니다. DeepSeek, GLM, Qwen, GPT 또는 다른 모델로 Claude Code를 구동하려면, Claude Code의 각 모델 슬롯을 env 블록에서 MartLLM 모델 ID에 매핑하세요:

변수 설정하는 내용
ANTHROPIC_MODEL 세션이 시작되는 모델.
ANTHROPIC_DEFAULT_OPUS_MODEL opus가 의미하는 것.
ANTHROPIC_DEFAULT_SONNET_MODEL sonnet이 의미하는 것.
ANTHROPIC_DEFAULT_HAIKU_MODEL haiku이 의미하는 것. Claude Code는 제목 및 요약과 같은 백그라운드 작업에도 이를 사용합니다.
CLAUDE_CODE_SUBAGENT_MODEL 서브 에이전트가 실행되는 모델.
{
  "apiKeyHelper": "cat \"/Users/you/.uberllm/key\"",
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.martllm.com",
    "ANTHROPIC_MODEL": "deepseek/deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek/deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek/deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek/deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek/deepseek-v4-pro"
  }
}

모든 슬롯을 매핑하세요. 설정되지 않은 슬롯은 계속해서 Claude 모델을 요청하며, 해당 모델에 대해 Claude 가격을 지불하게 됩니다.

설치 프로그램이 프로필을 사용하여 이 작업을 수행합니다:

curl -fsSL 'https://martllm.com/install/claude-code.sh?profile=glm' | sh

프로필은 claude-native (기본값, 아무것도 고정하지 않음), glm, deepseek 및 gpt입니다. 모델 테이블에서 가져온 모든 모델 ID는 변수를 수동으로 설정하면 작동합니다; GET https://api.martllm.com/v1/models에 나열되어 있습니다.

컨텍스트 및 압축

Claude Code는 Claude 모델의 컨텍스트 크기만 알고 있습니다. 다른 모델의 경우 200,000 토큰으로 가정하고 그 전에 대화를 압축합니다.

  • 모델이 1-million-token 컨텍스트를 가지고 있다면 (martllm.com 페이지에 컨텍스트가 표시됨), ID 끝에 [1m]을 추가하세요. 예를 들어 "ANTHROPIC_MODEL": "deepseek/deepseek-v4-pro[1m]" 또는 claude --model 'deepseek/deepseek-v4-pro[1m]'와 같이요. 그러면 Claude Code는 1M을 계획합니다.
  • 다른 크기의 경우, 모델의 컨텍스트에 CLAUDE_CODE_MAX_CONTEXT_TOKENS을 설정하세요. 예를 들어 "CLAUDE_CODE_MAX_CONTEXT_TOKENS": "400000"와 같이요.
  • 압축 시점을 선택하려면: autoCompactWindow 설정 (또는 CLAUDE_CODE_AUTO_COMPACT_WINDOW 변수)은 100,000부터 1,000,000까지의 토큰 수를 받습니다. CLAUDE_AUTOCOMPACT_PCT_OVERRIDE (1–100)는 창의 해당 비율에서 더 일찍 압축합니다. autoCompactEnabled: false은 이 기능을 끕니다.

모델이 가진 것보다 더 큰 컨텍스트를 설정하면 대화가 모델의 용량을 초과할 때 요청이 실패하게 됩니다.

달라지는 점

  • claude.ai 로그인은 사용되지 않습니다. claude.ai 커넥터, /schedule, Remote Control 등 로그인이 필요한 기능은 MartLLM에서 실행되는 세션에서 사용할 수 없습니다.
  • Claude Code에 표시되는 비용은 실제 청구 금액이 아닙니다. Claude Code는 사용자의 컴퓨터에서 Anthropic 정가를 기준으로 비용을 계산하므로, 다른 모델에 대해서는 유용한 정보가 표시되지 않습니다. 실제 결제 금액은 대시보드 → API Keys → API Usage에서 확인할 수 있습니다. 작업하는 동안 확인할 수 있도록 상태 표시줄(아래)에 잔액을 추가해 보세요.
  • 코드가 서드파티 모델 제공업체로 전송됩니다. 세션에서 읽은 모든 내용은 모델로 전송되며, 해당 모델은 MartLLM 마켓의 서드파티 모델 제공업체가 운영합니다. 비밀 정보, 자격 증명 또는 고객 데이터가 포함된 레포지토리에서는 사용하지 마세요.

상태 표시줄의 잔액

curl -fsSL https://martllm.com/install/statusline.sh | sh -s -- --install

이것은 작은 스크립트를 ~/.uberllm/statusline.sh에 저장하고 Claude Code의 statusLine으로 ~/.claude/settings.json에 추가합니다 (대신 이 프로젝트의 .claude/settings.local.json에 넣으려면 --install 뒤에 --project를 추가하세요). 그러면 프롬프트 아래에 다음이 표시됩니다:

MartLLM $12.40 · $0.35 held · Opus

그것은 사용 가능한 잔액, 아직 실행 중인 요청을 위해 보류된 금액, 그리고 모델입니다. 이것은 Claude Code가 사용하는 동일한 키로 GET /v1/balance을 읽으며, 최대 1분에 한 번 작동합니다. 이것은 오직 sh, curl 그리고 sed만 필요합니다. 먼저 martllm.com/install/statusline.sh](martllm.com/install/statusline.sh](https://martllm.com/install/statusline.sh))에서 읽어보세요.

확인하기

Claude Code를 시작하고 /status을 실행하세요. API 주소는 https://api.martllm.com입니다. 그런 다음 아무 질문이나 입력해 보세요. 1분 이내에 대시보드 → API 키 → API 사용량에 요청 내역이 표시됩니다.

동일한 키로 Messages API에서도 응답을 받을 수 있습니다:

curl https://api.martllm.com/v1/messages \
  -H "Authorization: Bearer $(cat ~/.uberllm/key)" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-haiku-4-5","max_tokens":16,"messages":[{"role":"user","content":"ping"}]}'

요청이 Your apiKeyHelper script is failing(으)로 실패하면 키 파일이 없거나 읽을 수 없는 상태입니다. 설치 프로그램을 다시 실행해 주세요.

제거 및 취소

curl -fsSL https://martllm.com/install/claude-code.sh | sh -s -- --uninstall

단일 프로젝트 설치의 경우, 프로젝트 내에서 sh -s -- --project --uninstall을(를) 실행하세요. 먼저 설정 파일을 백업하고, 추가했던 것만 제거하며, 저장된 키 파일을 삭제합니다. 다음 시작 시 Claude Code는 Anthropic 로그인으로 돌아갑니다.

제거한다고 해서 키가 취소되는 것은 아닙니다. 단순히 사용을 중단하는 것뿐입니다. 키가 다시는 사용되지 않도록 키 페이지에서 키를 삭제하세요. 더 이상 신뢰하지 않는 컴퓨터나, 시작하지 않은 요청을 승인한 경우에도 그렇게 하세요.