Skip to content

Commit b9796fa

Browse files
feat(provider): add Claude Opus 4.8 model
Adds the claude-opus-4-8 built-in model (released 2026-05-28) to the Claude provider with high default effort, xhigh/max levels, fast mode, and 200k/1M context options. Gates it behind Claude Code v2.1.154 (the first version that ships it) and points the 'opus' alias at it. - ClaudeProvider: new BUILT_IN_MODELS entry + MINIMUM_CLAUDE_OPUS_4_8_VERSION gating, generalized version-support helpers and upgrade message - contracts/model: opus -> claude-opus-4-8, add opus-4.8 aliases - ProviderRegistry.test: cover 4.8 presence/effort and version gating
1 parent 02d6c70 commit b9796fa

3 files changed

Lines changed: 153 additions & 12 deletions

File tree

‎apps/server/src/provider/Layers/ClaudeProvider.ts‎

Lines changed: 72 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -49,7 +49,42 @@ const CLAUDE_PRESENTATION = {
4949
showInteractionModeToggle: true,
5050
} as const;
5151
const MINIMUM_CLAUDE_OPUS_4_7_VERSION = "2.1.111";
52+
const MINIMUM_CLAUDE_OPUS_4_8_VERSION = "2.1.154";
5253
const BUILT_IN_MODELS: ReadonlyArray<ServerProviderModel> = [
54+
{
55+
slug: "claude-opus-4-8",
56+
name: "Claude Opus 4.8",
57+
isCustom: false,
58+
capabilities: createModelCapabilities({
59+
optionDescriptors: [
60+
buildSelectOptionDescriptor({
61+
id: "effort",
62+
label: "Reasoning",
63+
options: [
64+
{ value: "low", label: "Low" },
65+
{ value: "medium", label: "Medium" },
66+
{ value: "high", label: "High", isDefault: true },
67+
{ value: "xhigh", label: "Extra High" },
68+
{ value: "max", label: "Max" },
69+
{ value: "ultrathink", label: "Ultrathink" },
70+
],
71+
promptInjectedValues: ["ultrathink"],
72+
}),
73+
buildBooleanOptionDescriptor({
74+
id: "fastMode",
75+
label: "Fast Mode",
76+
}),
77+
buildSelectOptionDescriptor({
78+
id: "contextWindow",
79+
label: "Context Window",
80+
options: [
81+
{ value: "200k", label: "200k", isDefault: true },
82+
{ value: "1m", label: "1M" },
83+
],
84+
}),
85+
],
86+
}),
87+
},
5388
{
5489
slug: "claude-opus-4-7",
5590
name: "Claude Opus 4.7",
@@ -179,22 +214,38 @@ const BUILT_IN_MODELS: ReadonlyArray<ServerProviderModel> = [
179214
},
180215
];
181216

217+
function supportsMinimumClaudeVersion(
218+
version: string | null | undefined,
219+
minimum: string,
220+
): boolean {
221+
return version ? compareSemverVersions(version, minimum) >= 0 : false;
222+
}
223+
182224
function supportsClaudeOpus47(version: string | null | undefined): boolean {
183-
return version ? compareSemverVersions(version, MINIMUM_CLAUDE_OPUS_4_7_VERSION) >= 0 : false;
225+
return supportsMinimumClaudeVersion(version, MINIMUM_CLAUDE_OPUS_4_7_VERSION);
226+
}
227+
228+
function supportsClaudeOpus48(version: string | null | undefined): boolean {
229+
return supportsMinimumClaudeVersion(version, MINIMUM_CLAUDE_OPUS_4_8_VERSION);
184230
}
185231

186232
function getBuiltInClaudeModelsForVersion(
187233
version: string | null | undefined,
188234
): ReadonlyArray<ServerProviderModel> {
189-
if (supportsClaudeOpus47(version)) {
190-
return BUILT_IN_MODELS;
191-
}
192-
return BUILT_IN_MODELS.filter((model) => model.slug !== "claude-opus-4-7");
235+
return BUILT_IN_MODELS.filter((model) => {
236+
if (model.slug === "claude-opus-4-8") return supportsClaudeOpus48(version);
237+
if (model.slug === "claude-opus-4-7") return supportsClaudeOpus47(version);
238+
return true;
239+
});
193240
}
194241

195-
function formatClaudeOpus47UpgradeMessage(version: string | null): string {
242+
function formatClaudeOpusUpgradeMessage(
243+
version: string | null,
244+
modelName: string,
245+
minimumVersion: string,
246+
): string {
196247
const versionLabel = version ? `v${version}` : "the installed version";
197-
return `Claude Code ${versionLabel} is too old for Claude Opus 4.7. Upgrade to v${MINIMUM_CLAUDE_OPUS_4_7_VERSION} or newer to access it.`;
248+
return `Claude Code ${versionLabel} is too old for ${modelName}. Upgrade to v${minimumVersion} or newer to access it.`;
198249
}
199250

200251
export function getClaudeModelCapabilities(model: string | null | undefined): ModelCapabilities {
@@ -617,9 +668,19 @@ export const checkClaudeProviderStatus = Effect.fn("checkClaudeProviderStatus")(
617668
claudeSettings.customModels,
618669
DEFAULT_CLAUDE_MODEL_CAPABILITIES,
619670
);
620-
const opus47UpgradeMessage = supportsClaudeOpus47(parsedVersion)
621-
? undefined
622-
: formatClaudeOpus47UpgradeMessage(parsedVersion);
671+
const opusUpgradeMessage = !supportsClaudeOpus47(parsedVersion)
672+
? formatClaudeOpusUpgradeMessage(
673+
parsedVersion,
674+
"Claude Opus 4.7",
675+
MINIMUM_CLAUDE_OPUS_4_7_VERSION,
676+
)
677+
: !supportsClaudeOpus48(parsedVersion)
678+
? formatClaudeOpusUpgradeMessage(
679+
parsedVersion,
680+
"Claude Opus 4.8",
681+
MINIMUM_CLAUDE_OPUS_4_8_VERSION,
682+
)
683+
: undefined;
623684

624685
const capabilities = resolveCapabilities
625686
? yield* resolveCapabilities(claudeSettings).pipe(Effect.orElseSucceed(() => undefined))
@@ -663,7 +724,7 @@ export const checkClaudeProviderStatus = Effect.fn("checkClaudeProviderStatus")(
663724
...(capabilities.email ? { email: capabilities.email } : {}),
664725
...(authMetadata ? authMetadata : {}),
665726
},
666-
...(opus47UpgradeMessage ? { message: opus47UpgradeMessage } : {}),
727+
...(opusUpgradeMessage ? { message: opusUpgradeMessage } : {}),
667728
},
668729
});
669730
});

‎apps/server/src/provider/Layers/ProviderRegistry.test.ts‎

Lines changed: 78 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1429,6 +1429,84 @@ it.layer(Layer.mergeAll(NodeServices.layer, ServerSettingsService.layerTest(), T
14291429
),
14301430
);
14311431

1432+
it.effect(
1433+
"includes Claude Opus 4.8 with high as the default effort on supported versions",
1434+
() =>
1435+
Effect.gen(function* () {
1436+
const status = yield* checkClaudeProviderStatus(
1437+
defaultClaudeSettings,
1438+
claudeCapabilities(),
1439+
);
1440+
const opus48 = status.models.find((model) => model.slug === "claude-opus-4-8");
1441+
if (!opus48) {
1442+
assert.fail("Expected Claude Opus 4.8 to be present for Claude Code v2.1.154.");
1443+
}
1444+
if (!opus48.capabilities) {
1445+
assert.fail(
1446+
"Expected Claude Opus 4.8 capabilities to be present for Claude Code v2.1.154.",
1447+
);
1448+
}
1449+
const effortDescriptor = opus48.capabilities.optionDescriptors?.find(
1450+
(descriptor) => descriptor.type === "select" && descriptor.id === "effort",
1451+
);
1452+
assert.deepStrictEqual(
1453+
effortDescriptor?.type === "select"
1454+
? effortDescriptor.options.find((option) => option.isDefault)
1455+
: undefined,
1456+
{ id: "high", label: "High", isDefault: true },
1457+
);
1458+
}).pipe(
1459+
Effect.provide(
1460+
mockSpawnerLayer((args) => {
1461+
const joined = args.join(" ");
1462+
if (joined === "--version") return { stdout: "2.1.154\n", stderr: "", code: 0 };
1463+
if (joined === "auth status")
1464+
return {
1465+
stdout: '{"loggedIn":true,"authMethod":"claude.ai"}\n',
1466+
stderr: "",
1467+
code: 0,
1468+
};
1469+
throw new Error(`Unexpected args: ${joined}`);
1470+
}),
1471+
),
1472+
),
1473+
);
1474+
1475+
it.effect("hides Claude Opus 4.8 on older Claude Code versions", () =>
1476+
Effect.gen(function* () {
1477+
const status = yield* checkClaudeProviderStatus(
1478+
defaultClaudeSettings,
1479+
claudeCapabilities(),
1480+
);
1481+
assert.strictEqual(
1482+
status.models.some((model) => model.slug === "claude-opus-4-8"),
1483+
false,
1484+
);
1485+
assert.strictEqual(
1486+
status.models.some((model) => model.slug === "claude-opus-4-7"),
1487+
true,
1488+
);
1489+
assert.strictEqual(
1490+
status.message,
1491+
"Claude Code v2.1.153 is too old for Claude Opus 4.8. Upgrade to v2.1.154 or newer to access it.",
1492+
);
1493+
}).pipe(
1494+
Effect.provide(
1495+
mockSpawnerLayer((args) => {
1496+
const joined = args.join(" ");
1497+
if (joined === "--version") return { stdout: "2.1.153\n", stderr: "", code: 0 };
1498+
if (joined === "auth status")
1499+
return {
1500+
stdout: '{"loggedIn":true,"authMethod":"claude.ai"}\n',
1501+
stderr: "",
1502+
code: 0,
1503+
};
1504+
throw new Error(`Unexpected args: ${joined}`);
1505+
}),
1506+
),
1507+
),
1508+
);
1509+
14321510
it.effect("returns a display label for claude subscription types", () =>
14331511
Effect.gen(function* () {
14341512
const status = yield* checkClaudeProviderStatus(

‎packages/contracts/src/model.ts‎

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -164,7 +164,9 @@ export const MODEL_SLUG_ALIASES_BY_PROVIDER: Partial<
164164
"gpt-5.3-spark": "gpt-5.3-codex-spark",
165165
},
166166
[CLAUDE_DRIVER_KIND]: {
167-
opus: "claude-opus-4-7",
167+
opus: "claude-opus-4-8",
168+
"opus-4.8": "claude-opus-4-8",
169+
"claude-opus-4.8": "claude-opus-4-8",
168170
"opus-4.7": "claude-opus-4-7",
169171
"claude-opus-4.7": "claude-opus-4-7",
170172
"opus-4.6": "claude-opus-4-6",

0 commit comments

Comments
 (0)