사용량 위키: 한도 초기화 시간과 토큰 절약

한도는 언제 초기화되고, 어떻게 하면 더 오래 쓸 수 있을까요? 주제별로 찾아보세요. Codex와 Claude를 따로 답하며, 공식 문서의 원문 인용과 링크를 함께 제공합니다.

스킬과 플러그인은 턴마다 토큰을 얼마나 쓰나요?

턴마다 실리는 것은 각 스킬의 이름과 설명뿐이며 전체 내용이 아닙니다. 스킬 6개가 든 플러그인 하나를 실제로 재 보니 턴당 약 221 토큰이었습니다. 전체 내용은 그 스킬을 쓸 때 로드됩니다. Claude Code는 /usage에 플러그인별 턴당 비용을 보여 줍니다. Codex도 방식은 같지만 스킬별 수치는 보여 주지 않습니다.

Codex

방식은 같습니다. 처음에는 이름, 설명, 파일 경로만 싣고 스킬이 선택되면 전체를 읽습니다. Codex는 스킬별 토큰 수치를 보여 주지 않습니다.

초기 스킬 목록은 컨텍스트 창의 최대 2%를 쓰며, 창 크기를 알 수 없을 때는 8,000자입니다. 설치한 스킬이 많으면 Codex는 먼저 설명을 줄이고, 그래도 많으면 일부 스킬을 목록에서 빼고 경고를 표시합니다. 스킬을 고르면 SKILL.md 전체를 읽습니다. Codex CLI의 /usage는 토큰을 일별·주별·누적으로 보여 줄 뿐 스킬별로 나누지 않습니다. 덜 싣고 싶다면 ~/.codex/config.toml에서 안 쓰는 스킬을 비활성화하세요.

공식 문서 원문

Skills use progressive disclosure to manage context efficiently. ChatGPT and Codex start with each skill's name and description, then load the full SKILL.md instructions when they decide to use that skill. In Codex, the initial list also includes each skill's file path.
OpenAI docs · Build skills
To avoid crowding out the rest of the prompt, this list uses at most 2% of the model's context window, or 8,000 characters when the context window is unknown. If many skills are installed, Codex shortens skill descriptions first. For large skill sets, Codex may omit some skills from the initial list and show a warning.
OpenAI docs · Build skills
/usage — View account token usage or use a rate-limit reset. Inspect daily, weekly, or cumulative ChatGPT token activity from inside the TUI.
OpenAI docs · Developer commands

Claude

턴마다 각 스킬의 이름과 설명만 실립니다. /usage에서 플러그인마다 턴당 얼마나 더하는지 볼 수 있습니다.

Claude Code는 모든 스킬의 이름과 설명을 하나의 목록으로 만들어 시스템 프롬프트에 넣습니다. 쓰든 안 쓰든 모든 메시지에 실리며, 첫 턴 이후에는 캐시 요율로 다시 읽습니다. 이 목록은 컨텍스트 창의 1%로, 스킬 하나의 설명은 1,536자로 제한됩니다. 한도를 넘으면 가장 적게 호출한 스킬부터 설명이 빠집니다. SKILL.md 전체는 스킬이 호출될 때만 로드되고, 그 뒤에는 대화에 남아 이후 매 턴마다 다시 읽힙니다.

공식 문서 원문

In a regular session, skill descriptions are loaded into context so Claude knows what's available, but full skill content only loads when invoked.
Claude Code docs · Extend Claude with skills
Every skill in the skill listing adds to your context on every turn, whether or not Claude ever uses it. Run /skill-doctor to see what each of your skills costs and how often it gets used, so you can decide which ones to turn off.
Claude Code docs · Extend Claude with skills
The budget scales at 1% of the model's context window. When the listing overflows, Claude Code drops descriptions starting with the skills you invoke least, so the skills you use most keep their full text.
Claude Code docs · Extend Claude with skills
Skills load on-demand only when invoked, so moving specialized instructions into skills keeps your base context smaller.
Claude Code docs · Manage costs effectively

/usage의 플러그인 항목

Claude Code에서 /usage를 실행하고 Plugin skill-listing footprint라는 항목을 찾으세요. 플러그인마다 스킬 수와 턴당 비용이 나옵니다. 예: diagram-design 6 skills · ~221 tok/turn. 이 수치는 플러그인 하나를 실제로 잰 예시이며 평균이 아닙니다.

/usage 패널은 이 항목을 이렇게 설명합니다. "What each plugin's skill descriptions add to the system prompt (cached input after the first turn). Agents and MCP tools not yet counted."(각 플러그인의 스킬 설명이 시스템 프롬프트에 더하는 양이며, 첫 턴 이후에는 캐시된 입력으로 계산됩니다. 에이전트와 MCP 도구는 아직 포함되지 않습니다.) 이 문장은 공식 문서가 아니라 패널에 나오는 것입니다. 플러그인에 들어 있는 에이전트와 MCP 도구는 표시된 수치와 별도로 더 듭니다.

안 쓰는 스킬 끄기

스킬을 끄면 그 설명이 더는 매 턴마다 실리지 않습니다. 끄는 방법은 스킬이 어디서 왔는지에 따라 다릅니다.

  1. Claude Code, 플러그인에 들어 있는 스킬: /plugin disable plugin-name@marketplace-name을 실행하거나 /plugin의 Installed 탭을 이용하세요. 플러그인 스킬은 이 방법으로만 끌 수 있습니다.

  2. Claude Code, 직접 설치한 스킬: /skills를 열어 스킬을 선택하고 Space로 상태를 바꾼 다음 Esc로 저장하세요. name-only는 이름만 남기고, off는 스킬을 완전히 숨깁니다.

  3. Claude Code, 직접 실행할 때만 쓰는 스킬: SKILL.md 맨 위에 disable-model-invocation: true를 추가하세요. 설명이 더는 매 턴마다 실리지 않습니다.

  4. Codex: ~/.codex/config.toml에 [[skills.config]] 항목을 추가하고 path = "/path/to/skill/SKILL.md"와 enabled = false를 적은 다음 Codex를 다시 시작하세요.

공식 문서 원문

Plugin skills are not affected by skillOverrides. Manage those through /plugin instead.
Claude Code docs · Extend Claude with skills
Use [[skills.config]] entries in ~/.codex/config.toml to disable a skill without deleting it
OpenAI docs · Build skills

흔한 오해

  • 스킬을 50개 설치하면 턴마다 스킬 파일 50개를 통째로 읽는다

    아닙니다. 턴마다 실리는 것은 이름과 설명뿐이며, 스킬 6개를 재 보니 합쳐서 약 221 토큰이었습니다. 전체 내용은 그 스킬을 쓸 때만 로드됩니다.

  • 스킬 설명은 자세할수록 좋다

    아닙니다. 설명은 매 턴마다 실리는 부분이고 잘리기도 합니다. Claude Code는 스킬당 1,536자, 목록 전체는 컨텍스트 창의 1%까지 허용하고, Codex는 목록에 2%까지 허용합니다. 핵심 용도와 트리거 단어를 맨 앞에 두고 짧게 쓰세요.

  • 스킬은 한 번 실행하고 나면 더는 토큰을 쓰지 않는다

    아닙니다. 스킬 전체는 로드된 뒤 대화에 남아 이후 매 턴마다 다시 읽힙니다. Claude Code가 세션을 압축한 뒤에도 호출된 스킬은 각각 처음 5,000 토큰, 합쳐서 최대 25,000 토큰이 유지됩니다. 작업을 바꿀 때는 새 세션을 시작하세요.

  • Claude Code: /usage를 실행해 Plugin skill-listing footprint 항목을 보세요. 턴당 토큰을 가장 많이 더하는 플러그인부터 살펴봅니다.
  • Claude Code: /skill-doctor를 실행하세요(v2.1.252 이상). 한 번도 호출되지 않은 스킬과 최근에 쓰지 않은 플러그인을 표시해 줍니다. /context의 Skills 줄은 목록 전체의 현재 크기입니다.
  • 스킬을 실행한 뒤 다른 작업으로 넘어갈 때는 /clear(Codex는 /new)를 쓰세요. 그러기 전까지는 스킬 전체 내용이 세션에 남아 있습니다.

Codex 리셋 발표 기록 · Claude 리셋 발표 기록