# Claude Code

> 환경변수 두 개면 돼요.

> 원문: https://oneport.kr/docs/guides/claude-code

```bash
export ANTHROPIC_BASE_URL="https://oneport.kr"
export ANTHROPIC_AUTH_TOKEN="sk-so-..."

claude
```

긴 코딩 세션은 토큰을 많이 써요. 대시보드에서 잔액을 확인하거나, /v1/credits 를 주기적으로 불러 확인할 수 있어요.

> **MCP 는 쓰시던 설정 그대로 돼요**
>
> MCP 서버는 Claude Code 쪽에서 돌고 저희는 그 도구 호출을 중계해요. 스트리밍으로 도구를 부르는 것까지 실제 응답으로 확인했어요. 저희가 MCP 서버를 따로 드리는 건 아니라서, 쓰시던 서버 설정은 건드리지 않으셔도 돼요.

## 잘 붙었는지 확인

claude 를 켜기 전에 키가 사는지 먼저 보세요. 이 문은 모델을 안 부르니 요금이 안 붙어요.

**요금 없이 확인**

```bash
curl "$ANTHROPIC_BASE_URL/v1/credits" -H "x-api-key: $ANTHROPIC_AUTH_TOKEN"
```

## 무엇이 되나

Claude Code 는 /v1/messages 로 붙어요. 그 문은 몸통을 번역하지 않고 그대로 넘기기 때문에 스트리밍 · 도구 호출 · 그림 · 생각(thinking) · 프롬프트 캐싱이 Anthropic 에서처럼 돼요. 저희가 새 기능을 배선할 때까지 기다리실 게 없어요. 웹 검색도 돼요 — 검색 1회에 $0.01씩 토큰과 같이 빠져요. 벤더 서버 도구 중 요금을 셀 수 없는 것(혼자 쓰는 code_execution)만 400 으로 돌려드려요 — 모델과 단가의 「벤더 서버 도구 요금」을 보세요.

> **⚠️ Claude 아닌 모델은 안 돼요**
>
> 이 경로는 Anthropic 형식이라 GPT · Gemini · Grok 은 못 불러요. 한 도구에서 여러 벤더를 섞으시려면 OpenAI 호환 주소를 넣는 도구(Codex CLI · Cursor · Cline)를 쓰시는 편이 맞아요.

## 모델 고르기

환경변수만 바꾸면 Claude Code 는 기본 모델을 그대로 써요. 다른 모델로 돌리시려면 --model 에 우리 목록의 id 를 그대로 넣으시면 돼요.

**이 세션만 다른 모델로**

```bash
claude --model claude-opus-5-5
```

## 매번 안 치려면

**~/.zshrc 나 ~/.bashrc 에**

```bash
export ANTHROPIC_BASE_URL="https://oneport.kr"
export ANTHROPIC_AUTH_TOKEN="sk-so-..."
```

## 안 될 때

- 404 가 난다 — ANTHROPIC_BASE_URL 끝에 /v1 을 붙이셨는지 보세요. Claude Code 가 /v1/messages 를 스스로 붙여서 두 번 붙어요. 저희 주소는 oneport.kr 까지만 적습니다.
- 401 이 난다 — 키가 폐기됐거나 오타예요. 대시보드에서 키 상태를 보시고, 값 앞뒤 따옴표·공백도 확인해주세요.
- 429 가 난다 — 그 키의 이번 달 한도에 닿았어요. 분당 제한은 저희가 안 걸어요. 대시보드에서 한도를 올리시면 바로 풀려요.
- 긴 세션이 중간에 끊긴다 — 한 호출을 기다리는 시간이 5분이에요. 아주 긴 답을 한 번에 받으시는 대신 나눠 물어보시면 안정적이에요.

## 원래대로 되돌리기

환경변수 두 개를 지우면 그대로 Anthropic 직접 연결로 돌아가요. 저희 쪽에 남는 설정이 없어서 언제든 되돌리실 수 있어요.

**직접 연결로**

```bash
unset ANTHROPIC_BASE_URL ANTHROPIC_AUTH_TOKEN
```