코딩 에이전트 커스텀 API 치트시트: 토큰 비용을 절감하는 복사-붙여넣기용 설정 가이드

모든 인기 코딩 에이전트는 내부 모델을 교체할 수 있는 기능을 제공하지만, 각 에이전트는 설정을 서로 다른 파일, 키 이름, URL 형식으로 숨겨두고 있습니다. 이 때문에 사람들은 포기하고 비싼 최신 모델 비용을 계속 지불하게 됩니다. 실제로 헤비 에이전트 사용자는 기본 모델을 사용할 때 개발자 1인당 하루 약 13달러를 소비하기도 합니다(CloudZero, 2026). 이 페이지는 그 문제를 해결합니다. Claude Code, OpenClaw, Codex, OpenCode, Cursor를 위한 정확한 커스텀 API 설정과 이들 간의 차이를 결정짓는 단 하나의 핵심 구분을 한곳에 정리했습니다. 이 페이지를 즐겨찾기에 추가하세요. 여기서 제공하는 가치는 불필요한 설명이 아니라, 바로 복사해서 붙여넣을 수 있는 코드 블록과 주의사항입니다. 이 글을 다 읽을 때쯤이면 어떤 에이전트든 몇 분 안에 더 저렴한 모델로 연결할 수 있으며, 도구마다 URL 형식이 왜 다른지 완벽히 이해하게 될 것입니다.

핵심 요약

• 코딩 에이전트는 두 개의 프로토콜 계열로 나뉩니다. Claude Code는 Anthropic API를 사용하고, OpenClaw, Codex, OpenCode, Cursor는 OpenAI 호환 API를 사용합니다.
• 가장 실용적인 구분법은 URL입니다. OpenAI 호환 도구는 /v1 접미사를 필요로 하지만, Claude Code는 그렇지 않습니다.
• 모든 설정에는 Base URL, API 키, 모델 ID라는 세 가지 요소가 필요합니다. 단지 필드 이름만 다를 뿐입니다.
• 오픈 웨이트(Open-weight) 모델이 비용 절감의 핵심입니다. DeepSeek V4 Flash는 100만 입력 토큰당 약 0.14달러 수준인 반면, 최신 모델은 수 달러에 달합니다(Codersera, 2026).

코딩 에이전트 커스텀 API 치트 시트가 필요한 이유

이 작업을 하는 이유는 비용 때문이며, 원인은 구조적인 문제에 있습니다. 에이전트는 추론 단계를 거칠 때마다 누적된 컨텍스트를 반복해서 전송하므로, 일반적인 채팅창보다 10~100배 더 많은 토큰을 소모합니다(LeanOps, 2026). 에이전트 사용 비용이 급증하는 이유가 바로 이 배수 때문이며, 에이전트 사용을 줄이는 대신 토큰 가격을 재조정하는 것이 실제로 효과적인 해결책입니다. 커스텀 API를 사용하면 작업 방식을 바꾸지 않고도 에이전트를 더 저렴한 백엔드에 연결할 수 있습니다. 일상적인 코딩 작업을 오픈 웨이트 모델로 연결하면 토큰당 비용이 70% 이상 급격히 줄어들면서도 일상 작업의 품질 차이는 거의 없습니다. 이 치트 시트가 중요한 이유는 절감 효과는 확실하지만, 설정 과정의 번거로움("어떤 파일, 어떤 필드, 어떤 URL인가")이 사람들을 가로막기 때문입니다.

코딩 에이전트 커스텀 API 치트 시트의 작동 방식

설정으로 들어가기 전, 모든 설정을 관통하는 한 가지 개념을 이해해야 합니다. 코딩 에이전트는 두 개의 프로토콜 계열로 나뉘며, 도구가 어느 계열에 속하느냐에 따라 설정 형태가 결정됩니다. Claude Code는 Anthropic Messages API와 통신하므로 ANTHROPIC_BASE_URL에서 백엔드를 읽고 Anthropic 스타일의 토큰으로 인증합니다. 이 치트 시트의 나머지 도구(OpenClaw, Codex, OpenCode, Cursor)는 모두 OpenAI 호환 Chat Completions API와 통신하므로 baseURL과 OpenAI 스타일의 키를 사용하며, 엔드포인트 경로에 /v1을 붙여야 합니다. 이 /v1이라는 세부 사항이 설정을 실패하게 만드는 가장 흔한 원인입니다. 이 차이를 알고 나면 아래의 모든 항목은 이름만 다를 뿐, Base URL, 키, 모델 ID라는 세 가지 값으로 구성되어 있음을 알 수 있습니다. 예시에서는 Atlas Cloud를 제공자로 사용합니다. 하나의 계정에서 두 프로토콜 계열을 모두 지원하므로 도구별로 문법만 바뀔 뿐, 붙여넣을 키는 동일합니다. 다른 호환 제공자도 같은 방식으로 작동하며, Base URL과 키만 바꿔서 사용하면 됩니다.

코딩 에이전트 커스텀 API 치트 시트: 도구별 설정

먼저 요약 표를 확인한 뒤, 각 도구의 전체 설정 블록을 살펴보세요. 시작하기 전에 API 키를 준비하세요. Atlas Cloud의 경우, 키 타입으로 Coding Plan을 선택하여 생성하면 크레딧 기반 코딩 할당량과 연동됩니다.

Claude Code

Claude Code는 Anthropic 계열의 예외 도구이므로 Base URL에 /v1을 넣지 않아야 합니다. macOS/Linux에서는 ~/.claude/settings.json을, Windows에서는 %USERPROFILE%.claude\settings.json을 수정하세요.

JSONCopy
1{
2  "env": {
3    "ANTHROPIC_AUTH_TOKEN": "your-atlas-api-key",
4    "ANTHROPIC_BASE_URL": "https://api.atlascloud.ai",
5    "ANTHROPIC_MODEL": "zai-org/glm-5.1",
6    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "zai-org/glm-5.1",
7    "ANTHROPIC_DEFAULT_SONNET_MODEL": "zai-org/glm-5.1",
8    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1"
9  }
10}

Haiku 및 Sonnet 기본값을 동일한 모델로 설정하면 Claude Code의 작은 백그라운드 호출도 지정한 모델로 라우팅되어, 기본 모델을 찾을 수 없을 때 발생하는 오류를 방지할 수 있습니다.

OpenClaw

OpenClaw는 마법사 기능이 있어 가장 설정하기 쉽습니다. 터미널에서 openclaw onboard를 실행한 후 Yes, QuickStart, Custom Provider를 차례로 선택합니다. Base URL로 https:​//api.atlascloud.ai/v1을 입력하고, 키와 모델 ID를 붙여넣은 뒤 OpenAI-compatible 프로토콜을 선택하세요. Verification successful 메시지가 뜨면 엔드포인트 이름을 지정하고 완료합니다. ~/.openclaw/openclaw.json을 직접 수정할 경우 주의할 점은 2단계 설정이 필요하다는 것입니다. models.providers 아래에 제공자를 정의한 다음, 반드시 agents.defaults.models 항목에 provider-name/model-name 형식으로 모델을 화이트리스트에 추가해야 합니다(OpenClaw docs, 2026). 이를 누락하는 것이 "model not allowed" 오류의 주원인입니다. 마법사를 사용하면 이 두 단계를 자동으로 처리해주므로 마법사 사용을 권장합니다.

Codex

Codex는 두 개의 파일을 사용합니다. ~/.codex/config.toml에 제공자를 설정합니다.

TOMLCopy
1model_provider = "atlas_coding_plan"
2model = "zai-org/glm-5.1"
3
4[model_providers.atlas_coding_plan]
5name = "atlascloud"
6base_url = "https://api.atlascloud.ai/v1"
7wire_api = "chat"
8requires_openai_auth = true

그다음 ~/.codex/auth.json에 키를 넣습니다.

JSONCopy
1{ "OPENAI_API_KEY": "your-atlas-api-key" }

터미널에서 codex를 실행하고 업데이트 프롬프트를 건너뛰면 연결이 완료됩니다.

OpenCode 및 Cursor

OpenCode는 ~/.config/opencode/opencode.json(Windows의 경우 \Users\사용자명.config\opencode\opencode.json)을 읽습니다.

JSONCopy
1{
2  "$schema": "https://opencode.ai/config.json",
3  "provider": {
4    "atlascloud": {
5      "npm": "@ai-sdk/openai-compatible",
6      "name": "atlascloud",
7      "options": {
8        "baseURL": "https://api.atlascloud.ai/v1",
9        "apiKey": "your-atlas-api-key"
10      },
11      "models": {
12        "zai-org/glm-5.1": { "name": "glm-5.1" }
13      }
14    }
15  }
16}

Cursor에는 별도의 설정 파일이 없습니다. [Settings] -> [Models]로 이동하여 모델 ID를 직접 입력한 뒤, 커스텀 OpenAI Base URL에 https:​//api.atlascloud.ai/v1을 넣고 키를 붙여넣으세요. Cursor는 OpenAI 호환 방식을 따르므로 다른 도구와 동일한 Base URL과 키가 그대로 적용됩니다.

---

모델 선택: 비용 절감의 나머지 절반

엔드포인트 연결은 작업의 절반일 뿐입니다. 절감액을 결정하는 것은 결국 선택한 모델입니다. 일상적인 코딩은 가성비 좋은 오픈 모델을 기본값으로 사용하고, 가장 어려운 추론 작업에만 최신 모델을 사용하는 패턴이 효과적입니다. 능력치 차이는 가격 차이보다 훨씬 작습니다. SWE-Bench Pro에서 주요 오픈 모델은 70점대 후반의 점수를 기록하며, 최신 모델(약 91점)과 비교해도 일상적인 기능 구현이나 리팩토링에서는 차이를 느끼기 어렵습니다(Codersera, 2026). 크레딧 기반 제공자에서는 모델마다 토큰 사용량에 곱해지는 배율이 있어 상대적 비용을 쉽게 파악할 수 있습니다.

출처: Atlas Cloud Coding Plan 크레딧 규칙. 크레딧 비용 = 입력 토큰 × 입력 배율 + 출력 토큰 × 출력 배율. 실용적인 기본값: 대화형 코딩에는 GLM-5.1 또는 Kimi K2.6, 대량 처리나 백그라운드 작업에는 DeepSeek V4 Flash를 추천하며, 오픈 모델이 도저히 해결하지 못하는 드문 작업에만 최신 모델을 사용하세요. 설정을 바꾸는 것은 위 설정 파일에서 모델 ID 한 줄만 수정하면 됩니다.

모든 코딩 에이전트에서 하나의 API 키 사용하기

치트 시트 표에서 볼 수 있듯이, 모든 설정에서 동일한 키와 모델 ID를 사용합니다. 이것이 통합 제공자를 사용해야 하는 진짜 이유입니다. 도구마다 다른 업체를 사용하면 키, 대시보드, 청구서가 각각 관리되어 전체 지출을 한눈에 파악하기 어렵습니다. 모든 도구를 하나의 제공자로 연결하면 하나의 크레딧 풀로 통합되어 모델 관리도 훨씬 수월해집니다. 또한 토큰 기반 과금 체계에서 어려운 예산 관리를 해결할 수 있습니다. 매일 정해진 크레딧이 새로 고침되는 요금제를 사용하면 에이전트 루프가 꼬여 비용이 폭주하는 것을 방지할 수 있습니다. Atlas Cloud의 요금제는 월 10달러부터 시작하며, 종량제 팩은 41% 할인 혜택이 제공됩니다.

코딩 에이전트 커스텀 API 치트 시트: 흔한 실수

설정 실패 사례의 대부분은 아래 실수 중 하나입니다. 모두 금방 수정할 수 있습니다. /v1 혼동: 이 치트 시트에서 가장 흔한 오류입니다. OpenAI 호환 도구는 /v1 접미사가 필요하지만 Claude Code는 그렇지 않습니다. 연결 오류가 발생한다면 해당 도구 계열에 경로가 맞는지 확인하세요. 잘못된 키 타입 사용: 제공자 키는 Anthropic 키가 아니며 그 반대도 마찬가지입니다. 틀린 키를 넣으면 인증 오류가 발생하는데, 메시지가 직관적이지 않을 수 있습니다. OpenClaw 화이트리스트 누락: 제공자 정의만으로는 부족합니다. "model not allowed"라는 문구가 보이면 화이트리스트에 모델이 없거나 provider-name/model-name 키에 오타가 있는 것입니다. Claude Code의 백그라운드 모델 설정 누락: 메인 모델만 설정하고 Haiku/Sonnet 기본값을 사용 불가능한 모델로 남겨두면 작은 백그라운드 호출이 실패합니다. 세 가지 모두 설정하세요.

자주 묻는 질문(FAQ)

이 치트 시트를 사용하면 도구를 변경해야 하나요?

아니요. 기존에 사용하던 Claude Code, OpenClaw, Codex, OpenCode, Cursor를 그대로 유지하면 됩니다. 커스텀 API 설정은 도구 마이그레이션이 아니라 설정 변경일 뿐이므로, 작업 방식은 동일하게 유지되면서 백엔드와 비용만 개선됩니다.

도구마다 Base URL이 왜 다른가요?

프로토콜 계열 때문입니다. Claude Code는 Anthropic API를 사용하므로 도메인 주소만 필요하지만, OpenAI 호환 도구는 /v1 경로를 예상합니다. 동일한 제공자라도 도구에 따라 경로 설정이 달라야 합니다.

비용을 얼마나 절감할 수 있나요?

모델에 따라 다릅니다. DeepSeek V4 Flash는 100만 입력 토큰당 0.14달러 수준으로, 일상적인 작업에 사용하면 기존 최신 모델 대비 토큰 비용을 70% 이상 절감하면서도 작업 방식은 그대로 유지할 수 있습니다.

어떤 모델부터 시작해야 하나요?

대화형 코딩은 GLM-5.1이나 Kimi K2.6을 기본으로 추천합니다. 대량 처리는 DeepSeek V4 Flash가 훨씬 저렴합니다. 최신 모델은 오픈 모델로 해결이 안 되는 어려운 작업에만 대비용으로 두세요.

설정을 되돌릴 수 있나요?

네, 각 설정은 언제든 원복 가능합니다. 원래의 Base URL로 되돌리거나 제공자 블록을 삭제하면 에이전트는 다시 기본 모델을 사용합니다. 많은 개발자가 두 설정을 모두 저장해두고 작업에 따라 전환하며 사용합니다.

결론

이 치트 시트가 가치 있는 이유는 개념 자체가 어려운 것이 아니라, 각 도구가 요구하는 파일 위치와 URL을 기억하는 것이 번거롭기 때문입니다. 두 가지 프로토콜 계열만 이해하면 모든 설정은 Base URL, 키, 모델 ID의 조합일 뿐입니다. 오픈 웨이트 모델을 선택하고, 올바른 설정을 붙여넣고, /v1 규칙만 신경 쓰세요. 그러면 지금 좋아하는 에이전트를 그대로 사용하면서 비용은 대폭 줄일 수 있습니다. 모든 도구에 하나의 키와 통합된 예산을 적용하고 싶다면 Atlas Cloud Coding Plan 콘솔에서 설정하고 작업에 따라 모델을 자유롭게 전환해보세요.