Skip to content

Use Claude Code with your ChatGPT, Kimi, Cursor or Grok subscription via a local Anthropic-compatible proxy

Rust

add codex service tier override

Raine Virta6ba2a81c8bfe
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 2b16c4b..089cd43 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,11 @@
# Changelog
+## Unreleased
+
+- Added `codex.serviceTier` / `CCP_CODEX_SERVICE_TIER` to request Codex service
+ tiers. The Codex-style `fast` value is sent upstream as `priority`, matching
+ the first-party Codex client.
+
## v0.0.9 (2026-05-03)
- Kimi debugging overrides now use `CCP_KIMI_OAUTH_HOST` and `CCP_KIMI_BASE_URL`, matching the proxy's `CCP_` environment variable naming.
diff --git a/README.md b/README.md
index 0916959..b44c6e2 100644
--- a/README.md
+++ b/README.md
@@ -452,7 +452,8 @@ directory the auth tokens use, deliberately not `~/Library`) and at
"originator": "claude-code-proxy",
"userAgent": "claude-code-proxy/dev",
"model": "gpt-5.4",
- "effort": "medium"
+ "effort": "medium",
+ "serviceTier": "fast"
},
"kimi": {
"userAgent": "KimiCLI/1.37.0",
@@ -466,21 +467,22 @@ directory the auth tokens use, deliberately not `~/Library`) and at
}
```
-| Variable | Config key | Default | Purpose |
-| ---------------------- | ------------------- | -------------------------------- | ---------------------------------------------------------------------------------------------- |
-| `PORT` | `port` | `18765` | Proxy listen port |
-| `XDG_STATE_HOME` | — | `~/.local/state` | Base dir for `proxy.log` |
-| `CCP_LOG_STDERR` | `log.stderr` | unset | Also mirror log lines to stderr |
-| `CCP_LOG_VERBOSE` | `log.verbose` | unset | Log full request/response bodies + every SSE event |
-| `CCP_KIMI_OAUTH_HOST` | `kimi.oauthHost` | `https://auth.kimi.com` | Override Kimi's OAuth host (debugging only) |
-| `CCP_KIMI_BASE_URL` | `kimi.baseUrl` | `https://api.kimi.com/coding/v1` | Override Kimi's API base URL |
-| `CCP_CODEX_MODEL` | `codex.model` | unset | Force all Codex requests to this model (`gpt-5.2`, `gpt-5.3-codex`, `gpt-5.4`, `gpt-5.4-mini`) |
-| `CCP_CODEX_EFFORT` | `codex.effort` | unset | Force all Codex requests to this reasoning effort (`none`, `low`, `medium`, `high`, `xhigh`) |
-| `CCP_CODEX_ORIGINATOR` | `codex.originator` | `claude-code-proxy` | Override the `originator` header sent to Codex |
-| `CCP_CODEX_USER_AGENT` | `codex.userAgent` | `claude-code-proxy/<version>` | Override the `User-Agent` header sent to Codex |
-| `CCP_KIMI_USER_AGENT` | `kimi.userAgent` | `KimiCLI/1.37.0` | Override the `User-Agent` header sent to Kimi |
-| `CCP_ORIGINATOR` | — | `claude-code-proxy` | Fallback for `CCP_CODEX_ORIGINATOR` |
-| `CCP_USER_AGENT` | — | unset | Fallback for `CCP_CODEX_USER_AGENT` and `CCP_KIMI_USER_AGENT` |
+| Variable | Config key | Default | Purpose |
+| ------------------------ | ------------------- | -------------------------------- | ---------------------------------------------------------------------------------------------- |
+| `PORT` | `port` | `18765` | Proxy listen port |
+| `XDG_STATE_HOME` | — | `~/.local/state` | Base dir for `proxy.log` |
+| `CCP_LOG_STDERR` | `log.stderr` | unset | Also mirror log lines to stderr |
+| `CCP_LOG_VERBOSE` | `log.verbose` | unset | Log full request/response bodies + every SSE event |
+| `CCP_KIMI_OAUTH_HOST` | `kimi.oauthHost` | `https://auth.kimi.com` | Override Kimi's OAuth host (debugging only) |
+| `CCP_KIMI_BASE_URL` | `kimi.baseUrl` | `https://api.kimi.com/coding/v1` | Override Kimi's API base URL |
+| `CCP_CODEX_MODEL` | `codex.model` | unset | Force all Codex requests to this model (`gpt-5.2`, `gpt-5.3-codex`, `gpt-5.4`, `gpt-5.4-mini`) |
+| `CCP_CODEX_EFFORT` | `codex.effort` | unset | Force all Codex requests to this reasoning effort (`none`, `low`, `medium`, `high`, `xhigh`) |
+| `CCP_CODEX_SERVICE_TIER` | `codex.serviceTier` | unset | Force all Codex requests to this service tier (`fast`, `priority`, `flex`) |
+| `CCP_CODEX_ORIGINATOR` | `codex.originator` | `claude-code-proxy` | Override the `originator` header sent to Codex |
+| `CCP_CODEX_USER_AGENT` | `codex.userAgent` | `claude-code-proxy/<version>` | Override the `User-Agent` header sent to Codex |
+| `CCP_KIMI_USER_AGENT` | `kimi.userAgent` | `KimiCLI/1.37.0` | Override the `User-Agent` header sent to Kimi |
+| `CCP_ORIGINATOR` | — | `claude-code-proxy` | Fallback for `CCP_CODEX_ORIGINATOR` |
+| `CCP_USER_AGENT` | — | unset | Fallback for `CCP_CODEX_USER_AGENT` and `CCP_KIMI_USER_AGENT` |
A malformed `config.json` is reported on stderr and ignored; defaults are used
in its place. Invalid types for individual keys are warned and skipped without
diff --git a/src/cli.ts b/src/cli.ts
index 685519a..495349b 100755
--- a/src/cli.ts
+++ b/src/cli.ts
@@ -134,6 +134,9 @@ function printConfigSummary(): void {
if (cfg.env.CCP_CODEX_EFFORT) overrides.push("CCP_CODEX_EFFORT (env)")
else if (fromFile.codex?.effort) overrides.push("codex.effort (config)")
+ if (cfg.env.CCP_CODEX_SERVICE_TIER) overrides.push("CCP_CODEX_SERVICE_TIER (env)")
+ else if (fromFile.codex?.serviceTier) overrides.push("codex.serviceTier (config)")
+
if (cfg.env.CCP_LOG_VERBOSE !== undefined) overrides.push("CCP_LOG_VERBOSE (env)")
else if (fromFile.log?.verbose) overrides.push("log.verbose (config)")
diff --git a/src/config.test.ts b/src/config.test.ts
index 8444ca9..43bf511 100644
--- a/src/config.test.ts
+++ b/src/config.test.ts
@@ -9,6 +9,7 @@ import {
codexUserAgent,
codexModel,
codexEffort,
+ codexServiceTier,
kimiUserAgent,
kimiOauthHost,
kimiBaseUrl,
@@ -43,6 +44,7 @@ describe("config defaults", () => {
expect(codexUserAgent("default-ua")).toBe("default-ua")
expect(codexModel()).toBeUndefined()
expect(codexEffort()).toBeUndefined()
+ expect(codexServiceTier()).toBeUndefined()
expect(kimiUserAgent("default-kimi-ua")).toBe("default-kimi-ua")
expect(kimiOauthHost()).toBe("https://auth.kimi.com")
expect(kimiBaseUrl()).toBe("https://api.kimi.com/coding/v1")
@@ -67,6 +69,12 @@ describe("file overrides default", () => {
expect(codexUserAgent("default")).toBe("ccp/file")
})
+ it("codex.serviceTier from config.json", () => {
+ writeFileSync(configPath, JSON.stringify({ codex: { serviceTier: "fast" } }))
+ setEnv({})
+ expect(codexServiceTier()).toBe("fast")
+ })
+
it("kimi.oauthHost from config.json", () => {
writeFileSync(
configPath,
@@ -99,6 +107,12 @@ describe("env overrides file", () => {
expect(codexUserAgent("default")).toBe("from-env")
})
+ it("CCP_CODEX_SERVICE_TIER env wins over config", () => {
+ writeFileSync(configPath, JSON.stringify({ codex: { serviceTier: "flex" } }))
+ setEnv({ CCP_CODEX_SERVICE_TIER: "fast" })
+ expect(codexServiceTier()).toBe("fast")
+ })
+
it("CCP_USER_AGENT env (generic fallback) is preferred over file", () => {
writeFileSync(
configPath,
@@ -128,6 +142,12 @@ describe("empty-string semantics", () => {
expect(codexModel()).toBeUndefined()
})
+ it("empty CCP_CODEX_SERVICE_TIER env falls through to file value", () => {
+ writeFileSync(configPath, JSON.stringify({ codex: { serviceTier: "flex" } }))
+ setEnv({ CCP_CODEX_SERVICE_TIER: "" })
+ expect(codexServiceTier()).toBe("flex")
+ })
+
it("empty PORT env falls through to file value", () => {
writeFileSync(configPath, JSON.stringify({ port: 33333 }))
setEnv({ PORT: "" })
diff --git a/src/config.ts b/src/config.ts
index ecf50df..daae3b7 100644
--- a/src/config.ts
+++ b/src/config.ts
@@ -16,6 +16,7 @@ export interface FileConfig {
userAgent?: string
model?: string
effort?: string
+ serviceTier?: string
}
kimi?: {
userAgent?: string
@@ -87,11 +88,12 @@ function validate(raw: unknown): FileConfig {
return acc as NonNullable<FileConfig[K]>
}
- const codex = validateStringSection("codex", ["originator", "userAgent", "model", "effort"], {
+ const codex = validateStringSection("codex", ["originator", "userAgent", "model", "effort", "serviceTier"], {
originator: "string",
userAgent: "string",
model: "string",
effort: "string",
+ serviceTier: "string",
})
if (codex) out.codex = codex
@@ -193,6 +195,11 @@ export function codexEffort(): string | undefined {
return emptyOrUnset(c.env.CCP_CODEX_EFFORT) ?? emptyOrUnset(c.file.codex?.effort)
}
+export function codexServiceTier(): string | undefined {
+ const c = getConfig()
+ return emptyOrUnset(c.env.CCP_CODEX_SERVICE_TIER) ?? emptyOrUnset(c.file.codex?.serviceTier)
+}
+
export function kimiUserAgent(defaultValue: string): string {
const c = getConfig()
return (
diff --git a/src/providers/codex/translate/request.test.ts b/src/providers/codex/translate/request.test.ts
index 7362234..ceb5739 100644
--- a/src/providers/codex/translate/request.test.ts
+++ b/src/providers/codex/translate/request.test.ts
@@ -1,4 +1,5 @@
-import { describe, expect, it } from "bun:test"
+import { afterEach, describe, expect, it } from "bun:test"
+import { loadConfig } from "../../../config.ts"
import type { AnthropicRequest } from "../../../anthropic/schema.ts"
import { translateRequest } from "./request.ts"
@@ -7,6 +8,10 @@ const baseRequest: AnthropicRequest = {
messages: [{ role: "user", content: "hello" }],
}
+afterEach(() => {
+ loadConfig({ forceReload: true })
+})
+
describe("translateRequest", () => {
it("omits reasoning include when reasoning is not enabled", () => {
const translated = translateRequest(baseRequest)
@@ -25,6 +30,28 @@ describe("translateRequest", () => {
expect(translated.include).toEqual(["reasoning.encrypted_content"])
})
+ it("normalizes fast service tier to upstream priority", () => {
+ loadConfig({ env: { CCP_CODEX_SERVICE_TIER: "fast" }, forceReload: true })
+
+ const translated = translateRequest(baseRequest)
+
+ expect(translated.service_tier).toBe("priority")
+ })
+
+ it("passes flex service tier through", () => {
+ loadConfig({ env: { CCP_CODEX_SERVICE_TIER: "flex" }, forceReload: true })
+
+ const translated = translateRequest(baseRequest)
+
+ expect(translated.service_tier).toBe("flex")
+ })
+
+ it("rejects invalid service tier overrides", () => {
+ loadConfig({ env: { CCP_CODEX_SERVICE_TIER: "standard" }, forceReload: true })
+
+ expect(() => translateRequest(baseRequest)).toThrow('Invalid service tier override: "standard"')
+ })
+
it("returns only the expected top-level upstream request fields", () => {
const translated = translateRequest({
...baseRequest,
diff --git a/src/providers/codex/translate/request.ts b/src/providers/codex/translate/request.ts
index 74c4f5b..58824ea 100644
--- a/src/providers/codex/translate/request.ts
+++ b/src/providers/codex/translate/request.ts
@@ -6,9 +6,10 @@ import type {
AnthropicTextBlock,
AnthropicTool,
} from "../../../anthropic/schema.ts"
-import { codexEffort } from "../../../config.ts"
+import { codexEffort, codexServiceTier } from "../../../config.ts"
export type Effort = "none" | "low" | "medium" | "high" | "xhigh"
+export type ServiceTier = "priority" | "flex"
// Keep this aligned to the upstream Codex ResponsesApiRequest field set.
// Do not add plausible-looking top-level fields without source support or a confirmed live test.
@@ -27,7 +28,7 @@ export interface ResponsesRequest {
store: false
stream: true
include?: string[]
- service_tier?: string
+ service_tier?: ServiceTier
prompt_cache_key?: string
text?: {
verbosity?: "low" | "medium" | "high"
@@ -78,6 +79,8 @@ const VALID_EFFORTS = new Set<Effort>(["none", "low", "medium", "high", "xhigh"]
const ANTHROPIC_EFFORTS = new Set(["low", "medium", "high", "max"])
+const VALID_SERVICE_TIERS = new Set(["fast", "priority", "flex"])
+
function assertValidEffort(effort: unknown): void {
if (effort !== undefined && !ANTHROPIC_EFFORTS.has(effort as string)) {
throw new Error(
@@ -106,6 +109,17 @@ function resolveEffort(effort?: Effort): Effort | undefined {
return override as Effort
}
+function resolveServiceTier(): ServiceTier | undefined {
+ const tier = codexServiceTier()
+ if (tier === undefined) return undefined
+ if (!VALID_SERVICE_TIERS.has(tier)) {
+ throw new Error(
+ `Invalid service tier override: "${tier}". Must be one of: ${Array.from(VALID_SERVICE_TIERS).join(", ")}`,
+ )
+ }
+ return tier === "flex" ? "flex" : "priority"
+}
+
export function translateRequest(req: AnthropicRequest, opts: TranslateOptions = {}): ResponsesRequest {
const instructions = buildInstructions(req.system)
const input = buildInput(req.messages)
@@ -134,6 +148,8 @@ export function translateRequest(req: AnthropicRequest, opts: TranslateOptions =
if (instructions) out.instructions = instructions
if (tools && tools.length) out.tools = tools
if (opts.sessionId) out.prompt_cache_key = opts.sessionId
+ const serviceTier = resolveServiceTier()
+ if (serviceTier) out.service_tier = serviceTier
assertValidEffort(req.output_config?.effort)
const effort = resolveEffort(toCodexEffort(req.output_config?.effort))
if (effort) {