Claude / Claude Code 설정

Claude Code는 Anthropic 공식 터미널 CLI AI 코딩 어시스턴트입니다. 4AICode API로 연결하면 키·팀 할당량·사용량을 한 콘솔에서 관리하고, 실제 토큰 사용량 기준으로 과금됩니다.

💡 초보자 팁: **[방법 1: 빠른 스크립트 설치 및 설정]**부터 시작하는 것을 권장합니다. 한 번의 명령으로 자동 설정됩니다.

라인 선택: 4AICode는 계정·토큰을 공유하는 두 네트워크 라인을 제공합니다.

• 국제 라인(전 세계 사용자 권장): https://relay.4aicode.com
• 중국 본토 직접 연결 라인: https://relay.4aicode.net(본토 직접 연결에 더 안정적)

사전 준비: 토큰 받기

어떤 설정 방법이든 먼저 4AICode 토큰이 필요합니다.

1. 4AICode에 로그인해 대시보드 → 토큰 관리(본토는 4aicode.net/tokens)로 이동.
2. "New Token" 클릭.
3. 생성된 문자열 복사(sk-4ai-<your-token> 형식).

⚠️ 보안 주의:

• 토큰은 생성 시 한 번만 표시됩니다. 비밀번호 관리자나 메모 앱에 저장하세요.
• 가이드의 sk-4ai-<your-token>는 placeholder입니다. 실제 토큰으로 바꾸세요.
• 비밀번호처럼 취급하고 공유·GitHub 커밋 금지. 셸에 직접 입력하면 히스토리에 남을 수 있으니 필요 시 history -c 등으로 지우세요.

방법 1: 빠른 스크립트 설치 및 설정(초보자 권장)

운영체제에 맞는 탭을 선택하세요.

# Official installer command
curl -fsSL https://claude.ai/install.sh | bash

# International route (recommended for overseas/global network)
cat <<'EOF' >> ~/.zshrc
export ANTHROPIC_BASE_URL=https://relay.4aicode.com
export ANTHROPIC_AUTH_TOKEN=sk-4ai-<your-token>
export ANTHROPIC_API_KEY=sk-4ai-<your-token>
EOF
source ~/.zshrc

# Note: bash를 쓰면(일부 Linux) ~/.zshrc 대신 ~/.bashrc

claude

방법 2: 전역 설정 파일(깔끔한 방식)

환경 변수 외에 Claude Code는 settings.json 전역 설정을 지원합니다. 셸을 깔끔하게 유지하고 설정이 안정적으로 유지됩니다.

설정 파일 경로:

• macOS / Linux: ~/.claude/settings.json
• Windows: %USERPROFILE%\.claude\settings.json

파일을 열거나 만들고 env 키 아래에 설정(기존 설정이 있으면 유지하고 env 병합):

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://relay.4aicode.com",
    "ANTHROPIC_AUTH_TOKEN": "sk-4ai-<your-token>",
    "ANTHROPIC_API_KEY": "sk-4ai-<your-token>"
  }
}

저장 후 터미널 또는 Claude Code를 재시작해 적용.

고급: Claude Code에서 다른 상위 모델 사용

4AICode 백엔드 게이트웨이는 지능형 모델 라우팅을 제공합니다. Claude Code 터미널 UI를 쓰면서 내부적으로 ChatGPT(GPT-5.6 / GPT-6) 또는 Kimi K3를 실행할 수 있습니다.

0. Claude Code에서 Claude Opus 5.5 Kiro(가성비)

Claude Opus 5.5 Kiro는 4AICode 전용 Claude Code 최적화 버전으로 할인 요금을 제공합니다.

# Using Claude Opus 5.5 Kiro (Recommended)
export ANTHROPIC_BASE_URL=https://relay.4aicode.com
export ANTHROPIC_AUTH_TOKEN=sk-4ai-<your-token>
export ANTHROPIC_DEFAULT_OPUS_MODEL=claude-opus-5-5-kiro
export ANTHROPIC_MODEL=opus
claude

적합 용도:

• 복잡한 코드 생성·아키텍처 설계
• 다단계 추론·문제 해결
• 대규모 컨텍스트(200K tokens)
• 기술 문서 작성·코드 리뷰

1. Claude Code에서 ChatGPT 모델 사용

모델 환경 변수만 설정하면 됩니다. /v1/messages 요청 시 게이트웨이가 요청된 gpt-* 모델에 맞는 업스트림을 선택합니다.

# Recommended daily driver: GPT-5.6 Terra
export ANTHROPIC_BASE_URL=https://relay.4aicode.com
export ANTHROPIC_AUTH_TOKEN=sk-4ai-<your-token>
export ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-5.6-terra
export ANTHROPIC_MODEL=opus
claude

# Top-tier flagship: GPT-6 Astra
export ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-6-astra
export ANTHROPIC_MODEL=opus
claude

# Complex architecture & deep reasoning: GPT-5.6 Sol with ultra-high reasoning
export ANTHROPIC_BASE_URL=https://relay.4aicode.com
export ANTHROPIC_AUTH_TOKEN=sk-4ai-<your-token>
export ANTHROPIC_DEFAULT_OPUS_MODEL=gpt-5.6-sol
export ANTHROPIC_DEFAULT_OPUS_MODEL_NAME="4AICode GPT 5.6 Sol"
export ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTED_CAPABILITIES=effort,xhigh_effort,thinking,adaptive_thinking,interleaved_thinking
export ANTHROPIC_MODEL=opus
export ANTHROPIC_DEFAULT_HAIKU_MODEL=gpt-5.4-mini
export CLAUDE_CODE_EFFORT_LEVEL=xhigh
claude

2. Claude Code에서 Kimi K3(초장문 1M 컨텍스트)

대규모 코드베이스·문서 분석이 필요하면 Kimi K3를 연결하세요. 전용 가이드: 👉 Claude Code에서 Kimi K3 사용

기타 도구 및 SDK 연동

4AICode는 공식 Anthropic API 사양과 완전 호환되어 Anthropic SDK·도구와 원활하게 연동됩니다.

1. 통합 연결 매개변수

• Base URL: https://relay.4aicode.com(본토는 https://relay.4aicode.net)
• API Key / Token: 4AICode Token(sk-4ai-<your-token>)

2. Node.js / TypeScript SDK

import Anthropic from "@anthropic-ai/sdk";

const client = new Anthropic({
  baseURL: "https://relay.4aicode.com",
  apiKey: "sk-4ai-<your-token>",
});

const msg = await client.messages.create({
  model: "claude-sonnet-4-6",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Hello!" }],
});

console.log(msg.content);

3. Python SDK

import anthropic

client = anthropic.Anthropic(
    base_url="https://relay.4aicode.com",
    api_key="sk-4ai-<your-token>",
)

message = client.messages.create(
    model="claude-sonnet-4-6",
    max_tokens=1024,
    messages=[
        {"role": "user", "content": "Hello, please write a quicksort algorithm."}
    ]
)

print(message.content[0].text)

4. cURL 예제

4AICode는 Anthropic 공식 x-api-key 헤더와 표준 Authorization: Bearer 헤더를 모두 지원합니다.

# Option A: Using x-api-key (Anthropic standard)
curl https://relay.4aicode.com/v1/messages \
  -H "x-api-key: sk-4ai-<your-token>" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 128,
    "messages": [{"role": "user", "content": "ping"}]
  }'

# Option B: Using Authorization: Bearer
curl https://relay.4aicode.com/v1/messages \
  -H "Authorization: Bearer sk-4ai-<your-token>" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-4-6",
    "max_tokens": 128,
    "messages": [{"role": "user", "content": "ping"}]
  }'

자주 묻는 질문(FAQ)

Q1: claude: command not found 또는 명령을 인식하지 못함?

• 원인: Claude Code 미설치 또는 PATH 미갱신.
• 조치: 터미널 완전 종료 후 재실행. 지속 시:
  • macOS/Linux: curl -fsSL https://claude.ai/install.sh | bash 재실행, ~/.local/bin이 PATH에 있는지 확인.
  • Windows: PowerShell에서 irm https://4aicode.com/claude-install.ps1 | iex(PATH 자동 설정).

Q2: 401 Unauthorized 또는 invalid token?

• 원인: 토큰 오류, 복사 누락, placeholder 미교체.
• 조치: 대시보드 → 토큰 관리에서 확인·재생성. sk-4ai-로 시작하는지 확인.

Q3: 환경 변수·settings.json 변경이 적용되지 않음?

• 원인: 터미널 프로세스가 이전 변수 캐시, 또는 settings.json이 환경 변수보다 우선.
• 조치: Claude 세션 완전 종료 후 터미널 재시작. settings.json 값이 터미널 환경 변수를 덮어씁니다.

Q4: HTTP 오류 코드