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.mdindex 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.mdindex 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 usedin its place. Invalid types for individual keys are warned and skipped withoutdiff --git a/src/cli.ts b/src/cli.tsindex 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.tsindex 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.tsindex ecf50df..daae3b7 100644--- a/src/config.ts+++ b/src/config.ts@@ -16,6 +16,7 @@ export interface FileConfig {userAgent?: stringmodel?: stringeffort?: 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.tsindex 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.tsindex 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: falsestream: trueinclude?: string[]- service_tier?: string+ service_tier?: ServiceTierprompt_cache_key?: stringtext?: {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 = instructionsif (tools && tools.length) out.tools = toolsif (opts.sessionId) out.prompt_cache_key = opts.sessionId+ const serviceTier = resolveServiceTier()+ if (serviceTier) out.service_tier = serviceTierassertValidEffort(req.output_config?.effort)const effort = resolveEffort(toCodexEffort(req.output_config?.effort))if (effort) {