메뉴
Use when implementing server-side tolerance for Claude Code context-management fields in an Anthropic gateway, including context_management edits, cache_edits blocks, cache references, prompt cache controls, and non-streaming compact requests.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | claude-code-api-compaction |
| description | Use when implementing server-side tolerance for Claude Code context-management fields in an Anthropic gateway, including context_management edits, cache_edits blocks, cache references, prompt cache controls, and non-streaming compact requests. |
根据本 skill，让大模型请求网关能接受 Claude Code 发来的上下文管理字段。外部网关可以不实现真实 prompt cache 或 API 侧清理，但必须容忍这些字段，避免因为扩展字段导致 /v1/messages 失败。
详细字段见 references/compaction-wire-format.md。
| 位置 | 字段 | 最小处理 |
|---|---|---|
| request body | context_management | 可忽略或转发 |
| user content | cache_edits | 可忽略 |
| tool_result | cache_reference | 可忽略 |
| text/system/tool | cache_control | 可忽略 |
| request body | betas 包含 context-management-* | 可记录/透传 |
Claude Code 可能发送：
{
"context_management": {
"edits": [
{ "type": "clear_thinking_20251015", "keep": "all" },
{
"type": "clear_tool_uses_20250919",
"trigger": { "type": "input_tokens", "value": 180000 },
"clear_at_least": { "type": "input_tokens", "value": 140000 },
"clear_tool_inputs": ["Bash", "Glob", "Grep", "FileRead"]
}
]
}
}
如果你的上游不支持这些策略，忽略即可；不要 400。
Claude Code 可能在 user message content 中插入：
{
"type": "cache_edits",
"edits": [{ "type": "delete", "cache_reference": "toolu_1" }]
}
不支持缓存删除时忽略该 block，并继续处理同一 user message 中的 text 或 tool_result。
压缩摘要通常走 stream:false，工具为空，模型可能是 Haiku/小模型。网关只需要把它当普通非流式 /v1/messages 请求处理。
Use when implementing server-side message and content-block compatibility for a Claude Code Anthropic gateway, including messages arrays, system blocks, tool_result pairing, image/document/thinking blocks, cache_control, and tolerant validation.
Use when implementing server-side HTTP request handling for a Claude Code compatible Anthropic API gateway, especially /v1/messages, /v1/messages/count_tokens, /v1/files, /v1/models, headers, body fields, beta handling, and gateway routing.
Use when implementing server-side SSE streaming compatibility for a Claude Code Anthropic gateway, including message_start/content_block_delta/message_delta events, tool_use streaming, stream:false fallback, timeouts, and malformed stream behavior.
Use when implementing server-side tool schema and tool-call compatibility for a Claude Code Anthropic gateway, including tools arrays, tool_choice, tool_use SSE blocks, tool_result messages, deferred tools, MCP-style names, and tool parameter JSON.
Use when implementing a server-side Anthropic-compatible LLM gateway for Claude Code, including /v1/messages, SSE streaming, count_tokens, files, models, tool_use/tool_result, beta headers, and gateway error compatibility.