= {};
const levelOrder = ['minimal', 'low', 'medium', 'high', 'xhigh'];
diff --git a/src/commands/config-command.ts b/src/commands/config-command.ts
index 611b553c..7a7f5f4c 100644
--- a/src/commands/config-command.ts
+++ b/src/commands/config-command.ts
@@ -59,6 +59,7 @@ function showHelp(): void {
console.log('Usage: ccs config [command] [options]');
console.log('');
console.log('Open web-based configuration dashboard');
+ console.log('Includes a dedicated Claude IDE Extension page for VS Code-compatible hosts.');
console.log('');
console.log('Commands:');
console.log(' auth Manage dashboard authentication');
@@ -72,6 +73,11 @@ function showHelp(): void {
console.log(' --timeout Set analysis timeout (seconds)');
console.log(' --set-model Set model for provider');
console.log('');
+ console.log(' Claude IDE Extension');
+ console.log(' Dashboard page Generate copy-ready setup for VS Code, Cursor, Windsurf');
+ console.log(' Shared settings Shows preferred ~/.claude/settings.json setup');
+ console.log(' IDE-local JSON Shows extension-specific environmentVariables snippets');
+ console.log('');
console.log(' thinking Manage thinking/reasoning settings');
console.log(' --mode Set mode (auto, off, manual)');
console.log(' --override Set persistent override level');
@@ -90,6 +96,7 @@ function showHelp(): void {
console.log(' ccs config --port 3000 Use specific port');
console.log(' ccs config --dev Development mode with hot reload');
console.log(' ccs config auth setup Configure dashboard login');
+ console.log(' ccs config Open dashboard, then choose Claude IDE Extension');
console.log(' ccs config image-analysis Show image settings');
console.log(' ccs config image-analysis --enable Enable feature');
console.log(' ccs config thinking Show thinking settings');
diff --git a/src/commands/copilot-command.ts b/src/commands/copilot-command.ts
index 9fbf0c1a..40d36bcc 100644
--- a/src/commands/copilot-command.ts
+++ b/src/commands/copilot-command.ts
@@ -12,11 +12,12 @@ import {
stopDaemon,
getAvailableModels,
isCopilotApiInstalled,
+ normalizeCopilotConfigWithWarnings,
} from '../copilot';
import type { CopilotModel } from '../copilot';
import { loadOrCreateUnifiedConfig, saveUnifiedConfig } from '../config/unified-config-loader';
import { DEFAULT_COPILOT_CONFIG } from '../config/unified-config-types';
-import { ok, fail, info, color } from '../utils/ui';
+import { ok, fail, info, color, warn } from '../utils/ui';
import { normalizeCopilotSubcommand } from '../copilot/constants';
/**
@@ -55,6 +56,18 @@ export async function handleCopilotCommand(args: string[]): Promise {
}
}
+function loadCopilotConfigWithWarnings() {
+ const config = loadOrCreateUnifiedConfig();
+ return normalizeCopilotConfigWithWarnings(config.copilot ?? DEFAULT_COPILOT_CONFIG);
+}
+
+function printCopilotWarnings(messages: string[]): void {
+ if (messages.length === 0) return;
+ messages.forEach((message) => console.log(warn(message)));
+ console.log(warn('Run `ccs config` and save the Copilot section to persist these replacements.'));
+ console.log('');
+}
+
/**
* Show help for copilot commands.
*/
@@ -124,8 +137,8 @@ async function handleAuth(): Promise {
* Handle status subcommand.
*/
async function handleStatus(): Promise {
- const config = loadOrCreateUnifiedConfig();
- const copilotConfig = config.copilot ?? DEFAULT_COPILOT_CONFIG;
+ const { config: copilotConfig, warnings } = loadCopilotConfigWithWarnings();
+ printCopilotWarnings(warnings.map((warning) => warning.message));
const status = await getCopilotStatus(copilotConfig);
@@ -182,8 +195,8 @@ async function handleStatus(): Promise {
* Handle models subcommand.
*/
async function handleModels(): Promise {
- const config = loadOrCreateUnifiedConfig();
- const copilotConfig = config.copilot ?? DEFAULT_COPILOT_CONFIG;
+ const { config: copilotConfig, warnings } = loadCopilotConfigWithWarnings();
+ printCopilotWarnings(warnings.map((warning) => warning.message));
console.log('Available Copilot Models');
console.log('────────────────────────');
@@ -273,8 +286,8 @@ function formatResetDate(resetDate: string | null): string {
* Handle usage subcommand.
*/
async function handleUsage(): Promise {
- const config = loadOrCreateUnifiedConfig();
- const copilotConfig = config.copilot ?? DEFAULT_COPILOT_CONFIG;
+ const { config: copilotConfig, warnings } = loadCopilotConfigWithWarnings();
+ printCopilotWarnings(warnings.map((warning) => warning.message));
const status = await getCopilotStatus(copilotConfig);
if (!status.daemon.running) {
@@ -311,8 +324,8 @@ async function handleUsage(): Promise {
* Handle start subcommand.
*/
async function handleStart(): Promise {
- const config = loadOrCreateUnifiedConfig();
- const copilotConfig = config.copilot ?? DEFAULT_COPILOT_CONFIG;
+ const { config: copilotConfig, warnings } = loadCopilotConfigWithWarnings();
+ printCopilotWarnings(warnings.map((warning) => warning.message));
console.log(info(`Starting copilot-api daemon on port ${copilotConfig.port}...`));
diff --git a/src/commands/env-command.ts b/src/commands/env-command.ts
index a2f1aee5..888f075d 100644
--- a/src/commands/env-command.ts
+++ b/src/commands/env-command.ts
@@ -6,22 +6,20 @@
*/
import { initUI, header, dim, color, subheader, fail, warn } from '../utils/ui';
-import { CLIProxyProvider } from '../cliproxy/types';
-import { CLIPROXY_PROFILES, loadSettingsFromFile } from '../auth/profile-detector';
-import { getEffectiveEnvVars } from '../cliproxy/config/env-builder';
-import { CLIPROXY_DEFAULT_PORT } from '../cliproxy/config/port-manager';
-import { isUnifiedMode, loadUnifiedConfig } from '../config/unified-config-loader';
-import { expandPath } from '../utils/helpers';
import { getCcsDir } from '../utils/config-manager';
-import { ProfileRegistry } from '../auth/profile-registry';
-import { getProfileLookupCandidates } from '../utils/profile-compat';
+import { CLAUDE_EXTENSION_HOSTS, type ClaudeExtensionHost } from '../shared/claude-extension-hosts';
+import {
+ renderClaudeExtensionSettingsJson,
+ resolveClaudeExtensionSetup,
+} from '../shared/claude-extension-setup';
type ShellType = 'bash' | 'fish' | 'powershell';
-type OutputFormat = 'openai' | 'anthropic' | 'raw';
+type OutputFormat = 'openai' | 'anthropic' | 'raw' | 'claude-extension';
-const VALID_FORMATS: OutputFormat[] = ['openai', 'anthropic', 'raw'];
+const VALID_FORMATS: OutputFormat[] = ['openai', 'anthropic', 'raw', 'claude-extension'];
const VALID_SHELLS: ShellType[] = ['bash', 'fish', 'powershell'];
const VALID_SHELL_INPUTS = ['auto', 'bash', 'zsh', 'fish', 'powershell'] as const;
+const VALID_EXTENSION_HOSTS = CLAUDE_EXTENSION_HOSTS.map((host) => host.id);
const VALID_ENV_KEY = /^[A-Za-z_][A-Za-z0-9_]*$/;
/** Auto-detect shell from environment */
@@ -97,46 +95,6 @@ export function findProfile(args: string[], flagsWithValues: string[]): string |
return undefined;
}
-/** Check if a profile is a CLIProxy profile */
-function isCLIProxyProfile(name: string): boolean {
- return (CLIPROXY_PROFILES as readonly string[]).includes(name);
-}
-
-/** Resolve env vars for settings-based profiles (glm, km, custom API profiles) */
-function resolveSettingsProfile(profileName: string): Record | null {
- if (!isUnifiedMode()) return null;
-
- const config = loadUnifiedConfig();
- if (!config) return null;
-
- // Check unified config profiles section (supports compatibility aliases, e.g. km -> kimi)
- let profileConfig: { type?: string; settings?: string } | undefined;
- for (const candidate of getProfileLookupCandidates(profileName)) {
- const candidateConfig = config.profiles?.[candidate];
- if (candidateConfig) {
- profileConfig = candidateConfig;
- break;
- }
- }
- if (!profileConfig) return null;
-
- if (profileConfig.type !== 'api') {
- console.error(
- fail(
- `Profile '${profileName}' is type '${profileConfig.type}', not a settings-based API profile.`
- )
- );
- process.exit(1);
- }
-
- if (profileConfig.settings) {
- const settingsPath = expandPath(profileConfig.settings);
- return loadSettingsFromFile(settingsPath);
- }
-
- return {};
-}
-
/** Show help for env command */
function showHelp(): void {
console.log('');
@@ -151,11 +109,14 @@ function showHelp(): void {
console.log(subheader('Options:'));
console.log(
- ` ${color('--format', 'command')} Output format: openai, anthropic, raw ${dim('(default: anthropic)')}`
+ ` ${color('--format', 'command')} Output format: openai, anthropic, raw, claude-extension ${dim('(default: anthropic)')}`
);
console.log(
` ${color('--shell', 'command')} Shell syntax: auto, bash/zsh, fish, powershell ${dim('(default: auto)')}`
);
+ console.log(
+ ` ${color('--ide', 'command')} Claude extension host: ${VALID_EXTENSION_HOSTS.join(', ')} ${dim('(default: vscode)')}`
+ );
console.log(` ${color('--help, -h', 'command')} Show this help message`);
console.log('');
@@ -167,6 +128,9 @@ function showHelp(): void {
` ${color('anthropic', 'command')} ANTHROPIC_BASE_URL, ANTHROPIC_AUTH_TOKEN, ANTHROPIC_MODEL`
);
console.log(` ${color('raw', 'command')} All effective env vars as-is`);
+ console.log(
+ ` ${color('claude-extension', 'command')} Settings JSON snippet for the Claude IDE extension`
+ );
console.log('');
console.log(subheader('Examples:'));
@@ -182,6 +146,20 @@ function showHelp(): void {
console.log(
` $ ${color('ccs env agy --format openai --shell fish', 'command')} ${dim('# Fish shell syntax')}`
);
+ console.log(
+ ` $ ${color('ccs env work --format claude-extension --ide vscode', 'command')} ${dim('# VS Code/Cursor snippet')}`
+ );
+ console.log(
+ ` $ ${color('ccs env default --format claude-extension --ide windsurf', 'command')} ${dim('# Clear/replace Windsurf env overrides')}`
+ );
+ console.log('');
+ console.log(subheader('Notes:'));
+ console.log(
+ ` ${dim('- Use ccs persist for shared ~/.claude/settings.json setup when possible.')}`
+ );
+ console.log(
+ ` ${dim('- claude-extension output prints JSON only; replace the full environmentVariables setting.')}`
+ );
console.log('');
}
@@ -198,10 +176,12 @@ export async function handleEnvCommand(args: string[]): Promise {
}
// Parse profile (first positional argument, skipping flag values)
- const flagsWithValues = ['format', 'shell'];
+ const flagsWithValues = ['format', 'shell', 'ide'];
const profile = findProfile(args, flagsWithValues);
if (!profile) {
- console.error(fail('Usage: ccs env [--format openai|anthropic|raw]'));
+ console.error(
+ fail('Usage: ccs env [--format openai|anthropic|raw|claude-extension]')
+ );
process.exit(1);
}
@@ -220,47 +200,24 @@ export async function handleEnvCommand(args: string[]): Promise {
}
// zsh uses the same syntax as bash
const shell = detectShell(shellStr === 'zsh' ? 'bash' : shellStr);
+ const ide = (parseFlag(args, 'ide') || 'vscode') as ClaudeExtensionHost;
+ if (!VALID_EXTENSION_HOSTS.includes(ide)) {
+ console.error(fail(`Invalid IDE host: ${ide}. Use: ${VALID_EXTENSION_HOSTS.join(', ')}`));
+ process.exit(1);
+ }
- // Resolve env vars based on profile type
- let envVars: Record = {};
-
- if (isCLIProxyProfile(profile)) {
- // CLIProxy profile (gemini, codex, agy, etc.)
- const provider = profile as CLIProxyProvider;
- const resolved = getEffectiveEnvVars(provider, CLIPROXY_DEFAULT_PORT);
- // Convert NodeJS.ProcessEnv to Record
- for (const [k, v] of Object.entries(resolved)) {
- if (v !== undefined) envVars[k] = v;
+ let envVars: Record;
+ try {
+ const resolved = await resolveClaudeExtensionSetup(profile);
+ envVars = resolved.extensionEnv;
+ if (format === 'claude-extension') {
+ console.log(renderClaudeExtensionSettingsJson(resolved, ide));
+ return;
}
- } else {
- // Settings-based profile (glm, km, custom API)
- const resolved = resolveSettingsProfile(profile);
- if (!resolved) {
- // Check if it's an account-based profile
- const registry = new ProfileRegistry();
- const allProfiles = registry.getAllProfiles();
- if (allProfiles[profile]) {
- console.error(
- fail(
- `'${profile}' is an account-based profile. ` +
- '`ccs env` only supports CLIProxy and settings profiles.'
- )
- );
- process.exit(1);
- }
-
- console.error(fail(`Profile '${profile}' not found.`));
- console.error(dim(' Available CLIProxy profiles: ' + CLIPROXY_PROFILES.join(', ')));
- if (!isUnifiedMode()) {
- console.error(
- dim(' Settings profiles require unified config. Run `ccs migrate` to upgrade.')
- );
- } else {
- console.error(dim(` Check ${getCcsDir()}/config.yaml for custom profiles.`));
- }
- process.exit(1);
- }
- envVars = resolved;
+ } catch (error) {
+ console.error(fail((error as Error).message));
+ console.error(dim(` Check ${getCcsDir()}/config.yaml or run ccs config for profile setup.`));
+ process.exit(1);
}
if (Object.keys(envVars).length === 0) {
diff --git a/src/commands/help-command.ts b/src/commands/help-command.ts
index cbe44ebb..6eb794c0 100644
--- a/src/commands/help-command.ts
+++ b/src/commands/help-command.ts
@@ -305,7 +305,7 @@ Run ${color('ccs config', 'command')} for web dashboard`.trim();
['ccs setup', 'First-time setup wizard'],
['ccs doctor', 'Run health check and diagnostics'],
['ccs cleanup', 'Remove old CLIProxy logs'],
- ['ccs config', 'Open web configuration dashboard'],
+ ['ccs config', 'Open web dashboard (includes Claude IDE Extension setup page)'],
['ccs config auth setup', 'Configure dashboard login'],
['ccs config auth show', 'Show dashboard auth status'],
['ccs config image-analysis', 'Show image analysis settings'],
@@ -314,7 +314,7 @@ Run ${color('ccs config', 'command')} for web dashboard`.trim();
['ccs config thinking --mode auto', 'Set thinking mode'],
['ccs config thinking --clear-provider-override codex', 'Clear provider overrides'],
['ccs config --port 3000', 'Use specific port'],
- ['ccs persist ', 'Write profile env to ~/.claude/settings.json'],
+ ['ccs persist ', 'Write profile setup to ~/.claude/settings.json'],
['ccs persist --list-backups', 'List available settings.json backups'],
['ccs persist --restore', 'Restore settings.json from latest backup'],
['ccs sync', 'Sync delegation commands and skills'],
@@ -329,6 +329,14 @@ Run ${color('ccs config', 'command')} for web dashboard`.trim();
['ccs env --format openai', 'OpenAI-compatible vars (OpenCode/Cursor)'],
['ccs env --format anthropic', 'Anthropic vars (default)'],
['ccs env --format raw', 'All effective env vars'],
+ [
+ 'ccs env --format claude-extension --ide vscode',
+ 'VS Code/Cursor Claude extension settings JSON',
+ ],
+ [
+ 'ccs env --format claude-extension --ide windsurf',
+ 'Windsurf Claude extension settings JSON',
+ ],
['ccs env --shell fish', 'Fish shell syntax'],
]);
diff --git a/src/commands/persist-command.ts b/src/commands/persist-command.ts
index 1f157a80..a1d061ff 100644
--- a/src/commands/persist-command.ts
+++ b/src/commands/persist-command.ts
@@ -1,11 +1,11 @@
/**
* Persist Command Handler
*
- * Writes a profile's environment variables to ~/.claude/settings.json
- * for native Claude Code usage (IDEs, extensions, etc.).
+ * Writes a profile's Claude setup to ~/.claude/settings.json
+ * for native Claude Code usage across the CLI and IDE extension.
*
- * Supports all profile types: API, CLIProxy, Copilot.
- * Account-based profiles are not supported (use CLAUDE_CONFIG_DIR).
+ * Supports API, CLIProxy, Copilot, account, and default flows
+ * through the shared Claude extension setup resolver.
*/
import * as fs from 'fs';
@@ -14,16 +14,10 @@ import * as os from 'os';
import * as lockfile from 'proper-lockfile';
import { initUI, header, subheader, color, dim, ok, fail, warn, info } from '../utils/ui';
import { InteractivePrompt } from '../utils/prompt';
-import ProfileDetector, {
- ProfileDetectionResult,
- loadSettingsFromFile,
- CLIPROXY_PROFILES,
-} from '../auth/profile-detector';
-import { getEffectiveEnvVars, CLIPROXY_DEFAULT_PORT } from '../cliproxy/config-generator';
-import { generateCopilotEnv } from '../copilot/copilot-executor';
-import { expandPath } from '../utils/helpers';
+import ProfileDetector from '../auth/profile-detector';
import { getClaudeConfigDir, getClaudeSettingsPath } from '../utils/claude-config-path';
import { extractOption, hasAnyFlag } from './arg-extractor';
+import { resolveClaudeExtensionSetup } from '../shared/claude-extension-setup';
interface PersistCommandArgs {
profile?: string;
@@ -37,8 +31,10 @@ interface PersistCommandArgs {
interface ResolvedEnv {
env: Record;
+ clearEnvKeys: string[];
profileType: string;
- warning?: string;
+ warnings?: string[];
+ notes?: string[];
}
const PERSIST_KNOWN_FLAGS = [
@@ -513,68 +509,24 @@ function isSensitiveEnvKey(key: string): boolean {
);
}
-/** Resolve env vars for a profile */
-async function resolveProfileEnvVars(
- profileName: string,
- profileResult: ProfileDetectionResult
-): Promise {
- switch (profileResult.type) {
- case 'settings': {
- // API profile - load from settings file
- let env: Record = {};
- if (profileResult.env) {
- env = profileResult.env;
- } else if (profileResult.settingsPath) {
- env = loadSettingsFromFile(expandPath(profileResult.settingsPath));
- }
- if (Object.keys(env).length === 0) {
- throw new Error(`Profile '${profileName}' has no env vars configured`);
- }
- return { env, profileType: 'API' };
- }
- case 'cliproxy': {
- // CLIProxy profile - generate env vars
- const provider =
- profileResult.provider || (profileName as (typeof CLIPROXY_PROFILES)[number]);
- const port = profileResult.port || CLIPROXY_DEFAULT_PORT;
- const env = getEffectiveEnvVars(provider, port, profileResult.settingsPath) as Record<
- string,
- string
- >;
- return {
- env,
- profileType: 'CLIProxy',
- warning: 'CLIProxy must be running for this profile to work',
- };
- }
- case 'copilot': {
- // Copilot profile - generate env vars
- if (!profileResult.copilotConfig) {
- throw new Error('Copilot configuration not found');
- }
- const env = generateCopilotEnv(profileResult.copilotConfig);
- return {
- env,
- profileType: 'Copilot',
- warning: 'copilot-api daemon must be running for this profile to work',
- };
- }
- case 'account': {
- throw new Error(
- `Account profiles use CLAUDE_CONFIG_DIR isolation, not env vars.\n` +
- `Use 'ccs ${profileName}' to run with this profile instead.`
- );
- }
- case 'default': {
- throw new Error(
- 'Default profile has no env vars to persist.\n' +
- 'Specify a profile name: ccs persist '
- );
- }
- default: {
- throw new Error(`Unknown profile type: ${profileResult.type}`);
- }
- }
+/** Resolve shared Claude settings payload for a profile */
+async function resolveProfileEnvVars(profileName: string): Promise {
+ const setup = await resolveClaudeExtensionSetup(profileName);
+ const typeLabel: Record = {
+ settings: 'API',
+ cliproxy: 'CLIProxy',
+ copilot: 'Copilot',
+ account: 'Account',
+ default: 'Default',
+ };
+
+ return {
+ env: setup.extensionEnv,
+ clearEnvKeys: setup.removeEnvKeys,
+ profileType: typeLabel[setup.profileType] ?? setup.profileType,
+ warnings: setup.warnings,
+ notes: setup.notes,
+ };
}
/** Handle --list-backups flag */
@@ -702,11 +654,11 @@ async function showHelp(): Promise {
console.log(` ${color('ccs persist', 'command')} --restore [timestamp]`);
console.log('');
console.log(subheader('Description'));
- console.log(" Writes a profile's environment variables directly to");
+ console.log(" Writes a profile's Claude setup directly to");
console.log(` ${getClaudeSettingsDisplayPath()} for native Claude Code usage.`);
console.log('');
- console.log(' This allows Claude Code to use the profile without CCS,');
- console.log(' enabling compatibility with IDEs and extensions.');
+ console.log(' This is the preferred shared-settings path for Claude Code');
+ console.log(' and the Claude IDE extension when you want one profile everywhere.');
console.log('');
console.log(subheader('Options'));
console.log(` ${color('--yes, -y', 'command')} Skip confirmation prompts (auto-backup)`);
@@ -730,7 +682,12 @@ async function showHelp(): Promise {
console.log(` ${color('API profiles', 'command')} glm, glmt, km, custom API profiles`);
console.log(` ${color('CLIProxy', 'command')} gemini, codex, agy, qwen, kiro, ghcp`);
console.log(` ${color('Copilot', 'command')} copilot (requires copilot-api daemon)`);
- console.log(` ${dim('Account-based')} Not supported (uses CLAUDE_CONFIG_DIR)`);
+ console.log(
+ ` ${color('Account profiles', 'command')} work, personal, client (persists CLAUDE_CONFIG_DIR)`
+ );
+ console.log(
+ ` ${color('default', 'command')} Clears CCS-managed overrides or inherits mapped continuity`
+ );
console.log('');
console.log(subheader('Examples'));
console.log(` ${dim('# Persist GLM profile')}`);
@@ -745,6 +702,12 @@ async function showHelp(): Promise {
console.log(` ${dim('# Persist with auto-approve enabled')}`);
console.log(` ${color('ccs persist codex --dangerously-skip-permissions', 'command')}`);
console.log('');
+ console.log(` ${dim('# Persist an account profile for IDE/native Claude use')}`);
+ console.log(` ${color('ccs persist work --yes', 'command')}`);
+ console.log('');
+ console.log(` ${dim('# Reset to native Claude defaults (clear CCS-managed overrides)')}`);
+ console.log(` ${color('ccs persist default --yes', 'command')}`);
+ console.log('');
console.log(` ${dim('# List all backups')}`);
console.log(` ${color('ccs persist --list-backups', 'command')}`);
console.log('');
@@ -757,6 +720,12 @@ async function showHelp(): Promise {
console.log(subheader('Notes'));
console.log(' [i] CLIProxy profiles require the proxy to be running.');
console.log(' [i] Copilot profiles require copilot-api daemon.');
+ console.log(
+ ' [i] Account/default flows remove stale ANTHROPIC_* overrides before applying new setup.'
+ );
+ console.log(
+ ' [i] For IDE-local settings.json snippets, use: ccs env --format claude-extension'
+ );
console.log(
` [i] Backups are saved as ${getClaudeSettingsDisplayPath()}.backup.YYYYMMDD_HHMMSS`
);
@@ -798,9 +767,8 @@ export async function handlePersistCommand(args: string[]): Promise {
}
// Detect profile
const detector = new ProfileDetector();
- let profileResult: ProfileDetectionResult;
try {
- profileResult = detector.detectProfileType(parsedArgs.profile);
+ detector.detectProfileType(parsedArgs.profile);
} catch (error) {
const err = error as Error & { availableProfiles?: string };
console.log(fail(`Profile not found: ${parsedArgs.profile}`));
@@ -813,7 +781,7 @@ export async function handlePersistCommand(args: string[]): Promise {
// Resolve env vars
let resolved: ResolvedEnv;
try {
- resolved = await resolveProfileEnvVars(parsedArgs.profile, profileResult);
+ resolved = await resolveProfileEnvVars(parsedArgs.profile);
} catch (error) {
console.log(fail((error as Error).message));
process.exit(1);
@@ -823,21 +791,27 @@ export async function handlePersistCommand(args: string[]): Promise {
console.log('');
console.log(`Profile type: ${color(resolved.profileType, 'command')}`);
console.log('');
- console.log(`The following env vars will be written to ${getClaudeSettingsDisplayPath()}:`);
- console.log('');
- // Display env vars (mask sensitive values)
const envKeys = Object.keys(resolved.env);
- if (envKeys.length === 0) {
- console.log(fail('Profile has no environment variables to persist'));
- process.exit(1);
+ if (envKeys.length > 0) {
+ console.log(`The following env vars will be written to ${getClaudeSettingsDisplayPath()}:`);
+ console.log('');
+ const maxKeyLen = Math.max(...envKeys.map((k) => k.length));
+ for (const [key, value] of Object.entries(resolved.env)) {
+ const paddedKey = key.padEnd(maxKeyLen + 2);
+ const displayValue = isSensitiveEnvKey(key) ? maskApiKey(value) : value;
+ console.log(` ${color(paddedKey, 'command')} = ${displayValue}`);
+ }
+ console.log('');
+ } else {
+ console.log(info('No new env vars will be added.'));
+ console.log(dim(' CCS-managed transport overrides will be removed if present.'));
+ console.log('');
}
- const maxKeyLen = Math.max(...envKeys.map((k) => k.length));
- for (const [key, value] of Object.entries(resolved.env)) {
- const paddedKey = key.padEnd(maxKeyLen + 2);
- const displayValue = isSensitiveEnvKey(key) ? maskApiKey(value) : value;
- console.log(` ${color(paddedKey, 'command')} = ${displayValue}`);
+ if (resolved.clearEnvKeys.length > 0) {
+ console.log('Managed env keys replaced/cleared on write:');
+ console.log(` ${dim(resolved.clearEnvKeys.join(', '))}`);
+ console.log('');
}
- console.log('');
if (resolvedPermissionMode) {
console.log(`Default permission mode: ${color(resolvedPermissionMode, 'command')}`);
if (resolvedPermissionMode === 'bypassPermissions') {
@@ -845,14 +819,24 @@ export async function handlePersistCommand(args: string[]): Promise {
}
console.log('');
}
- // Show warning if applicable
- if (resolved.warning) {
- console.log(warn(resolved.warning));
+ if (resolved.warnings?.length) {
+ for (const message of resolved.warnings) {
+ console.log(warn(message));
+ }
+ console.log('');
+ }
+ if (resolved.notes?.length) {
+ for (const note of resolved.notes) {
+ console.log(info(note));
+ }
console.log('');
}
// Warning about modification
console.log(warn(`This will modify ${getClaudeSettingsDisplayPath()}`));
console.log(dim(' Existing hooks and other settings will be preserved.'));
+ console.log(
+ dim(' Existing managed profile env keys will be replaced to avoid stale routing.')
+ );
console.log('');
// Check if settings.json exists for backup
const settingsPath = getClaudeSettingsPath();
@@ -904,10 +888,15 @@ export async function handlePersistCommand(args: string[]): Promise {
}
}
+ const preservedEnv = { ...existingEnv };
+ for (const key of resolved.clearEnvKeys) {
+ delete preservedEnv[key];
+ }
+
const mergedSettings: Record = {
...existingSettings,
env: {
- ...existingEnv,
+ ...preservedEnv,
...resolved.env,
},
};
diff --git a/src/copilot/copilot-executor.ts b/src/copilot/copilot-executor.ts
index 7225b5ed..8f885cbd 100644
--- a/src/copilot/copilot-executor.ts
+++ b/src/copilot/copilot-executor.ts
@@ -11,8 +11,9 @@ import { getGlobalEnvConfig } from '../config/unified-config-loader';
import { checkAuthStatus, isCopilotApiInstalled } from './copilot-auth';
import { isDaemonRunning, startDaemon } from './copilot-daemon';
import { ensureCopilotApi } from './copilot-package-manager';
+import { normalizeCopilotConfigWithWarnings } from './copilot-model-normalizer';
import { CopilotStatus } from './types';
-import { fail, info, ok } from '../utils/ui';
+import { fail, info, ok, warn } from '../utils/ui';
import { getWebSearchHookEnv } from '../utils/websearch-manager';
import { getImageAnalysisHookEnv } from '../utils/hooks';
import { stripClaudeCodeEnv } from '../utils/shell-executor';
@@ -21,16 +22,17 @@ import { stripClaudeCodeEnv } from '../utils/shell-executor';
* Get full copilot status (auth + daemon).
*/
export async function getCopilotStatus(config: CopilotConfig): Promise {
+ const normalizedConfig = normalizeCopilotConfigWithWarnings(config).config;
const [auth, daemonRunning] = await Promise.all([
checkAuthStatus(),
- isDaemonRunning(config.port),
+ isDaemonRunning(normalizedConfig.port),
]);
return {
auth,
daemon: {
running: daemonRunning,
- port: config.port,
+ port: normalizedConfig.port,
},
};
}
@@ -43,17 +45,19 @@ export function generateCopilotEnv(
config: CopilotConfig,
claudeConfigDir?: string
): Record {
+ const normalizedConfig = normalizeCopilotConfigWithWarnings(config).config;
+
// Use mapped models if configured, otherwise fall back to default model
- const opusModel = config.opus_model || config.model;
- const sonnetModel = config.sonnet_model || config.model;
- const haikuModel = config.haiku_model || config.model;
+ const opusModel = normalizedConfig.opus_model || normalizedConfig.model;
+ const sonnetModel = normalizedConfig.sonnet_model || normalizedConfig.model;
+ const haikuModel = normalizedConfig.haiku_model || normalizedConfig.model;
// Use 127.0.0.1 instead of localhost for more reliable local connections
// (bypasses DNS resolution and potential IPv6 issues)
return {
- ANTHROPIC_BASE_URL: `http://127.0.0.1:${config.port}`,
+ ANTHROPIC_BASE_URL: `http://127.0.0.1:${normalizedConfig.port}`,
ANTHROPIC_AUTH_TOKEN: 'dummy', // copilot-api handles auth internally
- ANTHROPIC_MODEL: config.model,
+ ANTHROPIC_MODEL: normalizedConfig.model,
// Model tier mapping - allows different models for opus/sonnet/haiku
ANTHROPIC_DEFAULT_OPUS_MODEL: opusModel,
ANTHROPIC_DEFAULT_SONNET_MODEL: sonnetModel,
@@ -79,6 +83,16 @@ export async function executeCopilotProfile(
claudeConfigDir?: string,
claudeCliPath: string = 'claude'
): Promise {
+ const { config: normalizedConfig, warnings } = normalizeCopilotConfigWithWarnings(config);
+
+ if (warnings.length > 0) {
+ warnings.forEach(({ message }) => console.log(warn(message)));
+ console.log(
+ warn('Run `ccs config` and save the Copilot section to persist these replacements.')
+ );
+ console.log('');
+ }
+
// Ensure copilot-api is installed (auto-install if missing, auto-update if outdated)
try {
await ensureCopilotApi();
@@ -111,17 +125,17 @@ export async function executeCopilotProfile(
}
// Check if daemon is running or needs to be started
- let daemonRunning = await isDaemonRunning(config.port);
+ let daemonRunning = await isDaemonRunning(normalizedConfig.port);
if (!daemonRunning) {
- if (config.auto_start) {
+ if (normalizedConfig.auto_start) {
console.log(info('Starting copilot-api daemon...'));
- const result = await startDaemon(config);
+ const result = await startDaemon(normalizedConfig);
if (!result.success) {
console.error(fail(`Failed to start daemon: ${result.error}`));
return 1;
}
- console.log(ok(`Daemon started on port ${config.port}`));
+ console.log(ok(`Daemon started on port ${normalizedConfig.port}`));
daemonRunning = true;
} else {
console.error(fail('copilot-api daemon is not running.'));
@@ -129,7 +143,7 @@ export async function executeCopilotProfile(
console.error('Start the daemon:');
console.error(' ccs copilot start');
console.error('Fallback manual command:');
- console.error(` npx copilot-api start --port ${config.port}`);
+ console.error(` npx copilot-api start --port ${normalizedConfig.port}`);
console.error('');
console.error('Or enable auto_start in config:');
console.error(' ccs config (then enable auto_start in Copilot section)');
@@ -138,7 +152,7 @@ export async function executeCopilotProfile(
}
// Generate environment for Claude
- const copilotEnv = generateCopilotEnv(config, claudeConfigDir);
+ const copilotEnv = generateCopilotEnv(normalizedConfig, claudeConfigDir);
// Get global env vars (DISABLE_TELEMETRY, etc.) for third-party profiles
const globalEnvConfig = getGlobalEnvConfig();
@@ -156,7 +170,7 @@ export async function executeCopilotProfile(
CCS_PROFILE_TYPE: 'copilot',
});
- console.log(info(`Using GitHub Copilot proxy (model: ${config.model})`));
+ console.log(info(`Using GitHub Copilot proxy (model: ${normalizedConfig.model})`));
console.log('');
// Spawn Claude CLI
diff --git a/src/copilot/copilot-model-normalizer.ts b/src/copilot/copilot-model-normalizer.ts
new file mode 100644
index 00000000..a2dc3517
--- /dev/null
+++ b/src/copilot/copilot-model-normalizer.ts
@@ -0,0 +1,271 @@
+import { DEFAULT_COPILOT_CONFIG, type CopilotConfig } from '../config/unified-config-types';
+
+const LEGACY_COPILOT_MODEL_FALLBACKS: Readonly> = Object.freeze({
+ // copilot-api v0.7.0 no longer advertises this ID in /v1/models and rejects it at runtime.
+ 'raptor-mini': DEFAULT_COPILOT_CONFIG.model,
+});
+
+export const DEPRECATED_COPILOT_MODEL_IDS = Object.freeze(
+ Object.keys(LEGACY_COPILOT_MODEL_FALLBACKS)
+);
+
+export type CopilotNormalizationSource = 'config' | 'settings';
+export type CopilotNormalizationTier = 'default' | 'opus' | 'sonnet' | 'haiku';
+
+export interface CopilotNormalizationWarning {
+ source: CopilotNormalizationSource;
+ tier: CopilotNormalizationTier;
+ original: string;
+ replacement: string;
+ message: string;
+}
+
+export interface CopilotSettingsPayload {
+ env?: Record;
+ [key: string]: unknown;
+}
+
+export interface NormalizedCopilotConfigResult {
+ config: CopilotConfig;
+ warnings: CopilotNormalizationWarning[];
+}
+
+export interface NormalizedCopilotSettingsResult {
+ settings: CopilotSettingsPayload;
+ effectiveConfig: CopilotConfig;
+ warnings: CopilotNormalizationWarning[];
+}
+
+function trimModelId(value: string | null | undefined): string | undefined {
+ if (typeof value !== 'string') return undefined;
+ const trimmed = value.trim();
+ return trimmed.length > 0 ? trimmed : undefined;
+}
+
+function getTierLabel(tier: CopilotNormalizationTier): string {
+ switch (tier) {
+ case 'default':
+ return 'default';
+ case 'opus':
+ return 'Opus';
+ case 'sonnet':
+ return 'Sonnet';
+ case 'haiku':
+ return 'Haiku';
+ }
+}
+
+function createWarning(
+ source: CopilotNormalizationSource,
+ tier: CopilotNormalizationTier,
+ original: string,
+ replacement: string
+): CopilotNormalizationWarning {
+ return {
+ source,
+ tier,
+ original,
+ replacement,
+ message: `Copilot ${getTierLabel(tier)} model '${original}' is no longer supported. CCS will use '${replacement}' instead.`,
+ };
+}
+
+function appendWarning(
+ warnings: CopilotNormalizationWarning[],
+ warning?: CopilotNormalizationWarning
+): void {
+ if (!warning) return;
+ const key = `${warning.source}:${warning.tier}:${warning.original.toLowerCase()}:${warning.replacement.toLowerCase()}`;
+ if (
+ warnings.some(
+ (entry) =>
+ `${entry.source}:${entry.tier}:${entry.original.toLowerCase()}:${entry.replacement.toLowerCase()}` ===
+ key
+ )
+ ) {
+ return;
+ }
+ warnings.push(warning);
+}
+
+function normalizeRequiredModelSelection(
+ model: string | null | undefined,
+ fallbackModel: string,
+ source: CopilotNormalizationSource,
+ tier: CopilotNormalizationTier
+): { value: string; warning?: CopilotNormalizationWarning } {
+ const normalizedFallback = trimModelId(fallbackModel) ?? DEFAULT_COPILOT_CONFIG.model;
+ const trimmedModel = trimModelId(model) ?? normalizedFallback;
+ const replacement = LEGACY_COPILOT_MODEL_FALLBACKS[trimmedModel.toLowerCase()];
+ if (!replacement) return { value: trimmedModel };
+ return {
+ value: replacement,
+ warning: createWarning(source, tier, trimmedModel, replacement),
+ };
+}
+
+function normalizeOptionalModelSelection(
+ model: string | null | undefined,
+ fallbackModel: string,
+ source: CopilotNormalizationSource,
+ tier: CopilotNormalizationTier
+): { value?: string; warning?: CopilotNormalizationWarning } {
+ const trimmedModel = trimModelId(model);
+ if (!trimmedModel) return { value: undefined };
+ if (!LEGACY_COPILOT_MODEL_FALLBACKS[trimmedModel.toLowerCase()]) {
+ return { value: trimmedModel };
+ }
+ const replacement = trimModelId(fallbackModel) ?? DEFAULT_COPILOT_CONFIG.model;
+ return {
+ value: replacement,
+ warning: createWarning(source, tier, trimmedModel, replacement),
+ };
+}
+
+function getSettingsEnv(settings: CopilotSettingsPayload): Record {
+ return settings.env && typeof settings.env === 'object' && !Array.isArray(settings.env)
+ ? settings.env
+ : {};
+}
+
+function getSettingsPayload(settings: CopilotSettingsPayload): CopilotSettingsPayload {
+ return settings && typeof settings === 'object' && !Array.isArray(settings) ? settings : {};
+}
+
+export function normalizeCopilotModelId(
+ model: string | null | undefined,
+ fallbackModel: string = DEFAULT_COPILOT_CONFIG.model
+): string {
+ return normalizeRequiredModelSelection(model, fallbackModel, 'config', 'default').value;
+}
+
+export function normalizeCopilotConfigWithWarnings(
+ config: CopilotConfig
+): NormalizedCopilotConfigResult {
+ const warnings: CopilotNormalizationWarning[] = [];
+ const baseModel = normalizeRequiredModelSelection(
+ config.model,
+ DEFAULT_COPILOT_CONFIG.model,
+ 'config',
+ 'default'
+ );
+ appendWarning(warnings, baseModel.warning);
+
+ const opusModel = normalizeOptionalModelSelection(
+ config.opus_model,
+ baseModel.value,
+ 'config',
+ 'opus'
+ );
+ const sonnetModel = normalizeOptionalModelSelection(
+ config.sonnet_model,
+ baseModel.value,
+ 'config',
+ 'sonnet'
+ );
+ const haikuModel = normalizeOptionalModelSelection(
+ config.haiku_model,
+ baseModel.value,
+ 'config',
+ 'haiku'
+ );
+ appendWarning(warnings, opusModel.warning);
+ appendWarning(warnings, sonnetModel.warning);
+ appendWarning(warnings, haikuModel.warning);
+
+ return {
+ config: {
+ ...config,
+ model: baseModel.value,
+ opus_model: opusModel.value,
+ sonnet_model: sonnetModel.value,
+ haiku_model: haikuModel.value,
+ },
+ warnings,
+ };
+}
+
+export function normalizeCopilotConfig(config: CopilotConfig): CopilotConfig {
+ return normalizeCopilotConfigWithWarnings(config).config;
+}
+
+export function normalizeCopilotSettingsWithWarnings(
+ settings: CopilotSettingsPayload,
+ fallbackConfig: CopilotConfig = DEFAULT_COPILOT_CONFIG
+): NormalizedCopilotSettingsResult {
+ const configResult = normalizeCopilotConfigWithWarnings(fallbackConfig);
+ const warnings = [...configResult.warnings];
+ const payload = getSettingsPayload(settings);
+ const rawEnv = getSettingsEnv(payload);
+
+ const baseModel = normalizeRequiredModelSelection(
+ typeof rawEnv.ANTHROPIC_MODEL === 'string' ? rawEnv.ANTHROPIC_MODEL : configResult.config.model,
+ configResult.config.model,
+ 'settings',
+ 'default'
+ );
+ appendWarning(warnings, baseModel.warning);
+
+ const opusModel = normalizeOptionalModelSelection(
+ typeof rawEnv.ANTHROPIC_DEFAULT_OPUS_MODEL === 'string'
+ ? rawEnv.ANTHROPIC_DEFAULT_OPUS_MODEL
+ : configResult.config.opus_model,
+ baseModel.value,
+ 'settings',
+ 'opus'
+ );
+ const sonnetModel = normalizeOptionalModelSelection(
+ typeof rawEnv.ANTHROPIC_DEFAULT_SONNET_MODEL === 'string'
+ ? rawEnv.ANTHROPIC_DEFAULT_SONNET_MODEL
+ : configResult.config.sonnet_model,
+ baseModel.value,
+ 'settings',
+ 'sonnet'
+ );
+ const rawHaikuModel =
+ typeof rawEnv.ANTHROPIC_SMALL_FAST_MODEL === 'string'
+ ? rawEnv.ANTHROPIC_SMALL_FAST_MODEL
+ : typeof rawEnv.ANTHROPIC_DEFAULT_HAIKU_MODEL === 'string'
+ ? rawEnv.ANTHROPIC_DEFAULT_HAIKU_MODEL
+ : configResult.config.haiku_model;
+ const haikuModel = normalizeOptionalModelSelection(
+ rawHaikuModel,
+ baseModel.value,
+ 'settings',
+ 'haiku'
+ );
+ appendWarning(warnings, opusModel.warning);
+ appendWarning(warnings, sonnetModel.warning);
+ appendWarning(warnings, haikuModel.warning);
+
+ const effectiveConfig = {
+ ...configResult.config,
+ model: baseModel.value,
+ opus_model: opusModel.value ?? baseModel.value,
+ sonnet_model: sonnetModel.value ?? baseModel.value,
+ haiku_model: haikuModel.value ?? baseModel.value,
+ };
+
+ return {
+ settings: {
+ ...payload,
+ env: {
+ ...rawEnv,
+ ANTHROPIC_MODEL: effectiveConfig.model,
+ ANTHROPIC_DEFAULT_OPUS_MODEL: effectiveConfig.opus_model,
+ ANTHROPIC_DEFAULT_SONNET_MODEL: effectiveConfig.sonnet_model,
+ ANTHROPIC_DEFAULT_HAIKU_MODEL: effectiveConfig.haiku_model,
+ ANTHROPIC_SMALL_FAST_MODEL: effectiveConfig.haiku_model,
+ },
+ },
+ effectiveConfig,
+ warnings,
+ };
+}
+
+export function normalizeCopilotSettings(
+ settings: CopilotSettingsPayload,
+ fallbackConfig: CopilotConfig = DEFAULT_COPILOT_CONFIG
+): CopilotSettingsPayload {
+ return normalizeCopilotSettingsWithWarnings(settings, fallbackConfig).settings;
+}
diff --git a/src/copilot/copilot-models.ts b/src/copilot/copilot-models.ts
index 667e6d06..a97c6ef7 100644
--- a/src/copilot/copilot-models.ts
+++ b/src/copilot/copilot-models.ts
@@ -155,16 +155,6 @@ export const DEFAULT_COPILOT_MODELS: CopilotModel[] = [
minPlan: 'pro',
multiplier: 0.25,
},
-
- // Fine-tuned Models
- {
- id: 'raptor-mini',
- name: 'Raptor Mini',
- provider: 'openai',
- minPlan: 'free',
- multiplier: 0,
- preview: true,
- },
];
/**
diff --git a/src/copilot/index.ts b/src/copilot/index.ts
index e692e09d..9323d9d3 100644
--- a/src/copilot/index.ts
+++ b/src/copilot/index.ts
@@ -44,6 +44,16 @@ export {
getDefaultModel,
} from './copilot-models';
+// Normalization
+export {
+ DEPRECATED_COPILOT_MODEL_IDS,
+ normalizeCopilotConfig,
+ normalizeCopilotConfigWithWarnings,
+ normalizeCopilotModelId,
+ normalizeCopilotSettings,
+ normalizeCopilotSettingsWithWarnings,
+} from './copilot-model-normalizer';
+
// Usage
export {
normalizeCopilotUsage,
diff --git a/src/shared/claude-extension-hosts.ts b/src/shared/claude-extension-hosts.ts
new file mode 100644
index 00000000..e9f3aca1
--- /dev/null
+++ b/src/shared/claude-extension-hosts.ts
@@ -0,0 +1,44 @@
+export type ClaudeExtensionHost = 'vscode' | 'cursor' | 'windsurf';
+
+export interface ClaudeExtensionHostDefinition {
+ id: ClaudeExtensionHost;
+ label: string;
+ settingsKey: string;
+ disableLoginPromptKey?: string;
+ settingsTargetLabel: string;
+ description: string;
+}
+
+export const CLAUDE_EXTENSION_HOSTS: ClaudeExtensionHostDefinition[] = [
+ {
+ id: 'vscode',
+ label: 'VS Code',
+ settingsKey: 'claudeCode.environmentVariables',
+ disableLoginPromptKey: 'claudeCode.disableLoginPrompt',
+ settingsTargetLabel: 'VS Code user or workspace settings.json',
+ description: 'Official Anthropic VS Code extension with camelCase settings keys.',
+ },
+ {
+ id: 'cursor',
+ label: 'Cursor',
+ settingsKey: 'claudeCode.environmentVariables',
+ disableLoginPromptKey: 'claudeCode.disableLoginPrompt',
+ settingsTargetLabel: 'Cursor user or workspace settings.json',
+ description: 'VS Code-compatible host using the Anthropic extension schema.',
+ },
+ {
+ id: 'windsurf',
+ label: 'Windsurf',
+ settingsKey: 'claude-code.environmentVariables',
+ settingsTargetLabel: 'Windsurf user settings.json',
+ description: 'Current Windsurf Anthropic extension build uses legacy kebab-case keys.',
+ },
+];
+
+export function getClaudeExtensionHostDefinition(
+ host: ClaudeExtensionHost = 'vscode'
+): ClaudeExtensionHostDefinition {
+ return (
+ CLAUDE_EXTENSION_HOSTS.find((candidate) => candidate.id === host) ?? CLAUDE_EXTENSION_HOSTS[0]
+ );
+}
diff --git a/src/shared/claude-extension-setup.ts b/src/shared/claude-extension-setup.ts
new file mode 100644
index 00000000..dddf3efd
--- /dev/null
+++ b/src/shared/claude-extension-setup.ts
@@ -0,0 +1,315 @@
+import { loadSettingsFromFile, type ProfileType } from '../auth/profile-detector';
+import ProfileDetector from '../auth/profile-detector';
+import { resolveProfileContinuityInheritance } from '../auth/profile-continuity-inheritance';
+import { resolveAccountContextPolicy, isAccountContextMetadata } from '../auth/account-context';
+import type { ProfileDetectionResult } from '../auth/profile-detector';
+import {
+ getEffectiveEnvVars,
+ getRemoteEnvVars,
+ getCompositeEnvVars,
+} from '../cliproxy/config/env-builder';
+import { CLIPROXY_DEFAULT_PORT } from '../cliproxy/config/port-manager';
+import { getProxyTarget } from '../cliproxy/proxy-target-resolver';
+import { generateCopilotEnv } from '../copilot/copilot-executor';
+import InstanceManager from '../management/instance-manager';
+import { expandPath } from '../utils/helpers';
+import { getClaudeSettingsPath } from '../utils/claude-config-path';
+import {
+ type ClaudeExtensionHost,
+ type ClaudeExtensionHostDefinition,
+ getClaudeExtensionHostDefinition,
+} from './claude-extension-hosts';
+
+export interface ClaudeExtensionProfileOption {
+ name: string;
+ profileType: ProfileType;
+ label: string;
+ description: string;
+}
+
+export interface ClaudeExtensionSetup {
+ requestedProfile: string;
+ resolvedProfileName: string;
+ profileType: ProfileType;
+ profileLabel: string;
+ profileDescription: string;
+ extensionEnv: Record;
+ removeEnvKeys: string[];
+ warnings: string[];
+ notes: string[];
+ disableLoginPrompt: boolean;
+}
+
+export const CLAUDE_EXTENSION_MANAGED_ENV_KEYS = [
+ 'ANTHROPIC_API_KEY',
+ 'ANTHROPIC_AUTH_TOKEN',
+ 'ANTHROPIC_BASE_URL',
+ 'ANTHROPIC_MODEL',
+ 'ANTHROPIC_MAX_TOKENS',
+ 'ANTHROPIC_SAFE_MODE',
+ 'ANTHROPIC_TEMPERATURE',
+ 'ANTHROPIC_SMALL_FAST_MODEL',
+ 'ANTHROPIC_DEFAULT_OPUS_MODEL',
+ 'ANTHROPIC_DEFAULT_SONNET_MODEL',
+ 'ANTHROPIC_DEFAULT_HAIKU_MODEL',
+ 'API_TIMEOUT_MS',
+ 'CLAUDE_CONFIG_DIR',
+ 'DISABLE_NON_ESSENTIAL_MODEL_CALLS',
+ 'CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC',
+ 'ENABLE_STREAMING',
+ 'MAX_THINKING_TOKENS',
+] as const;
+
+function sortUniqueEnvKeys(keys: Iterable): string[] {
+ return [...new Set(keys)].sort((left, right) => left.localeCompare(right));
+}
+
+function sortEnvRecord(env: NodeJS.ProcessEnv | Record): Record {
+ const normalized: Record = {};
+
+ for (const [key, value] of Object.entries(env)) {
+ if (typeof value === 'string') {
+ normalized[key] = value;
+ }
+ }
+
+ return Object.fromEntries(
+ Object.entries(normalized).sort(([left], [right]) => left.localeCompare(right))
+ );
+}
+
+function describeProfile(profileName: string, result: ProfileDetectionResult): string {
+ if (profileName === 'default') {
+ return result.name === 'default'
+ ? 'Use Claude Code defaults with no CCS-specific transport override.'
+ : `Use the current default profile resolution for "${result.name}".`;
+ }
+ if (result.type === 'cliproxy')
+ return 'OAuth or CLIProxy-backed profile for Anthropic-compatible routing.';
+ if (result.type === 'settings') return 'API profile backed by a CCS settings file.';
+ if (result.type === 'account')
+ return 'Claude account instance isolated through CLAUDE_CONFIG_DIR.';
+ if (result.type === 'copilot') return 'GitHub Copilot profile routed through copilot-api.';
+ return 'Native Claude profile resolution.';
+}
+
+function createProfileOption(
+ profileName: string,
+ result: ProfileDetectionResult
+): ClaudeExtensionProfileOption {
+ return {
+ name: profileName,
+ profileType: result.type,
+ label: profileName === 'default' ? 'default' : result.name,
+ description: describeProfile(profileName, result),
+ };
+}
+
+export function listClaudeExtensionProfiles(): ClaudeExtensionProfileOption[] {
+ const detector = new ProfileDetector();
+ const all = detector.getAllProfiles();
+ const orderedNames = [
+ 'default',
+ ...all.accounts,
+ ...all.settings,
+ ...all.cliproxy,
+ ...all.cliproxyVariants,
+ ];
+ const deduped = [...new Set(orderedNames)];
+ try {
+ detector.detectProfileType('copilot');
+ deduped.push('copilot');
+ } catch {
+ // Copilot disabled; skip from setup UI.
+ }
+
+ return deduped
+ .map((profileName) => createProfileOption(profileName, detector.detectProfileType(profileName)))
+ .sort((left, right) => deduped.indexOf(left.name) - deduped.indexOf(right.name));
+}
+
+async function resolveExtensionEnv(
+ requestedProfile: string,
+ result: ProfileDetectionResult
+): Promise<
+ Pick
+> {
+ const warnings: string[] = [];
+ const notes: string[] = [];
+ const requestedIsDefault = requestedProfile === 'default';
+
+ if (result.type === 'account') {
+ const instanceManager = new InstanceManager();
+ const policy = resolveAccountContextPolicy(
+ isAccountContextMetadata(result.profile) ? result.profile : undefined
+ );
+ const instancePath = await instanceManager.ensureInstance(result.name, policy, {
+ bare: result.profile?.bare === true,
+ });
+ notes.push('Account profiles authenticate through the isolated Claude config directory.');
+ return {
+ extensionEnv: { CLAUDE_CONFIG_DIR: instancePath },
+ warnings,
+ notes,
+ disableLoginPrompt: false,
+ };
+ }
+
+ if (result.type === 'default') {
+ const continuity = await resolveProfileContinuityInheritance({
+ profileName: requestedProfile,
+ profileType: result.type,
+ target: 'claude',
+ });
+ if (continuity.claudeConfigDir) {
+ notes.push(`Default profile inherits continuity from account "${continuity.sourceAccount}".`);
+ return {
+ extensionEnv: { CLAUDE_CONFIG_DIR: continuity.claudeConfigDir },
+ warnings,
+ notes,
+ disableLoginPrompt: false,
+ };
+ }
+
+ notes.push(
+ 'Default profile clears CCS-managed transport overrides and uses native Claude defaults.'
+ );
+ return { extensionEnv: {}, warnings, notes, disableLoginPrompt: false };
+ }
+
+ const continuity = await resolveProfileContinuityInheritance({
+ profileName: requestedProfile,
+ profileType: result.type,
+ target: 'claude',
+ });
+ const env =
+ result.type === 'settings'
+ ? (result.env ??
+ (result.settingsPath ? loadSettingsFromFile(expandPath(result.settingsPath)) : {}))
+ : result.type === 'copilot'
+ ? (() => {
+ if (!result.copilotConfig) {
+ throw new Error(`Profile "${requestedProfile}" is missing copilot configuration.`);
+ }
+ return generateCopilotEnv(result.copilotConfig, continuity.claudeConfigDir);
+ })()
+ : (() => {
+ if (!result.provider) {
+ throw new Error(
+ `Profile "${requestedProfile}" is missing CLIProxy provider metadata.`
+ );
+ }
+ const proxyTarget = getProxyTarget();
+ const port = result.port || CLIPROXY_DEFAULT_PORT;
+ if (proxyTarget.isRemote) {
+ warnings.push(
+ `CLIProxy is configured for remote routing via ${proxyTarget.protocol}://${proxyTarget.host}:${proxyTarget.port}.`
+ );
+ return result.isComposite && result.compositeTiers && result.compositeDefaultTier
+ ? getCompositeEnvVars(
+ result.compositeTiers,
+ result.compositeDefaultTier,
+ port,
+ result.settingsPath,
+ proxyTarget
+ )
+ : getRemoteEnvVars(result.provider, proxyTarget, result.settingsPath);
+ }
+ warnings.push(
+ 'CLIProxy-backed profiles require the local or remote proxy endpoint to be reachable.'
+ );
+ return result.isComposite && result.compositeTiers && result.compositeDefaultTier
+ ? getCompositeEnvVars(
+ result.compositeTiers,
+ result.compositeDefaultTier,
+ port,
+ result.settingsPath
+ )
+ : getEffectiveEnvVars(result.provider, port, result.settingsPath);
+ })();
+
+ if (!requestedIsDefault && continuity.claudeConfigDir && !env.CLAUDE_CONFIG_DIR) {
+ env.CLAUDE_CONFIG_DIR = continuity.claudeConfigDir;
+ notes.push(
+ `Continuity inheritance adds CLAUDE_CONFIG_DIR from account "${continuity.sourceAccount}".`
+ );
+ }
+ if (result.type === 'copilot') {
+ warnings.push(
+ 'copilot-api must stay reachable for this profile to work inside the IDE extension.'
+ );
+ }
+ if (Object.keys(env).length === 0) {
+ throw new Error(`Profile "${requestedProfile}" has no extension environment to export.`);
+ }
+
+ return { extensionEnv: sortEnvRecord(env), warnings, notes, disableLoginPrompt: true };
+}
+
+export async function resolveClaudeExtensionSetup(
+ requestedProfile: string
+): Promise {
+ const detector = new ProfileDetector();
+ const result = detector.detectProfileType(requestedProfile);
+ const resolved = await resolveExtensionEnv(requestedProfile, result);
+
+ return {
+ requestedProfile,
+ resolvedProfileName: result.name,
+ profileType: result.type,
+ profileLabel: requestedProfile === 'default' ? 'default' : result.name,
+ profileDescription: describeProfile(requestedProfile, result),
+ extensionEnv: resolved.extensionEnv,
+ removeEnvKeys: sortUniqueEnvKeys([
+ ...CLAUDE_EXTENSION_MANAGED_ENV_KEYS,
+ ...Object.keys(resolved.extensionEnv),
+ ]),
+ warnings: resolved.warnings,
+ notes: resolved.notes,
+ disableLoginPrompt: resolved.disableLoginPrompt,
+ };
+}
+
+export function buildClaudeExtensionSettingsObject(
+ setup: ClaudeExtensionSetup,
+ host: ClaudeExtensionHost
+): Record {
+ const definition = getClaudeExtensionHostDefinition(host);
+ const payload: Record = {
+ [definition.settingsKey]: Object.entries(setup.extensionEnv).map(([name, value]) => ({
+ name,
+ value,
+ })),
+ };
+ if (definition.disableLoginPromptKey && setup.disableLoginPrompt) {
+ payload[definition.disableLoginPromptKey] = true;
+ }
+ return payload;
+}
+
+export function buildSharedClaudeSettingsObject(
+ setup: ClaudeExtensionSetup
+): Record> {
+ return { env: setup.extensionEnv };
+}
+
+export function renderClaudeExtensionSettingsJson(
+ setup: ClaudeExtensionSetup,
+ host: ClaudeExtensionHost
+): string {
+ return JSON.stringify(buildClaudeExtensionSettingsObject(setup, host), null, 2);
+}
+
+export function renderSharedClaudeSettingsJson(setup: ClaudeExtensionSetup): string {
+ return JSON.stringify(buildSharedClaudeSettingsObject(setup), null, 2);
+}
+
+export function getClaudeExtensionHostMetadata(
+ host: ClaudeExtensionHost
+): ClaudeExtensionHostDefinition {
+ return getClaudeExtensionHostDefinition(host);
+}
+
+export function getClaudeSharedSettingsPath(): string {
+ return getClaudeSettingsPath();
+}
diff --git a/src/utils/fetch-proxy-setup.ts b/src/utils/fetch-proxy-setup.ts
new file mode 100644
index 00000000..7883bc2f
--- /dev/null
+++ b/src/utils/fetch-proxy-setup.ts
@@ -0,0 +1,164 @@
+/**
+ * Global Fetch Proxy Setup
+ *
+ * Configures undici's global dispatcher to respect standard proxy environment
+ * variables without routing CCS loopback traffic back through the proxy.
+ */
+
+import { Agent, Dispatcher, ProxyAgent, fetch as undiciFetch, setGlobalDispatcher } from 'undici';
+import { getProxyResolution, shouldBypassProxy } from './proxy-env';
+
+const FETCH_PROXY_PROTOCOLS = ['http:', 'https:'];
+
+type GlobalFetchProxyConfig = {
+ httpProxyUrl?: string;
+ httpsProxyUrl?: string;
+ error?: string;
+};
+
+class RoutingProxyDispatcher extends Dispatcher {
+ private readonly directDispatcher = new Agent();
+ private readonly httpProxyDispatcher: ProxyAgent | null;
+ private readonly httpsProxyDispatcher: ProxyAgent | null;
+
+ constructor(httpProxyUrl: string | undefined, httpsProxyUrl: string | undefined) {
+ super();
+ this.httpProxyDispatcher = httpProxyUrl ? new ProxyAgent(httpProxyUrl) : null;
+ this.httpsProxyDispatcher = httpsProxyUrl ? new ProxyAgent(httpsProxyUrl) : null;
+ }
+
+ dispatch(options: Dispatcher.DispatchOptions, handler: Dispatcher.DispatchHandlers): boolean {
+ return this.resolveDispatcher(options.origin).dispatch(options, handler);
+ }
+
+ close(): Promise;
+ close(callback: () => void): void;
+ close(callback?: () => void): Promise | void {
+ const promise = Promise.all(this.getDispatchers().map((dispatcher) => dispatcher.close())).then(
+ () => undefined
+ );
+
+ if (callback) {
+ promise.then(
+ () => callback(),
+ () => callback()
+ );
+ return;
+ }
+
+ return promise;
+ }
+
+ destroy(): Promise;
+ destroy(err: Error | null): Promise;
+ destroy(callback: () => void): void;
+ destroy(err: Error | null, callback: () => void): void;
+ destroy(
+ errOrCallback?: Error | null | (() => void),
+ callback?: () => void
+ ): Promise | void {
+ const error = typeof errOrCallback === 'function' ? null : errOrCallback;
+ const done = typeof errOrCallback === 'function' ? errOrCallback : callback;
+ const promise = Promise.all(
+ this.getDispatchers().map((dispatcher) => dispatcher.destroy(error ?? null))
+ ).then(() => undefined);
+
+ if (done) {
+ promise.then(
+ () => done(),
+ () => done()
+ );
+ return;
+ }
+
+ return promise;
+ }
+
+ private resolveDispatcher(origin: string | URL | undefined): Dispatcher {
+ if (!origin) {
+ return this.directDispatcher;
+ }
+
+ let url: URL;
+ try {
+ url = origin instanceof URL ? origin : new URL(origin);
+ } catch {
+ return this.directDispatcher;
+ }
+
+ if (shouldBypassProxy(url.hostname)) {
+ return this.directDispatcher;
+ }
+
+ if (url.protocol === 'https:' && this.httpsProxyDispatcher) {
+ return this.httpsProxyDispatcher;
+ }
+
+ if (url.protocol === 'http:' && this.httpProxyDispatcher) {
+ return this.httpProxyDispatcher;
+ }
+
+ return this.directDispatcher;
+ }
+
+ private getDispatchers(): Dispatcher[] {
+ return Array.from(
+ new Set(
+ [this.directDispatcher, this.httpProxyDispatcher, this.httpsProxyDispatcher].filter(
+ (dispatcher): dispatcher is Dispatcher => dispatcher !== null
+ )
+ )
+ );
+ }
+}
+
+export function createGlobalFetchProxyDispatcher(): Dispatcher | null {
+ const { httpProxyUrl, httpsProxyUrl } = resolveGlobalFetchProxyConfig();
+
+ if (!httpProxyUrl && !httpsProxyUrl) {
+ return null;
+ }
+
+ return new RoutingProxyDispatcher(httpProxyUrl, httpsProxyUrl);
+}
+
+export function applyGlobalFetchProxy(): { enabled: boolean; error?: string } {
+ try {
+ const config = resolveGlobalFetchProxyConfig();
+ if (!config.httpProxyUrl && !config.httpsProxyUrl) {
+ return config.error ? { enabled: false, error: config.error } : { enabled: false };
+ }
+
+ const dispatcher = createGlobalFetchProxyDispatcher();
+ if (!dispatcher) {
+ return { enabled: false };
+ }
+
+ setGlobalDispatcher(dispatcher);
+ globalThis.fetch = undiciFetch as typeof globalThis.fetch;
+ return { enabled: true };
+ } catch (error) {
+ const message = error instanceof Error ? error.message : 'Unknown proxy configuration error';
+ return { enabled: false, error: message };
+ }
+}
+
+const setupResult = applyGlobalFetchProxy();
+if (setupResult.error) {
+ console.error(`[!] Skipping global fetch proxy setup: ${setupResult.error}`);
+}
+
+function resolveGlobalFetchProxyConfig(): GlobalFetchProxyConfig {
+ const httpProxy = getProxyResolution(false, process.env, {
+ allowedProtocols: FETCH_PROXY_PROTOCOLS,
+ });
+ const httpsProxy = getProxyResolution(true, process.env, {
+ allowedProtocols: FETCH_PROXY_PROTOCOLS,
+ });
+
+ return {
+ httpProxyUrl: httpProxy.url,
+ httpsProxyUrl: httpsProxy.url,
+ error: httpProxy.error ?? httpsProxy.error,
+ };
+}
diff --git a/src/utils/proxy-env.ts b/src/utils/proxy-env.ts
new file mode 100644
index 00000000..e0eb6f99
--- /dev/null
+++ b/src/utils/proxy-env.ts
@@ -0,0 +1,153 @@
+type ProxyEnv = Record;
+type ProxyResolution = { url?: string; error?: string };
+type ProxyResolutionOptions = { allowedProtocols?: string[] };
+
+function getEnvValue(env: ProxyEnv, keys: string[]): string | undefined {
+ for (const key of keys) {
+ const value = env[key];
+ if (typeof value === 'string') {
+ const trimmed = value.trim();
+ if (trimmed.length > 0) {
+ return trimmed;
+ }
+ }
+ }
+
+ return undefined;
+}
+
+function normalizeHostname(hostname: string): string {
+ const trimmed = hostname.trim().toLowerCase().replace(/\.$/, '');
+ if (trimmed.startsWith('[') && trimmed.endsWith(']')) {
+ return trimmed.slice(1, -1);
+ }
+ return trimmed;
+}
+
+function isIpLikeHost(hostname: string): boolean {
+ return /^[\d.:]+$/.test(hostname);
+}
+
+function validateProxyUrl(proxyUrl: string, allowedProtocols?: string[]): string {
+ let parsedUrl: URL;
+ try {
+ parsedUrl = new URL(proxyUrl);
+ } catch {
+ throw new Error('Invalid URL');
+ }
+
+ if (allowedProtocols && !allowedProtocols.includes(parsedUrl.protocol)) {
+ throw new Error(`Unsupported proxy protocol: ${parsedUrl.protocol}`);
+ }
+
+ return proxyUrl;
+}
+
+function getProxyKeys(isHttps: boolean): string[] {
+ if (isHttps) {
+ return ['https_proxy', 'HTTPS_PROXY', 'http_proxy', 'HTTP_PROXY', 'all_proxy', 'ALL_PROXY'];
+ }
+
+ return ['http_proxy', 'HTTP_PROXY', 'all_proxy', 'ALL_PROXY'];
+}
+
+export function getProxyResolution(
+ isHttps: boolean,
+ env: ProxyEnv = process.env,
+ options: ProxyResolutionOptions = {}
+): ProxyResolution {
+ let firstError: string | undefined;
+
+ for (const key of getProxyKeys(isHttps)) {
+ const proxyUrl = getEnvValue(env, [key]);
+ if (!proxyUrl) {
+ continue;
+ }
+
+ try {
+ return { url: validateProxyUrl(proxyUrl, options.allowedProtocols) };
+ } catch (error) {
+ if (!firstError) {
+ firstError = error instanceof Error ? error.message : 'Unknown proxy configuration error';
+ }
+ }
+ }
+
+ return { error: firstError };
+}
+
+export function getProxyUrl(isHttps: boolean, env: ProxyEnv = process.env): string | undefined {
+ const { url } = getProxyResolution(isHttps, env);
+ return url;
+}
+
+export function isLoopbackHost(hostname: string): boolean {
+ const normalizedHost = normalizeHostname(hostname);
+ if (!normalizedHost) {
+ return false;
+ }
+
+ if (
+ normalizedHost === 'localhost' ||
+ normalizedHost.endsWith('.localhost') ||
+ normalizedHost === '0.0.0.0' ||
+ normalizedHost === '::1'
+ ) {
+ return true;
+ }
+
+ if (/^127(?:\.\d{1,3}){3}$/.test(normalizedHost)) {
+ return true;
+ }
+
+ return normalizedHost.startsWith('::ffff:127.') || normalizedHost.startsWith('::ffff:7f');
+}
+
+export function getNoProxyValue(env: ProxyEnv = process.env): string | undefined {
+ return getEnvValue(env, ['no_proxy', 'NO_PROXY']);
+}
+
+export function shouldBypassProxy(hostname: string, env: ProxyEnv = process.env): boolean {
+ const normalizedHost = normalizeHostname(hostname);
+ if (!normalizedHost) {
+ return false;
+ }
+
+ if (isLoopbackHost(normalizedHost)) {
+ return true;
+ }
+
+ const noProxy = getNoProxyValue(env);
+ if (!noProxy) {
+ return false;
+ }
+
+ const patterns = noProxy
+ .split(/[,\s]+/)
+ .map((pattern) => normalizeHostname(pattern))
+ .filter(Boolean);
+
+ for (const pattern of patterns) {
+ if (pattern === '*') {
+ return true;
+ }
+
+ const canonicalPattern = pattern.startsWith('.')
+ ? pattern.slice(1)
+ : pattern.replace(/^\*\.?/, '');
+
+ if (!canonicalPattern) {
+ continue;
+ }
+
+ if (normalizedHost === canonicalPattern) {
+ return true;
+ }
+
+ if (!isIpLikeHost(canonicalPattern) && normalizedHost.endsWith(`.${canonicalPattern}`)) {
+ return true;
+ }
+ }
+
+ return false;
+}
diff --git a/src/web-server/routes/claude-extension-routes.ts b/src/web-server/routes/claude-extension-routes.ts
new file mode 100644
index 00000000..76c66225
--- /dev/null
+++ b/src/web-server/routes/claude-extension-routes.ts
@@ -0,0 +1,193 @@
+import { Router, Request, Response } from 'express';
+import {
+ CLAUDE_EXTENSION_HOSTS,
+ type ClaudeExtensionHost,
+ getClaudeExtensionHostDefinition,
+} from '../../shared/claude-extension-hosts';
+import {
+ getClaudeSharedSettingsPath,
+ listClaudeExtensionProfiles,
+ renderClaudeExtensionSettingsJson,
+ renderSharedClaudeSettingsJson,
+ resolveClaudeExtensionSetup,
+} from '../../shared/claude-extension-setup';
+import {
+ createClaudeExtensionBinding,
+ deleteClaudeExtensionBinding,
+ getClaudeExtensionBinding,
+ listClaudeExtensionBindings,
+ updateClaudeExtensionBinding,
+} from '../services/claude-extension-binding-service';
+import {
+ applyClaudeExtensionBinding,
+ getDefaultClaudeExtensionIdeSettingsPath,
+ resetClaudeExtensionBinding,
+ resolveClaudeExtensionIdeSettingsPath,
+ type ClaudeExtensionActionTarget,
+ verifyClaudeExtensionBinding,
+} from '../services/claude-extension-settings-service';
+
+const router = Router();
+const VALID_HOSTS = new Set(CLAUDE_EXTENSION_HOSTS.map((host) => host.id));
+const VALID_TARGETS = new Set(['shared', 'ide', 'all']);
+
+function getHostFromRequest(req: Request): ClaudeExtensionHost {
+ const rawHost = String(req.query.host || 'vscode');
+ if (!VALID_HOSTS.has(rawHost as ClaudeExtensionHost)) {
+ throw new Error(
+ `Invalid host "${rawHost}". Use: ${CLAUDE_EXTENSION_HOSTS.map((host) => host.id).join(', ')}`
+ );
+ }
+ return rawHost as ClaudeExtensionHost;
+}
+
+function getActionTarget(req: Request): ClaudeExtensionActionTarget {
+ const rawTarget =
+ req.body && typeof req.body.target === 'string' ? req.body.target.trim().toLowerCase() : 'all';
+ if (!VALID_TARGETS.has(rawTarget as ClaudeExtensionActionTarget)) {
+ throw new Error('Invalid target. Use: shared, ide, or all');
+ }
+ return rawTarget as ClaudeExtensionActionTarget;
+}
+
+function serializeBinding(id: string) {
+ const binding = getClaudeExtensionBinding(id);
+ return {
+ ...binding,
+ effectiveIdeSettingsPath: resolveClaudeExtensionIdeSettingsPath(binding),
+ usesDefaultIdeSettingsPath: !binding.ideSettingsPath,
+ };
+}
+
+function handleRouteError(res: Response, error: unknown): void {
+ const message = (error as Error).message;
+ if (message.startsWith('Binding not found')) {
+ res.status(404).json({ error: message });
+ return;
+ }
+ res.status(400).json({ error: message });
+}
+
+router.get('/profiles', (_req: Request, res: Response): void => {
+ res.json({
+ profiles: listClaudeExtensionProfiles(),
+ hosts: CLAUDE_EXTENSION_HOSTS.map((host) => ({
+ ...host,
+ defaultSettingsPath: getDefaultClaudeExtensionIdeSettingsPath(host.id),
+ })),
+ });
+});
+
+router.get('/setup', async (req: Request, res: Response): Promise => {
+ const rawProfile = typeof req.query.profile === 'string' ? req.query.profile.trim() : '';
+ if (!rawProfile) {
+ res.status(400).json({ error: 'Missing required query parameter: profile' });
+ return;
+ }
+
+ try {
+ const host = getHostFromRequest(req);
+ const setup = await resolveClaudeExtensionSetup(rawProfile);
+ const hostDefinition = getClaudeExtensionHostDefinition(host);
+
+ res.json({
+ profile: {
+ requestedProfile: setup.requestedProfile,
+ resolvedProfileName: setup.resolvedProfileName,
+ profileType: setup.profileType,
+ label: setup.profileLabel,
+ description: setup.profileDescription,
+ },
+ host: hostDefinition,
+ env: Object.entries(setup.extensionEnv).map(([name, value]) => ({ name, value })),
+ warnings: setup.warnings,
+ notes: setup.notes,
+ removeEnvKeys: setup.removeEnvKeys,
+ sharedSettings: {
+ path: getClaudeSharedSettingsPath(),
+ command: `ccs persist ${rawProfile}`,
+ json: renderSharedClaudeSettingsJson(setup),
+ },
+ ideSettings: {
+ path: getDefaultClaudeExtensionIdeSettingsPath(host),
+ targetLabel: hostDefinition.settingsTargetLabel,
+ json: renderClaudeExtensionSettingsJson(setup, host),
+ },
+ });
+ } catch (error) {
+ handleRouteError(res, error);
+ }
+});
+
+router.get('/bindings', (_req: Request, res: Response): void => {
+ try {
+ res.json({
+ bindings: listClaudeExtensionBindings().map((binding) => ({
+ ...binding,
+ effectiveIdeSettingsPath: resolveClaudeExtensionIdeSettingsPath(binding),
+ usesDefaultIdeSettingsPath: !binding.ideSettingsPath,
+ })),
+ });
+ } catch (error) {
+ handleRouteError(res, error);
+ }
+});
+
+router.post('/bindings', (req: Request, res: Response): void => {
+ try {
+ const binding = createClaudeExtensionBinding(req.body);
+ res.status(201).json({ binding: serializeBinding(binding.id) });
+ } catch (error) {
+ handleRouteError(res, error);
+ }
+});
+
+router.put('/bindings/:id', (req: Request, res: Response): void => {
+ try {
+ const binding = updateClaudeExtensionBinding(req.params.id, req.body);
+ res.json({ binding: serializeBinding(binding.id) });
+ } catch (error) {
+ handleRouteError(res, error);
+ }
+});
+
+router.delete('/bindings/:id', (req: Request, res: Response): void => {
+ try {
+ deleteClaudeExtensionBinding(req.params.id);
+ res.status(204).end();
+ } catch (error) {
+ handleRouteError(res, error);
+ }
+});
+
+router.get('/bindings/:id/verify', async (req: Request, res: Response): Promise => {
+ try {
+ const binding = getClaudeExtensionBinding(req.params.id);
+ const status = await verifyClaudeExtensionBinding(binding);
+ res.json({ binding: serializeBinding(binding.id), ...status });
+ } catch (error) {
+ handleRouteError(res, error);
+ }
+});
+
+router.post('/bindings/:id/apply', async (req: Request, res: Response): Promise => {
+ try {
+ const binding = getClaudeExtensionBinding(req.params.id);
+ const status = await applyClaudeExtensionBinding(binding, getActionTarget(req));
+ res.json({ binding: serializeBinding(binding.id), ...status });
+ } catch (error) {
+ handleRouteError(res, error);
+ }
+});
+
+router.post('/bindings/:id/reset', async (req: Request, res: Response): Promise => {
+ try {
+ const binding = getClaudeExtensionBinding(req.params.id);
+ const status = await resetClaudeExtensionBinding(binding, getActionTarget(req));
+ res.json({ binding: serializeBinding(binding.id), ...status });
+ } catch (error) {
+ handleRouteError(res, error);
+ }
+});
+
+export default router;
diff --git a/src/web-server/routes/copilot-routes.ts b/src/web-server/routes/copilot-routes.ts
index 625c160c..4c85d284 100644
--- a/src/web-server/routes/copilot-routes.ts
+++ b/src/web-server/routes/copilot-routes.ts
@@ -18,8 +18,12 @@ import {
getCopilotApiInfo,
getInstalledVersion as getCopilotInstalledVersion,
} from '../../copilot';
-import { DEFAULT_COPILOT_CONFIG } from '../../config/unified-config-types';
-import { loadOrCreateUnifiedConfig, saveUnifiedConfig } from '../../config/unified-config-loader';
+import {
+ normalizeCopilotConfigWithWarnings,
+ type CopilotNormalizationWarning,
+} from '../../copilot/copilot-model-normalizer';
+import { DEFAULT_COPILOT_CONFIG, type CopilotConfig } from '../../config/unified-config-types';
+import { loadOrCreateUnifiedConfig, mutateUnifiedConfig } from '../../config/unified-config-loader';
import copilotSettingsRoutes from './copilot-settings-routes';
const router = Router();
@@ -39,13 +43,20 @@ function parseOptionalModel(value: unknown): string | undefined {
return trimmed.length > 0 ? trimmed : undefined;
}
+function loadEffectiveCopilotConfig(): {
+ config: CopilotConfig;
+ warnings: CopilotNormalizationWarning[];
+} {
+ const config = loadOrCreateUnifiedConfig();
+ return normalizeCopilotConfigWithWarnings(config.copilot ?? DEFAULT_COPILOT_CONFIG);
+}
+
/**
* GET /api/copilot/status - Get Copilot status (auth + daemon + install info)
*/
router.get('/status', async (_req: Request, res: Response): Promise => {
try {
- const config = loadOrCreateUnifiedConfig();
- const copilotConfig = config.copilot ?? DEFAULT_COPILOT_CONFIG;
+ const { config: copilotConfig, warnings } = loadEffectiveCopilotConfig();
const status = await getCopilotStatus(copilotConfig);
const installed = isCopilotApiInstalled();
const version = getCopilotInstalledVersion();
@@ -62,6 +73,7 @@ router.get('/status', async (_req: Request, res: Response): Promise => {
auto_start: copilotConfig.auto_start,
rate_limit: copilotConfig.rate_limit,
wait_on_limit: copilotConfig.wait_on_limit,
+ warnings,
});
} catch (error) {
res.status(500).json({ error: (error as Error).message });
@@ -73,9 +85,8 @@ router.get('/status', async (_req: Request, res: Response): Promise => {
*/
router.get('/config', (_req: Request, res: Response): void => {
try {
- const config = loadOrCreateUnifiedConfig();
- const copilotConfig = config.copilot ?? DEFAULT_COPILOT_CONFIG;
- res.json(copilotConfig);
+ const { config: copilotConfig, warnings } = loadEffectiveCopilotConfig();
+ res.json({ ...copilotConfig, warnings });
} catch (error) {
res.status(500).json({ error: (error as Error).message });
}
@@ -197,46 +208,51 @@ router.put('/config', (req: Request, res: Response): void => {
return;
}
- const config = loadOrCreateUnifiedConfig();
+ let nextCopilotConfig: CopilotConfig = { ...DEFAULT_COPILOT_CONFIG };
+ let warnings: CopilotNormalizationWarning[] = [];
- // Merge updates with existing config
- config.copilot = {
- enabled:
- (payload.enabled as boolean) ?? config.copilot?.enabled ?? DEFAULT_COPILOT_CONFIG.enabled,
- auto_start:
- (payload.auto_start as boolean) ??
- config.copilot?.auto_start ??
- DEFAULT_COPILOT_CONFIG.auto_start,
- port: (payload.port as number) ?? config.copilot?.port ?? DEFAULT_COPILOT_CONFIG.port,
- account_type:
- (payload.account_type as 'individual' | 'business' | 'enterprise') ??
- config.copilot?.account_type ??
- DEFAULT_COPILOT_CONFIG.account_type,
- rate_limit:
- payload.rate_limit !== undefined
- ? (payload.rate_limit as number | null)
- : (config.copilot?.rate_limit ?? DEFAULT_COPILOT_CONFIG.rate_limit),
- wait_on_limit:
- (payload.wait_on_limit as boolean) ??
- config.copilot?.wait_on_limit ??
- DEFAULT_COPILOT_CONFIG.wait_on_limit,
- model: normalizedModel ?? config.copilot?.model ?? DEFAULT_COPILOT_CONFIG.model,
- opus_model:
- 'opus_model' in payload
- ? parseOptionalModel(payload.opus_model)
- : config.copilot?.opus_model,
- sonnet_model:
- 'sonnet_model' in payload
- ? parseOptionalModel(payload.sonnet_model)
- : config.copilot?.sonnet_model,
- haiku_model:
- 'haiku_model' in payload
- ? parseOptionalModel(payload.haiku_model)
- : config.copilot?.haiku_model,
- };
+ mutateUnifiedConfig((config) => {
+ const currentConfig = config.copilot ?? DEFAULT_COPILOT_CONFIG;
+ const result = normalizeCopilotConfigWithWarnings({
+ enabled:
+ (payload.enabled as boolean) ?? currentConfig.enabled ?? DEFAULT_COPILOT_CONFIG.enabled,
+ auto_start:
+ (payload.auto_start as boolean) ??
+ currentConfig.auto_start ??
+ DEFAULT_COPILOT_CONFIG.auto_start,
+ port: (payload.port as number) ?? currentConfig.port ?? DEFAULT_COPILOT_CONFIG.port,
+ account_type:
+ (payload.account_type as 'individual' | 'business' | 'enterprise') ??
+ currentConfig.account_type ??
+ DEFAULT_COPILOT_CONFIG.account_type,
+ rate_limit:
+ payload.rate_limit !== undefined
+ ? (payload.rate_limit as number | null)
+ : (currentConfig.rate_limit ?? DEFAULT_COPILOT_CONFIG.rate_limit),
+ wait_on_limit:
+ (payload.wait_on_limit as boolean) ??
+ currentConfig.wait_on_limit ??
+ DEFAULT_COPILOT_CONFIG.wait_on_limit,
+ model: normalizedModel ?? currentConfig.model ?? DEFAULT_COPILOT_CONFIG.model,
+ opus_model:
+ 'opus_model' in payload
+ ? parseOptionalModel(payload.opus_model)
+ : currentConfig.opus_model,
+ sonnet_model:
+ 'sonnet_model' in payload
+ ? parseOptionalModel(payload.sonnet_model)
+ : currentConfig.sonnet_model,
+ haiku_model:
+ 'haiku_model' in payload
+ ? parseOptionalModel(payload.haiku_model)
+ : currentConfig.haiku_model,
+ });
+ config.copilot = result.config;
+ nextCopilotConfig = result.config;
+ warnings = result.warnings;
+ });
- saveUnifiedConfig(config);
- res.json({ success: true, copilot: config.copilot });
+ res.json({ success: true, copilot: nextCopilotConfig, warnings });
} catch (error) {
res.status(500).json({ error: (error as Error).message });
}
@@ -271,9 +287,9 @@ router.get('/auth/status', async (_req: Request, res: Response): Promise =
*/
router.get('/models', async (_req: Request, res: Response): Promise => {
try {
- const config = loadOrCreateUnifiedConfig();
- const port = config.copilot?.port ?? DEFAULT_COPILOT_CONFIG.port;
- const currentModel = config.copilot?.model ?? DEFAULT_COPILOT_CONFIG.model;
+ const { config: copilotConfig, warnings } = loadEffectiveCopilotConfig();
+ const port = copilotConfig.port;
+ const currentModel = copilotConfig.model;
const models = await getCopilotModels(port);
const modelsWithCurrent = models.map((m) => ({
@@ -281,7 +297,7 @@ router.get('/models', async (_req: Request, res: Response): Promise => {
isCurrent: m.id === currentModel,
}));
- res.json({ models: modelsWithCurrent, current: currentModel });
+ res.json({ models: modelsWithCurrent, current: currentModel, warnings });
} catch (error) {
res.status(500).json({ error: (error as Error).message });
}
@@ -292,8 +308,8 @@ router.get('/models', async (_req: Request, res: Response): Promise => {
*/
router.get('/usage', async (_req: Request, res: Response): Promise => {
try {
- const config = loadOrCreateUnifiedConfig();
- const port = config.copilot?.port ?? DEFAULT_COPILOT_CONFIG.port;
+ const { config: copilotConfig, warnings } = loadEffectiveCopilotConfig();
+ const port = copilotConfig.port;
const daemonRunning = await isDaemonRunning(port);
if (!daemonRunning) {
@@ -313,7 +329,7 @@ router.get('/usage', async (_req: Request, res: Response): Promise => {
return;
}
- res.json(usage);
+ res.json({ ...usage, warnings });
} catch (error) {
res.status(500).json({ error: (error as Error).message });
}
@@ -324,10 +340,9 @@ router.get('/usage', async (_req: Request, res: Response): Promise => {
*/
router.post('/daemon/start', async (_req: Request, res: Response): Promise => {
try {
- const config = loadOrCreateUnifiedConfig();
- const copilotConfig = config.copilot ?? DEFAULT_COPILOT_CONFIG;
+ const { config: copilotConfig, warnings } = loadEffectiveCopilotConfig();
const result = await startCopilotDaemon(copilotConfig);
- res.json(result);
+ res.json({ ...result, warnings });
} catch (error) {
res.status(500).json({ error: (error as Error).message });
}
diff --git a/src/web-server/routes/copilot-settings-routes.ts b/src/web-server/routes/copilot-settings-routes.ts
index 19165f2e..015da32b 100644
--- a/src/web-server/routes/copilot-settings-routes.ts
+++ b/src/web-server/routes/copilot-settings-routes.ts
@@ -5,12 +5,63 @@
import { Router, Request, Response } from 'express';
import * as fs from 'fs';
import * as path from 'path';
+import {
+ normalizeCopilotConfigWithWarnings,
+ normalizeCopilotSettingsWithWarnings,
+} from '../../copilot/copilot-model-normalizer';
+import { DEFAULT_COPILOT_CONFIG, type CopilotConfig } from '../../config/unified-config-types';
+import { loadOrCreateUnifiedConfig, mutateUnifiedConfig } from '../../config/unified-config-loader';
import { getCcsDir } from '../../utils/config-manager';
-import { DEFAULT_COPILOT_CONFIG } from '../../config/unified-config-types';
-import { loadOrCreateUnifiedConfig, saveUnifiedConfig } from '../../config/unified-config-loader';
const router = Router();
+function serializeSettings(settings: Record): string {
+ return JSON.stringify(settings, null, 2) + '\n';
+}
+
+function writeSettingsFile(
+ settingsPath: string,
+ settings: Record,
+ previousContent?: string
+): void {
+ const nextContent = serializeSettings(settings);
+ if (previousContent === nextContent) return;
+ const tempPath = `${settingsPath}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}.tmp`;
+ fs.writeFileSync(tempPath, nextContent);
+ fs.renameSync(tempPath, settingsPath);
+}
+
+function restoreSettingsFile(
+ settingsPath: string,
+ previousContent: string | undefined,
+ existedBefore: boolean
+): void {
+ if (!existedBefore) {
+ if (fs.existsSync(settingsPath)) {
+ fs.unlinkSync(settingsPath);
+ }
+ return;
+ }
+
+ const tempPath = `${settingsPath}.${process.pid}.${Date.now()}.${Math.random().toString(36).slice(2)}.restore.tmp`;
+ fs.writeFileSync(tempPath, previousContent ?? '');
+ fs.renameSync(tempPath, settingsPath);
+}
+
+function buildDefaultSettings(copilotConfig: CopilotConfig) {
+ return {
+ env: {
+ ANTHROPIC_BASE_URL: `http://127.0.0.1:${copilotConfig.port}`,
+ ANTHROPIC_AUTH_TOKEN: 'copilot-managed',
+ ANTHROPIC_MODEL: copilotConfig.model,
+ ANTHROPIC_DEFAULT_OPUS_MODEL: copilotConfig.opus_model || copilotConfig.model,
+ ANTHROPIC_DEFAULT_SONNET_MODEL: copilotConfig.sonnet_model || copilotConfig.model,
+ ANTHROPIC_DEFAULT_HAIKU_MODEL: copilotConfig.haiku_model || copilotConfig.model,
+ ANTHROPIC_SMALL_FAST_MODEL: copilotConfig.haiku_model || copilotConfig.model,
+ },
+ };
+}
+
/**
* GET /api/copilot/settings/raw - Get raw copilot.settings.json
* Returns the raw JSON content for editing in the code editor
@@ -19,44 +70,39 @@ router.get('/raw', (_req: Request, res: Response): void => {
try {
const settingsPath = path.join(getCcsDir(), 'copilot.settings.json');
const config = loadOrCreateUnifiedConfig();
- const copilotConfig = config.copilot ?? DEFAULT_COPILOT_CONFIG;
+ const configResult = normalizeCopilotConfigWithWarnings(
+ config.copilot ?? DEFAULT_COPILOT_CONFIG
+ );
- // Default model for all tiers
- const defaultModel = copilotConfig.model;
-
- // If file doesn't exist, return default structure with all model mappings
if (!fs.existsSync(settingsPath)) {
- // Create settings structure matching CLIProxy pattern
- // Use 127.0.0.1 instead of localhost for more reliable local connections
- const defaultSettings = {
- env: {
- ANTHROPIC_BASE_URL: `http://127.0.0.1:${copilotConfig.port}`,
- ANTHROPIC_AUTH_TOKEN: 'copilot-managed',
- ANTHROPIC_MODEL: defaultModel,
- ANTHROPIC_DEFAULT_OPUS_MODEL: copilotConfig.opus_model || defaultModel,
- ANTHROPIC_DEFAULT_SONNET_MODEL: copilotConfig.sonnet_model || defaultModel,
- ANTHROPIC_DEFAULT_HAIKU_MODEL: copilotConfig.haiku_model || defaultModel,
- },
- };
+ const defaultSettings = normalizeCopilotSettingsWithWarnings(
+ buildDefaultSettings(configResult.config),
+ configResult.config
+ );
res.json({
- settings: defaultSettings,
+ settings: defaultSettings.settings,
+ effectiveSettings: defaultSettings.settings,
mtime: Date.now(),
path: `~/.ccs/copilot.settings.json`,
exists: false,
+ warnings: defaultSettings.warnings,
});
return;
}
const content = fs.readFileSync(settingsPath, 'utf-8');
- const settings = JSON.parse(content);
+ const rawSettings = JSON.parse(content) as Record;
+ const settingsResult = normalizeCopilotSettingsWithWarnings(rawSettings, configResult.config);
const stat = fs.statSync(settingsPath);
res.json({
- settings,
+ settings: rawSettings,
+ effectiveSettings: settingsResult.settings,
mtime: stat.mtimeMs,
path: `~/.ccs/copilot.settings.json`,
exists: true,
+ warnings: settingsResult.warnings,
});
} catch (error) {
res.status(500).json({ error: (error as Error).message });
@@ -72,6 +118,16 @@ router.put('/raw', (req: Request, res: Response): void => {
const { settings, expectedMtime } = req.body;
const settingsPath = path.join(getCcsDir(), 'copilot.settings.json');
+ if (!settings || typeof settings !== 'object' || Array.isArray(settings)) {
+ res.status(400).json({ error: 'settings must be a JSON object' });
+ return;
+ }
+
+ const currentConfig = loadOrCreateUnifiedConfig();
+ const configResult = normalizeCopilotConfigWithWarnings(
+ currentConfig.copilot ?? DEFAULT_COPILOT_CONFIG
+ );
+
// Check for conflict if file exists and expectedMtime provided
if (fs.existsSync(settingsPath) && expectedMtime) {
const stat = fs.statSync(settingsPath);
@@ -81,26 +137,40 @@ router.put('/raw', (req: Request, res: Response): void => {
}
}
- // Write settings file atomically
- const tempPath = settingsPath + '.tmp';
- fs.writeFileSync(tempPath, JSON.stringify(settings, null, 2) + '\n');
- fs.renameSync(tempPath, settingsPath);
+ const settingsResult = normalizeCopilotSettingsWithWarnings(
+ settings as Record,
+ configResult.config
+ );
+ const existedBefore = fs.existsSync(settingsPath);
+ const previousContent = existedBefore ? fs.readFileSync(settingsPath, 'utf-8') : undefined;
+ writeSettingsFile(
+ settingsPath,
+ settingsResult.settings as Record,
+ previousContent
+ );
- // Also sync model mappings back to unified config
- const config = loadOrCreateUnifiedConfig();
- const env = settings.env || {};
-
- config.copilot = {
- ...(config.copilot ?? DEFAULT_COPILOT_CONFIG),
- model: env.ANTHROPIC_MODEL || config.copilot?.model || DEFAULT_COPILOT_CONFIG.model,
- opus_model: env.ANTHROPIC_DEFAULT_OPUS_MODEL || undefined,
- sonnet_model: env.ANTHROPIC_DEFAULT_SONNET_MODEL || undefined,
- haiku_model: env.ANTHROPIC_DEFAULT_HAIKU_MODEL || undefined,
- };
- saveUnifiedConfig(config);
+ try {
+ mutateUnifiedConfig((config) => {
+ config.copilot = settingsResult.effectiveConfig;
+ });
+ } catch (error) {
+ try {
+ restoreSettingsFile(settingsPath, previousContent, existedBefore);
+ } catch (rollbackError) {
+ throw new Error(
+ `Failed to sync unified config after writing Copilot settings: ${(error as Error).message}. Rollback also failed: ${(rollbackError as Error).message}`
+ );
+ }
+ throw error;
+ }
const stat = fs.statSync(settingsPath);
- res.json({ success: true, mtime: stat.mtimeMs });
+ res.json({
+ success: true,
+ mtime: stat.mtimeMs,
+ settings: settingsResult.settings,
+ warnings: settingsResult.warnings,
+ });
} catch (error) {
res.status(500).json({ error: (error as Error).message });
}
diff --git a/src/web-server/routes/index.ts b/src/web-server/routes/index.ts
index 09097156..9fafe3f7 100644
--- a/src/web-server/routes/index.ts
+++ b/src/web-server/routes/index.ts
@@ -27,6 +27,7 @@ import cliproxyServerRoutes from './proxy-routes';
import authRoutes from './auth-routes';
import persistRoutes from './persist-routes';
import catalogRoutes from './catalog-routes';
+import claudeExtensionRoutes from './claude-extension-routes';
// Create the main API router
export const apiRoutes = Router();
@@ -49,6 +50,7 @@ apiRoutes.use('/auth', authRoutes);
// ==================== Persist (Backup Management) ====================
apiRoutes.use('/persist', persistRoutes);
+apiRoutes.use('/claude-extension', claudeExtensionRoutes);
// ==================== CLIProxy ====================
// Variants, auth, accounts, stats, status, models, error logs
diff --git a/src/web-server/services/claude-extension-binding-service.ts b/src/web-server/services/claude-extension-binding-service.ts
new file mode 100644
index 00000000..ded0d77d
--- /dev/null
+++ b/src/web-server/services/claude-extension-binding-service.ts
@@ -0,0 +1,277 @@
+import { randomUUID } from 'crypto';
+import * as fs from 'fs';
+import * as path from 'path';
+import ProfileDetector from '../../auth/profile-detector';
+import type { ClaudeExtensionHost } from '../../shared/claude-extension-hosts';
+import { expandPath } from '../../utils/helpers';
+import { getCcsDir } from '../../utils/config-manager';
+
+export interface ClaudeExtensionBinding {
+ id: string;
+ name: string;
+ profile: string;
+ host: ClaudeExtensionHost;
+ ideSettingsPath?: string;
+ notes?: string;
+ createdAt: string;
+ updatedAt: string;
+}
+
+export interface ClaudeExtensionBindingInput {
+ name: string;
+ profile: string;
+ host: ClaudeExtensionHost;
+ ideSettingsPath?: string;
+ notes?: string;
+}
+
+export interface ClaudeExtensionManagedEnvManifest {
+ shared: string[];
+ ide: string[];
+}
+
+interface ClaudeExtensionStoredBinding extends ClaudeExtensionBinding {
+ managedEnvManifest: ClaudeExtensionManagedEnvManifest;
+}
+
+interface ClaudeExtensionBindingStore {
+ bindings: ClaudeExtensionStoredBinding[];
+}
+
+const VALID_HOSTS = new Set(['vscode', 'cursor', 'windsurf']);
+
+function getBindingsFilePath(): string {
+ return path.join(getCcsDir(), 'claude-extension-bindings.json');
+}
+
+function isRecord(value: unknown): value is Record {
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+function normalizeEnvKeyList(value: unknown): string[] {
+ if (!Array.isArray(value)) return [];
+
+ return [...new Set(value.filter((entry): entry is string => typeof entry === 'string'))]
+ .map((entry) => entry.trim())
+ .filter(Boolean)
+ .sort((left, right) => left.localeCompare(right));
+}
+
+function normalizeManagedEnvManifest(value: unknown): ClaudeExtensionManagedEnvManifest {
+ if (!isRecord(value)) {
+ return { shared: [], ide: [] };
+ }
+
+ return {
+ shared: normalizeEnvKeyList(value.shared),
+ ide: normalizeEnvKeyList(value.ide),
+ };
+}
+
+function toPublicBinding(binding: ClaudeExtensionStoredBinding): ClaudeExtensionBinding {
+ const { managedEnvManifest: _managedEnvManifest, ...publicBinding } = binding;
+ return publicBinding;
+}
+
+function normalizeBindingInput(input: ClaudeExtensionBindingInput): ClaudeExtensionBindingInput {
+ const name = input.name?.trim();
+ const profile = input.profile?.trim();
+ const ideSettingsPath = input.ideSettingsPath?.trim();
+ const notes = input.notes?.trim();
+
+ if (!name) throw new Error('Binding name is required');
+ if (!profile) throw new Error('Profile is required');
+ if (!VALID_HOSTS.has(input.host)) throw new Error(`Unsupported IDE host "${input.host}"`);
+
+ try {
+ new ProfileDetector().detectProfileType(profile);
+ } catch {
+ throw new Error(`Unknown profile "${profile}"`);
+ }
+
+ return {
+ name,
+ profile,
+ host: input.host,
+ ideSettingsPath: ideSettingsPath ? expandPath(ideSettingsPath) : undefined,
+ notes: notes || undefined,
+ };
+}
+
+function normalizeStoredBinding(value: unknown): ClaudeExtensionStoredBinding | null {
+ if (!isRecord(value)) return null;
+ const id = typeof value.id === 'string' ? value.id.trim() : '';
+ const name = typeof value.name === 'string' ? value.name.trim() : '';
+ const profile = typeof value.profile === 'string' ? value.profile.trim() : '';
+ const host = typeof value.host === 'string' ? value.host.trim() : '';
+ const createdAt = typeof value.createdAt === 'string' ? value.createdAt : '';
+ const updatedAt = typeof value.updatedAt === 'string' ? value.updatedAt : '';
+
+ if (!id || !name || !profile || !VALID_HOSTS.has(host as ClaudeExtensionHost)) {
+ return null;
+ }
+
+ return {
+ id,
+ name,
+ profile,
+ host: host as ClaudeExtensionHost,
+ ideSettingsPath:
+ typeof value.ideSettingsPath === 'string' && value.ideSettingsPath.trim().length > 0
+ ? value.ideSettingsPath.trim()
+ : undefined,
+ notes:
+ typeof value.notes === 'string' && value.notes.trim().length > 0
+ ? value.notes.trim()
+ : undefined,
+ createdAt: createdAt || new Date().toISOString(),
+ updatedAt: updatedAt || new Date().toISOString(),
+ managedEnvManifest: normalizeManagedEnvManifest(value.managedEnvManifest),
+ };
+}
+
+function readBindingsStore(): ClaudeExtensionBindingStore {
+ const filePath = getBindingsFilePath();
+ if (!fs.existsSync(filePath)) {
+ return { bindings: [] };
+ }
+
+ const raw = fs.readFileSync(filePath, 'utf8');
+ let parsed: unknown;
+ try {
+ parsed = JSON.parse(raw) as unknown;
+ } catch (error) {
+ throw new Error(
+ `Failed to parse Claude extension bindings store at ${filePath}: ${(error as Error).message}`
+ );
+ }
+ const bindings = Array.isArray(parsed)
+ ? parsed
+ : isRecord(parsed) && Array.isArray(parsed.bindings)
+ ? parsed.bindings
+ : [];
+
+ return {
+ bindings: bindings
+ .map((entry) => normalizeStoredBinding(entry))
+ .filter((entry): entry is ClaudeExtensionStoredBinding => entry !== null)
+ .sort((left, right) => right.updatedAt.localeCompare(left.updatedAt)),
+ };
+}
+
+function writeBindingsStore(store: ClaudeExtensionBindingStore): void {
+ const filePath = getBindingsFilePath();
+ fs.mkdirSync(path.dirname(filePath), { recursive: true });
+ const tempPath = `${filePath}.tmp.${process.pid}-${Date.now()}-${randomUUID()}`;
+
+ try {
+ fs.writeFileSync(tempPath, JSON.stringify(store, null, 2) + '\n', 'utf8');
+ fs.renameSync(tempPath, filePath);
+ } catch (error) {
+ if (fs.existsSync(tempPath)) {
+ fs.rmSync(tempPath, { force: true });
+ }
+ throw error;
+ }
+}
+
+export function listClaudeExtensionBindings(): ClaudeExtensionBinding[] {
+ return readBindingsStore().bindings.map((binding) => toPublicBinding(binding));
+}
+
+export function getClaudeExtensionBinding(id: string): ClaudeExtensionBinding {
+ const binding = readBindingsStore().bindings.find((entry) => entry.id === id);
+ if (!binding) {
+ throw new Error(`Binding not found: ${id}`);
+ }
+ return toPublicBinding(binding);
+}
+
+export function getClaudeExtensionManagedEnvManifest(
+ id: string
+): ClaudeExtensionManagedEnvManifest {
+ const binding = readBindingsStore().bindings.find((entry) => entry.id === id);
+ if (!binding) {
+ throw new Error(`Binding not found: ${id}`);
+ }
+ return binding.managedEnvManifest;
+}
+
+export function updateClaudeExtensionManagedEnvManifest(
+ id: string,
+ updates: Partial
+): void {
+ const store = readBindingsStore();
+ const index = store.bindings.findIndex((entry) => entry.id === id);
+ if (index === -1) {
+ throw new Error(`Binding not found: ${id}`);
+ }
+
+ const current = store.bindings[index];
+ store.bindings[index] = {
+ ...current,
+ managedEnvManifest: {
+ shared:
+ updates.shared !== undefined
+ ? normalizeEnvKeyList(updates.shared)
+ : current.managedEnvManifest.shared,
+ ide:
+ updates.ide !== undefined
+ ? normalizeEnvKeyList(updates.ide)
+ : current.managedEnvManifest.ide,
+ },
+ };
+
+ writeBindingsStore(store);
+}
+
+export function createClaudeExtensionBinding(
+ input: ClaudeExtensionBindingInput
+): ClaudeExtensionBinding {
+ const normalized = normalizeBindingInput(input);
+ const store = readBindingsStore();
+ const timestamp = new Date().toISOString();
+ const binding: ClaudeExtensionStoredBinding = {
+ managedEnvManifest: { shared: [], ide: [] },
+ id: randomUUID(),
+ createdAt: timestamp,
+ updatedAt: timestamp,
+ ...normalized,
+ };
+
+ store.bindings.unshift(binding);
+ writeBindingsStore(store);
+ return toPublicBinding(binding);
+}
+
+export function updateClaudeExtensionBinding(
+ id: string,
+ input: ClaudeExtensionBindingInput
+): ClaudeExtensionBinding {
+ const normalized = normalizeBindingInput(input);
+ const store = readBindingsStore();
+ const index = store.bindings.findIndex((entry) => entry.id === id);
+ if (index === -1) {
+ throw new Error(`Binding not found: ${id}`);
+ }
+
+ const updated: ClaudeExtensionStoredBinding = {
+ ...store.bindings[index],
+ ...normalized,
+ updatedAt: new Date().toISOString(),
+ };
+
+ store.bindings[index] = updated;
+ writeBindingsStore(store);
+ return toPublicBinding(updated);
+}
+
+export function deleteClaudeExtensionBinding(id: string): void {
+ const store = readBindingsStore();
+ const nextBindings = store.bindings.filter((entry) => entry.id !== id);
+ if (nextBindings.length === store.bindings.length) {
+ throw new Error(`Binding not found: ${id}`);
+ }
+
+ writeBindingsStore({ bindings: nextBindings });
+}
diff --git a/src/web-server/services/claude-extension-settings-service.ts b/src/web-server/services/claude-extension-settings-service.ts
new file mode 100644
index 00000000..aad9fe24
--- /dev/null
+++ b/src/web-server/services/claude-extension-settings-service.ts
@@ -0,0 +1,610 @@
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import { randomUUID } from 'crypto';
+import {
+ buildClaudeExtensionSettingsObject,
+ resolveClaudeExtensionSetup,
+} from '../../shared/claude-extension-setup';
+import {
+ type ClaudeExtensionHost,
+ getClaudeExtensionHostDefinition,
+} from '../../shared/claude-extension-hosts';
+import { getClaudeSettingsPath } from '../../utils/claude-config-path';
+import { expandPath } from '../../utils/helpers';
+import {
+ getClaudeExtensionManagedEnvManifest,
+ updateClaudeExtensionManagedEnvManifest,
+ type ClaudeExtensionBinding,
+} from './claude-extension-binding-service';
+
+export type ClaudeExtensionActionTarget = 'shared' | 'ide' | 'all';
+export type ClaudeExtensionFileState = 'applied' | 'drifted' | 'missing' | 'unconfigured';
+
+export interface ClaudeExtensionTargetStatus {
+ target: 'shared' | 'ide';
+ path: string;
+ exists: boolean;
+ mtime: number | null;
+ state: ClaudeExtensionFileState;
+ message: string;
+}
+
+export interface ClaudeExtensionBindingStatus {
+ bindingId: string;
+ sharedSettings: ClaudeExtensionTargetStatus;
+ ideSettings: ClaudeExtensionTargetStatus;
+}
+
+interface JsonDocument {
+ exists: boolean;
+ data: Record;
+ mtime: number | null;
+}
+
+function isRecord(value: unknown): value is Record {
+ return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+
+function sortStringRecord(record: Record): Record {
+ return Object.fromEntries(
+ Object.entries(record).sort(([left], [right]) => left.localeCompare(right))
+ );
+}
+
+function toStringRecord(record: Record): Record {
+ const normalized: Record = {};
+ for (const [key, value] of Object.entries(record)) {
+ if (typeof value === 'string') {
+ normalized[key] = value;
+ }
+ }
+ return normalized;
+}
+
+function uniqueFileNonce(): string {
+ return `${process.pid}-${Date.now()}-${randomUUID()}`;
+}
+
+function stripJsonComments(input: string): string {
+ let output = '';
+ let inString = false;
+ let escaping = false;
+ let inLineComment = false;
+ let inBlockComment = false;
+
+ for (let index = 0; index < input.length; index += 1) {
+ const char = input[index];
+ const nextChar = input[index + 1];
+
+ if (inLineComment) {
+ if (char === '\n') {
+ inLineComment = false;
+ output += char;
+ }
+ continue;
+ }
+
+ if (inBlockComment) {
+ if (char === '*' && nextChar === '/') {
+ inBlockComment = false;
+ index += 1;
+ continue;
+ }
+ if (char === '\n') {
+ output += char;
+ }
+ continue;
+ }
+
+ if (inString) {
+ output += char;
+ if (escaping) {
+ escaping = false;
+ } else if (char === '\\') {
+ escaping = true;
+ } else if (char === '"') {
+ inString = false;
+ }
+ continue;
+ }
+
+ if (char === '"') {
+ inString = true;
+ output += char;
+ continue;
+ }
+
+ if (char === '/' && nextChar === '/') {
+ inLineComment = true;
+ index += 1;
+ continue;
+ }
+
+ if (char === '/' && nextChar === '*') {
+ inBlockComment = true;
+ index += 1;
+ continue;
+ }
+
+ output += char;
+ }
+
+ return output;
+}
+
+function stripTrailingCommas(input: string): string {
+ let output = '';
+ let inString = false;
+ let escaping = false;
+
+ for (let index = 0; index < input.length; index += 1) {
+ const char = input[index];
+
+ if (inString) {
+ output += char;
+ if (escaping) {
+ escaping = false;
+ } else if (char === '\\') {
+ escaping = true;
+ } else if (char === '"') {
+ inString = false;
+ }
+ continue;
+ }
+
+ if (char === '"') {
+ inString = true;
+ output += char;
+ continue;
+ }
+
+ if (char === ',') {
+ let lookahead = index + 1;
+ while (lookahead < input.length && /\s/.test(input[lookahead])) {
+ lookahead += 1;
+ }
+
+ if (input[lookahead] === '}' || input[lookahead] === ']') {
+ continue;
+ }
+ }
+
+ output += char;
+ }
+
+ return output;
+}
+
+function parseJsonDocumentObject(raw: string, filePath: string): Record {
+ const normalized = stripTrailingCommas(stripJsonComments(raw));
+
+ let parsed: unknown;
+ try {
+ parsed = JSON.parse(normalized) as unknown;
+ } catch (error) {
+ throw new Error(`Failed to parse ${filePath}: ${(error as Error).message}`);
+ }
+
+ if (!isRecord(parsed)) {
+ throw new Error(`Expected a JSON object in ${filePath}`);
+ }
+
+ return parsed;
+}
+
+function readJsonDocument(filePath: string): JsonDocument {
+ if (!fs.existsSync(filePath)) {
+ return { exists: false, data: {}, mtime: null };
+ }
+
+ if (fs.lstatSync(filePath).isSymbolicLink()) {
+ throw new Error(`Refusing to manage symlinked file: ${filePath}`);
+ }
+
+ const raw = fs.readFileSync(filePath, 'utf8');
+
+ return {
+ exists: true,
+ data: parseJsonDocumentObject(raw, filePath),
+ mtime: fs.statSync(filePath).mtimeMs,
+ };
+}
+
+function backupIfPresent(filePath: string, suffix: string): void {
+ if (!fs.existsSync(filePath)) return;
+ const backupPath = `${filePath}.${suffix}.${uniqueFileNonce()}`;
+ fs.copyFileSync(filePath, backupPath, fs.constants.COPYFILE_EXCL);
+}
+
+function writeJsonDocument(
+ filePath: string,
+ data: Record,
+ backupSuffix: string
+): void {
+ if (fs.existsSync(filePath) && fs.lstatSync(filePath).isSymbolicLink()) {
+ throw new Error(`Refusing to manage symlinked file: ${filePath}`);
+ }
+
+ fs.mkdirSync(path.dirname(filePath), { recursive: true });
+ backupIfPresent(filePath, backupSuffix);
+ const tempPath = `${filePath}.tmp.${uniqueFileNonce()}`;
+
+ try {
+ fs.writeFileSync(tempPath, JSON.stringify(data, null, 2) + '\n', 'utf8');
+ fs.renameSync(tempPath, filePath);
+ } catch (error) {
+ if (fs.existsSync(tempPath)) {
+ fs.rmSync(tempPath, { force: true });
+ }
+ throw error;
+ }
+}
+
+function getManagedSharedEnv(
+ data: Record,
+ managedKeys: ReadonlySet
+): Record {
+ const rawEnv = isRecord(data.env) ? toStringRecord(data.env) : {};
+ const managed: Record = {};
+ for (const key of managedKeys) {
+ if (typeof rawEnv[key] === 'string') {
+ managed[key] = rawEnv[key];
+ }
+ }
+ return sortStringRecord(managed);
+}
+
+interface ExtensionEnvEntry {
+ name: string;
+ value: string;
+}
+
+function getExtensionEnvEntries(value: unknown): ExtensionEnvEntry[] {
+ if (!Array.isArray(value)) return [];
+ return value
+ .map((entry) => {
+ if (!isRecord(entry) || typeof entry.name !== 'string' || typeof entry.value !== 'string') {
+ return null;
+ }
+ return { name: entry.name, value: entry.value };
+ })
+ .filter((entry): entry is ExtensionEnvEntry => entry !== null);
+}
+
+function getExtensionEnvMap(
+ value: unknown,
+ managedKeys?: ReadonlySet
+): Record {
+ const entries = getExtensionEnvEntries(value)
+ .filter((entry) => !managedKeys || managedKeys.has(entry.name))
+ .map((entry) => [entry.name, entry.value] as const);
+ return sortStringRecord(Object.fromEntries(entries));
+}
+
+function mergeManagedExtensionEnvEntries(
+ value: unknown,
+ managedKeys: ReadonlySet,
+ nextManagedEnv: Record
+): ExtensionEnvEntry[] {
+ const preservedEntries = getExtensionEnvEntries(value).filter(
+ (entry) => !managedKeys.has(entry.name)
+ );
+ const managedEntries = Object.entries(sortStringRecord(nextManagedEnv)).map(
+ ([name, entryValue]) => ({
+ name,
+ value: entryValue,
+ })
+ );
+
+ return [...preservedEntries, ...managedEntries];
+}
+
+function recordsMatch(left: Record, right: Record): boolean {
+ return JSON.stringify(sortStringRecord(left)) === JSON.stringify(sortStringRecord(right));
+}
+
+function booleansMatch(left: boolean | undefined, right: boolean | undefined): boolean {
+ return left === right;
+}
+
+function targetEnabled(target: ClaudeExtensionActionTarget, candidate: 'shared' | 'ide'): boolean {
+ return target === 'all' || target === candidate;
+}
+
+function getManagedKeysForTarget(
+ binding: ClaudeExtensionBinding,
+ target: 'shared' | 'ide',
+ currentResolvedKeys: string[]
+): Set {
+ const manifest = getClaudeExtensionManagedEnvManifest(binding.id);
+ const manifestKeys = target === 'shared' ? manifest.shared : manifest.ide;
+ return new Set([...currentResolvedKeys, ...manifestKeys]);
+}
+
+function getCurrentResolvedManagedKeys(
+ setup: Awaited>
+): string[] {
+ return [...new Set([...setup.removeEnvKeys, ...Object.keys(setup.extensionEnv)])].sort(
+ (left, right) => left.localeCompare(right)
+ );
+}
+
+export function getDefaultClaudeExtensionIdeSettingsPath(host: ClaudeExtensionHost): string {
+ if (process.platform === 'darwin') {
+ if (host === 'vscode') {
+ return path.join(
+ os.homedir(),
+ 'Library',
+ 'Application Support',
+ 'Code',
+ 'User',
+ 'settings.json'
+ );
+ }
+ if (host === 'cursor') {
+ return path.join(
+ os.homedir(),
+ 'Library',
+ 'Application Support',
+ 'Cursor',
+ 'User',
+ 'settings.json'
+ );
+ }
+ return path.join(
+ os.homedir(),
+ 'Library',
+ 'Application Support',
+ 'Windsurf',
+ 'User',
+ 'settings.json'
+ );
+ }
+
+ if (process.platform === 'win32') {
+ const appData = process.env.APPDATA || path.join(os.homedir(), 'AppData', 'Roaming');
+ if (host === 'vscode') return path.join(appData, 'Code', 'User', 'settings.json');
+ if (host === 'cursor') return path.join(appData, 'Cursor', 'User', 'settings.json');
+ return path.join(appData, 'Windsurf', 'User', 'settings.json');
+ }
+
+ if (host === 'vscode') return path.join(os.homedir(), '.config', 'Code', 'User', 'settings.json');
+ if (host === 'cursor')
+ return path.join(os.homedir(), '.config', 'Cursor', 'User', 'settings.json');
+ return path.join(os.homedir(), '.config', 'Windsurf', 'User', 'settings.json');
+}
+
+export function resolveClaudeExtensionIdeSettingsPath(binding: ClaudeExtensionBinding): string {
+ return binding.ideSettingsPath
+ ? expandPath(binding.ideSettingsPath)
+ : getDefaultClaudeExtensionIdeSettingsPath(binding.host);
+}
+
+export async function verifyClaudeExtensionBinding(
+ binding: ClaudeExtensionBinding
+): Promise {
+ const setup = await resolveClaudeExtensionSetup(binding.profile);
+ const currentResolvedKeys = getCurrentResolvedManagedKeys(setup);
+ const sharedManagedKeys = getManagedKeysForTarget(binding, 'shared', currentResolvedKeys);
+ const ideManagedKeys = getManagedKeysForTarget(binding, 'ide', currentResolvedKeys);
+ const sharedPath = getClaudeSettingsPath();
+ const idePath = resolveClaudeExtensionIdeSettingsPath(binding);
+ const sharedDoc = readJsonDocument(sharedPath);
+ const ideDoc = readJsonDocument(idePath);
+ const hostDefinition = getClaudeExtensionHostDefinition(binding.host);
+ const expectedIde = buildClaudeExtensionSettingsObject(setup, binding.host);
+ const expectedIdeEnv = getExtensionEnvMap(
+ expectedIde[hostDefinition.settingsKey],
+ ideManagedKeys
+ );
+ const expectedDisablePrompt = hostDefinition.disableLoginPromptKey
+ ? (expectedIde[hostDefinition.disableLoginPromptKey] as boolean | undefined)
+ : undefined;
+ const actualIdeEnv = getExtensionEnvMap(ideDoc.data[hostDefinition.settingsKey], ideManagedKeys);
+ const actualDisablePrompt = hostDefinition.disableLoginPromptKey
+ ? (ideDoc.data[hostDefinition.disableLoginPromptKey] as boolean | undefined)
+ : undefined;
+ const expectedShared = sortStringRecord(setup.extensionEnv);
+ const actualShared = getManagedSharedEnv(sharedDoc.data, sharedManagedKeys);
+ const missingSharedState: ClaudeExtensionFileState =
+ Object.keys(expectedShared).length > 0 ? 'missing' : 'applied';
+ const missingIdeState: ClaudeExtensionFileState =
+ Object.keys(expectedIdeEnv).length > 0 || expectedDisablePrompt === true
+ ? 'missing'
+ : 'applied';
+
+ const sharedSettings = !sharedDoc.exists
+ ? {
+ target: 'shared' as const,
+ path: sharedPath,
+ exists: false,
+ mtime: null,
+ state: missingSharedState,
+ message:
+ Object.keys(expectedShared).length > 0
+ ? 'Shared Claude settings file does not exist yet.'
+ : 'No shared CCS-managed values are required.',
+ }
+ : recordsMatch(actualShared, expectedShared)
+ ? {
+ target: 'shared' as const,
+ path: sharedPath,
+ exists: true,
+ mtime: sharedDoc.mtime,
+ state: 'applied' as const,
+ message: 'Shared Claude settings match this binding.',
+ }
+ : Object.keys(actualShared).length === 0
+ ? {
+ target: 'shared' as const,
+ path: sharedPath,
+ exists: true,
+ mtime: sharedDoc.mtime,
+ state: 'unconfigured' as const,
+ message: 'Shared Claude settings are not configured for this binding.',
+ }
+ : {
+ target: 'shared' as const,
+ path: sharedPath,
+ exists: true,
+ mtime: sharedDoc.mtime,
+ state: 'drifted' as const,
+ message: 'Shared Claude settings differ from the expected managed values.',
+ };
+
+ const ideSettings = !ideDoc.exists
+ ? {
+ target: 'ide' as const,
+ path: idePath,
+ exists: false,
+ mtime: null,
+ state: missingIdeState,
+ message:
+ Object.keys(expectedIdeEnv).length > 0 || expectedDisablePrompt === true
+ ? `${hostDefinition.label} settings file does not exist yet.`
+ : 'No IDE-local CCS-managed values are required.',
+ }
+ : recordsMatch(actualIdeEnv, expectedIdeEnv) &&
+ booleansMatch(actualDisablePrompt, expectedDisablePrompt)
+ ? {
+ target: 'ide' as const,
+ path: idePath,
+ exists: true,
+ mtime: ideDoc.mtime,
+ state: 'applied' as const,
+ message: `${hostDefinition.label} settings match this binding.`,
+ }
+ : Object.keys(actualIdeEnv).length === 0 && actualDisablePrompt === undefined
+ ? {
+ target: 'ide' as const,
+ path: idePath,
+ exists: true,
+ mtime: ideDoc.mtime,
+ state: 'unconfigured' as const,
+ message: `${hostDefinition.label} settings are not configured for this binding.`,
+ }
+ : {
+ target: 'ide' as const,
+ path: idePath,
+ exists: true,
+ mtime: ideDoc.mtime,
+ state: 'drifted' as const,
+ message: `${hostDefinition.label} settings differ from the expected managed values.`,
+ };
+
+ return { bindingId: binding.id, sharedSettings, ideSettings };
+}
+
+export async function applyClaudeExtensionBinding(
+ binding: ClaudeExtensionBinding,
+ target: ClaudeExtensionActionTarget = 'all'
+): Promise {
+ const setup = await resolveClaudeExtensionSetup(binding.profile);
+ const currentResolvedKeys = getCurrentResolvedManagedKeys(setup);
+ if (targetEnabled(target, 'shared')) {
+ const managedKeys = getManagedKeysForTarget(binding, 'shared', currentResolvedKeys);
+ const filePath = getClaudeSettingsPath();
+ const document = readJsonDocument(filePath);
+ const env = isRecord(document.data.env) ? { ...document.data.env } : {};
+ for (const key of managedKeys) delete env[key];
+ for (const [key, value] of Object.entries(setup.extensionEnv)) env[key] = value;
+ const nextData = { ...document.data };
+ const nextEnv = toStringRecord(env);
+ if (Object.keys(nextEnv).length > 0) nextData.env = sortStringRecord(nextEnv);
+ else delete nextData.env;
+ if (document.exists || Object.keys(setup.extensionEnv).length > 0) {
+ writeJsonDocument(filePath, nextData, 'backup');
+ }
+ updateClaudeExtensionManagedEnvManifest(binding.id, {
+ shared: Object.keys(setup.extensionEnv),
+ });
+ }
+
+ if (targetEnabled(target, 'ide')) {
+ const managedKeys = getManagedKeysForTarget(binding, 'ide', currentResolvedKeys);
+ const hostDefinition = getClaudeExtensionHostDefinition(binding.host);
+ const filePath = resolveClaudeExtensionIdeSettingsPath(binding);
+ const document = readJsonDocument(filePath);
+ const nextData = { ...document.data };
+ const payload = buildClaudeExtensionSettingsObject(setup, binding.host);
+ const mergedEnvEntries = mergeManagedExtensionEnvEntries(
+ document.data[hostDefinition.settingsKey],
+ managedKeys,
+ setup.extensionEnv
+ );
+ if (mergedEnvEntries.length > 0) {
+ nextData[hostDefinition.settingsKey] = mergedEnvEntries;
+ } else {
+ delete nextData[hostDefinition.settingsKey];
+ }
+ if (hostDefinition.disableLoginPromptKey) {
+ if (payload[hostDefinition.disableLoginPromptKey] === true) {
+ nextData[hostDefinition.disableLoginPromptKey] = true;
+ } else {
+ delete nextData[hostDefinition.disableLoginPromptKey];
+ }
+ }
+ if (
+ document.exists ||
+ Object.keys(setup.extensionEnv).length > 0 ||
+ payload[hostDefinition.disableLoginPromptKey ?? ''] === true
+ ) {
+ writeJsonDocument(filePath, nextData, 'ccs-backup');
+ }
+ updateClaudeExtensionManagedEnvManifest(binding.id, {
+ ide: Object.keys(setup.extensionEnv),
+ });
+ }
+
+ return verifyClaudeExtensionBinding(binding);
+}
+
+export async function resetClaudeExtensionBinding(
+ binding: ClaudeExtensionBinding,
+ target: ClaudeExtensionActionTarget = 'all'
+): Promise {
+ const setup = await resolveClaudeExtensionSetup(binding.profile);
+ const currentResolvedKeys = getCurrentResolvedManagedKeys(setup);
+
+ if (targetEnabled(target, 'shared')) {
+ const managedKeys = getManagedKeysForTarget(binding, 'shared', currentResolvedKeys);
+ const filePath = getClaudeSettingsPath();
+ const document = readJsonDocument(filePath);
+ if (document.exists) {
+ const env = isRecord(document.data.env) ? { ...document.data.env } : {};
+ for (const key of managedKeys) delete env[key];
+ const nextData = { ...document.data };
+ const nextEnv = toStringRecord(env);
+ if (Object.keys(nextEnv).length > 0) nextData.env = sortStringRecord(nextEnv);
+ else delete nextData.env;
+ writeJsonDocument(filePath, nextData, 'backup');
+ }
+ updateClaudeExtensionManagedEnvManifest(binding.id, { shared: [] });
+ }
+
+ if (targetEnabled(target, 'ide')) {
+ const managedKeys = getManagedKeysForTarget(binding, 'ide', currentResolvedKeys);
+ const hostDefinition = getClaudeExtensionHostDefinition(binding.host);
+ const filePath = resolveClaudeExtensionIdeSettingsPath(binding);
+ const document = readJsonDocument(filePath);
+ if (document.exists) {
+ const nextData = { ...document.data };
+ const preservedEntries = getExtensionEnvEntries(
+ document.data[hostDefinition.settingsKey]
+ ).filter((entry) => !managedKeys.has(entry.name));
+ if (preservedEntries.length > 0) {
+ nextData[hostDefinition.settingsKey] = preservedEntries;
+ } else {
+ delete nextData[hostDefinition.settingsKey];
+ }
+ if (hostDefinition.disableLoginPromptKey) {
+ delete nextData[hostDefinition.disableLoginPromptKey];
+ }
+ writeJsonDocument(filePath, nextData, 'ccs-backup');
+ }
+ updateClaudeExtensionManagedEnvManifest(binding.id, { ide: [] });
+ }
+
+ return verifyClaudeExtensionBinding(binding);
+}
diff --git a/tests/unit/cliproxy/binary-downloader-proxy.test.ts b/tests/unit/cliproxy/binary-downloader-proxy.test.ts
index a92926f5..6531a3d5 100644
--- a/tests/unit/cliproxy/binary-downloader-proxy.test.ts
+++ b/tests/unit/cliproxy/binary-downloader-proxy.test.ts
@@ -68,6 +68,12 @@ describe('Binary Downloader Proxy Support', () => {
process.env.ALL_PROXY = 'http://allproxy:8080';
expect(getProxyUrl(true)).toBe('http://allproxy:8080');
});
+
+ it('should skip invalid HTTP_PROXY and fall back to ALL_PROXY', () => {
+ process.env.HTTP_PROXY = 'not-a-valid-url';
+ process.env.ALL_PROXY = 'http://allproxy:8080';
+ expect(getProxyUrl(true)).toBe('http://allproxy:8080');
+ });
});
describe('HTTP requests', () => {
@@ -91,6 +97,12 @@ describe('Binary Downloader Proxy Support', () => {
expect(getProxyUrl(false)).toBe('http://allproxy:8080');
});
+ it('should skip invalid HTTP_PROXY and use ALL_PROXY for HTTP', () => {
+ process.env.HTTP_PROXY = 'not-a-valid-url';
+ process.env.ALL_PROXY = 'http://allproxy:8080';
+ expect(getProxyUrl(false)).toBe('http://allproxy:8080');
+ });
+
it('should not use https_proxy for HTTP requests', () => {
process.env.https_proxy = 'http://httpsproxy:8080';
expect(getProxyUrl(false)).toBeUndefined();
@@ -251,6 +263,11 @@ describe('Binary Downloader Proxy Support', () => {
expect(getProxyAgent('https://example.com')).toBe(false);
});
+ it('should keep supporting socks proxy URLs for downloader traffic', () => {
+ process.env.https_proxy = 'socks5://proxy:1080';
+ expect(getProxyAgent('https://example.com')).not.toBe(false);
+ });
+
it('should return false for invalid target URL', () => {
process.env.https_proxy = 'http://proxy:8080';
expect(getProxyAgent('not-a-url')).toBe(false);
diff --git a/tests/unit/cliproxy/composite-thinking.test.ts b/tests/unit/cliproxy/composite-thinking.test.ts
index fe1ad59c..6fb3758b 100644
--- a/tests/unit/cliproxy/composite-thinking.test.ts
+++ b/tests/unit/cliproxy/composite-thinking.test.ts
@@ -192,9 +192,9 @@ describe('applyThinkingConfig - composite variant integration', () => {
compositeTierThinking
);
- // Tier models use raw compositeTierThinking value (no validation in tier loop)
- expect(result.ANTHROPIC_DEFAULT_OPUS_MODEL).toBe('claude-opus-4-6-thinking(xhigh)');
- expect(result.ANTHROPIC_DEFAULT_SONNET_MODEL).toBe('claude-sonnet-4-5-thinking(medium)');
+ // Budget-based tier models are normalized to provider-specific budget values.
+ expect(result.ANTHROPIC_DEFAULT_OPUS_MODEL).toBe('claude-opus-4-6-thinking(32768)');
+ expect(result.ANTHROPIC_DEFAULT_SONNET_MODEL).toBe('claude-sonnet-4-5-thinking(8192)');
// Haiku doesn't support thinking per model-catalog — no suffix
expect(result.ANTHROPIC_DEFAULT_HAIKU_MODEL).toBe('claude-haiku-4-5-20251001');
// ANTHROPIC_MODEL is validated: 'medium' → 8192 for budget-type models
@@ -221,8 +221,8 @@ describe('applyThinkingConfig - composite variant integration', () => {
compositeTierThinking
);
- // Tier models use raw value (no validation in tier loop)
- expect(result.ANTHROPIC_DEFAULT_OPUS_MODEL).toBe('claude-opus-4-6-thinking(xhigh)');
+ // Budget-based tier models are normalized to provider-specific budget values.
+ expect(result.ANTHROPIC_DEFAULT_OPUS_MODEL).toBe('claude-opus-4-6-thinking(32768)');
// Sonnet gets defaults from global config (mode=auto)
expect(result.ANTHROPIC_DEFAULT_SONNET_MODEL).toContain('claude-sonnet-4-5-thinking');
// Haiku doesn't support thinking — stays unchanged
@@ -250,8 +250,8 @@ describe('applyThinkingConfig - composite variant integration', () => {
compositeTierThinking
);
- expect(result.ANTHROPIC_DEFAULT_OPUS_MODEL).toBe('claude-opus-4-6-thinking(high)');
- expect(result.ANTHROPIC_DEFAULT_SONNET_MODEL).toBe('claude-sonnet-4-5-thinking(medium)');
+ expect(result.ANTHROPIC_DEFAULT_OPUS_MODEL).toBe('claude-opus-4-6-thinking(24576)');
+ expect(result.ANTHROPIC_DEFAULT_SONNET_MODEL).toBe('claude-sonnet-4-5-thinking(8192)');
// Haiku should NOT have suffix because thinking is not supported for haiku
expect(result.ANTHROPIC_DEFAULT_HAIKU_MODEL).toBe('claude-haiku-4-5-20251001');
});
@@ -277,9 +277,9 @@ describe('applyThinkingConfig - composite variant integration', () => {
compositeTierThinking
);
- // All thinking-capable tiers should use CLI override
- expect(result.ANTHROPIC_DEFAULT_OPUS_MODEL).toBe('claude-opus-4-6-thinking(minimal)');
- expect(result.ANTHROPIC_DEFAULT_SONNET_MODEL).toBe('claude-sonnet-4-5-thinking(minimal)');
+ // All thinking-capable tiers should use the validated CLI override.
+ expect(result.ANTHROPIC_DEFAULT_OPUS_MODEL).toBe('claude-opus-4-6-thinking(1024)');
+ expect(result.ANTHROPIC_DEFAULT_SONNET_MODEL).toBe('claude-sonnet-4-5-thinking(1024)');
// Haiku doesn't support thinking — stays unchanged regardless of CLI override
expect(result.ANTHROPIC_DEFAULT_HAIKU_MODEL).toBe('claude-haiku-4-5-20251001');
});
@@ -349,7 +349,7 @@ describe('applyThinkingConfig - composite variant integration', () => {
}
);
- expect(result.ANTHROPIC_DEFAULT_SONNET_MODEL).toBe('claude-sonnet-4-5-thinking(high)');
+ expect(result.ANTHROPIC_DEFAULT_SONNET_MODEL).toBe('claude-sonnet-4-5-thinking(24576)');
});
it('applies tier thinking even when default model does not support thinking', () => {
@@ -375,7 +375,7 @@ describe('applyThinkingConfig - composite variant integration', () => {
// Default model provider/model do not support thinking.
expect(result.ANTHROPIC_MODEL).toBe('gpt-4o-mini');
// Supported mixed-provider tier must still receive its configured thinking value.
- expect(result.ANTHROPIC_DEFAULT_SONNET_MODEL).toBe('claude-sonnet-4-5-thinking(high)');
+ expect(result.ANTHROPIC_DEFAULT_SONNET_MODEL).toBe('claude-sonnet-4-5-thinking(24576)');
});
it('handles dotted agy Claude IDs for thinking capability lookup', () => {
@@ -389,10 +389,10 @@ describe('applyThinkingConfig - composite variant integration', () => {
const result = applyThinkingConfig(envVars, 'agy' as CLIProxyProvider, 'high');
// Capability lookup should succeed for dotted agy IDs after normalization.
- // Main model value is validated for budget models; tier values keep raw override.
+ // Tier values are normalized through budget validation too.
expect(result.ANTHROPIC_MODEL).toBe('claude-opus-4.5-thinking(24576)');
- expect(result.ANTHROPIC_DEFAULT_OPUS_MODEL).toBe('claude-opus-4.5-thinking(high)');
- expect(result.ANTHROPIC_DEFAULT_SONNET_MODEL).toBe('claude-sonnet-4.5-thinking(high)');
+ expect(result.ANTHROPIC_DEFAULT_OPUS_MODEL).toBe('claude-opus-4.5-thinking(24576)');
+ expect(result.ANTHROPIC_DEFAULT_SONNET_MODEL).toBe('claude-sonnet-4.5-thinking(24576)');
// Haiku does not support thinking in agy catalog.
expect(result.ANTHROPIC_DEFAULT_HAIKU_MODEL).toBe('claude-haiku-4.5');
});
@@ -418,7 +418,7 @@ describe('applyThinkingConfig - composite variant integration', () => {
compositeTierThinking
);
- // Tier models use raw string values (no validation in tier loop)
+ // Tier models keep numeric values after validation when the provider supports them.
expect(result.ANTHROPIC_DEFAULT_OPUS_MODEL).toBe('claude-opus-4-6-thinking(32768)');
expect(result.ANTHROPIC_DEFAULT_SONNET_MODEL).toBe('claude-sonnet-4-5-thinking(8192)');
// Haiku doesn't support thinking — stays unchanged
@@ -506,8 +506,8 @@ describe('applyThinkingConfig - composite variant integration', () => {
// ANTHROPIC_MODEL is validated: xhigh → 32768 for budget-type models
expect(result.ANTHROPIC_MODEL).toBe('claude-opus-4-6-thinking(32768)');
- // Tier model uses raw value (no validation in tier loop)
- expect(result.ANTHROPIC_DEFAULT_OPUS_MODEL).toBe('claude-opus-4-6-thinking(xhigh)');
+ // Tier model keeps the validated budget value.
+ expect(result.ANTHROPIC_DEFAULT_OPUS_MODEL).toBe('claude-opus-4-6-thinking(32768)');
});
it('should preserve models that already have thinking suffix', () => {
@@ -534,8 +534,8 @@ describe('applyThinkingConfig - composite variant integration', () => {
// Existing suffix on main model should be preserved.
expect(result.ANTHROPIC_DEFAULT_SONNET_MODEL).toBe('claude-sonnet-4-5-thinking(high)');
expect(result.ANTHROPIC_MODEL).toBe('claude-sonnet-4-5-thinking(high)');
- // Other supported tiers still receive configured thinking.
- expect(result.ANTHROPIC_DEFAULT_OPUS_MODEL).toBe('claude-opus-4-6-thinking(xhigh)');
+ // Other supported tiers still receive configured thinking after validation.
+ expect(result.ANTHROPIC_DEFAULT_OPUS_MODEL).toBe('claude-opus-4-6-thinking(32768)');
});
it('should use codex effort suffix style when provider is codex', () => {
@@ -556,7 +556,7 @@ describe('applyThinkingConfig - composite variant integration', () => {
expect(result.ANTHROPIC_MODEL).toBe('gpt-5.3-codex-xhigh');
expect(result.ANTHROPIC_DEFAULT_OPUS_MODEL).toBe('gpt-5.3-codex-xhigh');
expect(result.ANTHROPIC_DEFAULT_SONNET_MODEL).toBe('gpt-5.3-codex-xhigh');
- expect(result.ANTHROPIC_DEFAULT_HAIKU_MODEL).toBe('gpt-5-mini-xhigh');
+ expect(result.ANTHROPIC_DEFAULT_HAIKU_MODEL).toBe('gpt-5-mini-high');
});
it('should normalize legacy codex parenthesized tier suffix to effort suffix format', () => {
diff --git a/tests/unit/cliproxy/thinking-validator.test.ts b/tests/unit/cliproxy/thinking-validator.test.ts
index 0be4ac61..d48679be 100644
--- a/tests/unit/cliproxy/thinking-validator.test.ts
+++ b/tests/unit/cliproxy/thinking-validator.test.ts
@@ -102,6 +102,13 @@ describe('Thinking Validator', () => {
expect(typeof result.value).toBe('string'); // Should be a level name
expect(result.warning).toContain('Mapped');
});
+
+ it('caps unsupported higher standard levels to the highest supported model level', () => {
+ const result = validateThinking('codex', 'gpt-5-mini', 'xhigh');
+ expect(result.valid).toBe(true);
+ expect(result.value).toBe('high');
+ expect(result.warning).toContain('mapped to "high"');
+ });
});
describe('Budget-type models (like Claude via agy)', () => {
diff --git a/tests/unit/commands/help-command-parity.test.ts b/tests/unit/commands/help-command-parity.test.ts
index 285e6585..27cd4de6 100644
--- a/tests/unit/commands/help-command-parity.test.ts
+++ b/tests/unit/commands/help-command-parity.test.ts
@@ -40,4 +40,22 @@ describe('help command parity', () => {
expect(rendered.includes('ccs llamacpp')).toBe(true);
expect(rendered.includes('http://127.0.0.1:8080')).toBe(true);
});
+
+ test('root help documents Claude IDE extension setup surfaces', async () => {
+ const lines: string[] = [];
+ console.log = (...args: unknown[]) => {
+ lines.push(args.map((arg) => String(arg)).join(' '));
+ };
+
+ await handleHelpCommand();
+
+ const rendered = stripAnsi(lines.join('\n'));
+ expect(rendered.includes('Claude IDE Extension setup page')).toBe(true);
+ expect(rendered.includes('ccs env --format claude-extension --ide vscode')).toBe(
+ true
+ );
+ expect(rendered.includes('ccs env --format claude-extension --ide windsurf')).toBe(
+ true
+ );
+ });
});
diff --git a/tests/unit/commands/persist-command-handler.test.ts b/tests/unit/commands/persist-command-handler.test.ts
index d285a59b..a298c09d 100644
--- a/tests/unit/commands/persist-command-handler.test.ts
+++ b/tests/unit/commands/persist-command-handler.test.ts
@@ -4,6 +4,8 @@ import * as os from 'os';
import * as path from 'path';
import * as lockfile from 'proper-lockfile';
import { handlePersistCommand } from '../../../src/commands/persist-command';
+import { createEmptyUnifiedConfig } from '../../../src/config/unified-config-types';
+import { saveUnifiedConfig } from '../../../src/config/unified-config-loader';
interface RestoreFixture {
claudeDir: string;
@@ -16,6 +18,7 @@ interface RestoreFixture {
let tempRoot: string;
let originalClaudeConfigDir: string | undefined;
+let originalCcsHome: string | undefined;
let originalProcessExit: typeof process.exit;
let originalFsOpen: typeof fs.promises.open;
let originalFsRename: typeof fs.promises.rename;
@@ -66,9 +69,11 @@ function stubProcessExit(): void {
beforeEach(async () => {
tempRoot = await fs.promises.mkdtemp(path.join(os.tmpdir(), 'ccs-persist-handler-test-'));
originalClaudeConfigDir = process.env.CLAUDE_CONFIG_DIR;
+ originalCcsHome = process.env.CCS_HOME;
originalProcessExit = process.exit;
originalFsOpen = fs.promises.open;
originalFsRename = fs.promises.rename;
+ process.env.CCS_HOME = tempRoot;
});
afterEach(async () => {
@@ -82,6 +87,12 @@ afterEach(async () => {
process.env.CLAUDE_CONFIG_DIR = originalClaudeConfigDir;
}
+ if (originalCcsHome === undefined) {
+ delete process.env.CCS_HOME;
+ } else {
+ process.env.CCS_HOME = originalCcsHome;
+ }
+
if (tempRoot) {
await fs.promises.rm(tempRoot, { recursive: true, force: true });
}
@@ -271,3 +282,105 @@ describe('persist command restore failure handling', () => {
}
});
});
+
+describe('persist command Claude extension parity', () => {
+ async function writeUnifiedConfig(): Promise {
+ const config = createEmptyUnifiedConfig();
+ config.accounts.work = {
+ created: '2026-03-15T00:00:00.000Z',
+ last_used: null,
+ context_mode: 'isolated',
+ };
+ config.default = 'work';
+ config.profiles.glm = {
+ type: 'api',
+ settings: path.join(tempRoot, '.ccs', 'glm.settings.json'),
+ };
+
+ await fs.promises.mkdir(path.join(tempRoot, '.ccs'), { recursive: true });
+ await fs.promises.writeFile(
+ path.join(tempRoot, '.ccs', 'glm.settings.json'),
+ JSON.stringify(
+ {
+ env: {
+ ANTHROPIC_BASE_URL: 'https://api.example.test',
+ ANTHROPIC_API_KEY: 'sk-ant-test-123456',
+ ANTHROPIC_MODEL: 'claude-sonnet-4-5',
+ },
+ },
+ null,
+ 2
+ ) + '\n',
+ 'utf8'
+ );
+ saveUnifiedConfig(config);
+ }
+
+ it('persists account profiles via CLAUDE_CONFIG_DIR and clears stale managed env keys', async () => {
+ await writeUnifiedConfig();
+
+ const settingsPath = path.join(tempRoot, '.claude', 'settings.json');
+ await fs.promises.mkdir(path.dirname(settingsPath), { recursive: true });
+ await fs.promises.writeFile(
+ settingsPath,
+ JSON.stringify(
+ {
+ env: {
+ ANTHROPIC_API_KEY: 'stale-key',
+ ANTHROPIC_BASE_URL: 'http://127.0.0.1:8317',
+ KEEP_ME: 'still-here',
+ },
+ },
+ null,
+ 2
+ ) + '\n',
+ 'utf8'
+ );
+
+ await handlePersistCommand(['work', '--yes']);
+
+ const persisted = JSON.parse(await fs.promises.readFile(settingsPath, 'utf8')) as {
+ env: Record;
+ };
+
+ expect(persisted.env.KEEP_ME).toBe('still-here');
+ expect(persisted.env.ANTHROPIC_API_KEY).toBeUndefined();
+ expect(persisted.env.ANTHROPIC_BASE_URL).toBeUndefined();
+ expect(persisted.env.CLAUDE_CONFIG_DIR).toBe(path.join(tempRoot, '.ccs', 'instances', 'work'));
+ expect(fs.existsSync(persisted.env.CLAUDE_CONFIG_DIR)).toBe(true);
+ });
+
+ it('persists default profile using mapped account continuity and preserves unrelated env', async () => {
+ await writeUnifiedConfig();
+
+ const settingsPath = path.join(tempRoot, '.claude', 'settings.json');
+ await fs.promises.mkdir(path.dirname(settingsPath), { recursive: true });
+ await fs.promises.writeFile(
+ settingsPath,
+ JSON.stringify(
+ {
+ env: {
+ ANTHROPIC_AUTH_TOKEN: 'stale-token',
+ ANTHROPIC_MODEL: 'stale-model',
+ KEEP_ME: 'still-here',
+ },
+ },
+ null,
+ 2
+ ) + '\n',
+ 'utf8'
+ );
+
+ await handlePersistCommand(['default', '--yes']);
+
+ const persisted = JSON.parse(await fs.promises.readFile(settingsPath, 'utf8')) as {
+ env: Record;
+ };
+
+ expect(persisted.env.KEEP_ME).toBe('still-here');
+ expect(persisted.env.ANTHROPIC_AUTH_TOKEN).toBeUndefined();
+ expect(persisted.env.ANTHROPIC_MODEL).toBeUndefined();
+ expect(persisted.env.CLAUDE_CONFIG_DIR).toBe(path.join(tempRoot, '.ccs', 'instances', 'work'));
+ expect(fs.existsSync(persisted.env.CLAUDE_CONFIG_DIR)).toBe(true);
+ });
+});
diff --git a/tests/unit/copilot/copilot-executor-env.test.ts b/tests/unit/copilot/copilot-executor-env.test.ts
index 86b3db96..233c1e42 100644
--- a/tests/unit/copilot/copilot-executor-env.test.ts
+++ b/tests/unit/copilot/copilot-executor-env.test.ts
@@ -13,6 +13,34 @@ const baseConfig: CopilotConfig = {
};
describe('generateCopilotEnv', () => {
+ it('normalizes deprecated raptor-mini model selections to the safe default', () => {
+ const env = generateCopilotEnv({
+ ...baseConfig,
+ model: 'raptor-mini',
+ opus_model: 'raptor-mini',
+ sonnet_model: 'raptor-mini',
+ haiku_model: 'raptor-mini',
+ });
+
+ expect(env.ANTHROPIC_MODEL).toBe('gpt-4.1');
+ expect(env.ANTHROPIC_DEFAULT_OPUS_MODEL).toBe('gpt-4.1');
+ expect(env.ANTHROPIC_DEFAULT_SONNET_MODEL).toBe('gpt-4.1');
+ expect(env.ANTHROPIC_DEFAULT_HAIKU_MODEL).toBe('gpt-4.1');
+ expect(env.ANTHROPIC_SMALL_FAST_MODEL).toBe('gpt-4.1');
+ });
+
+ it('falls back deprecated haiku overrides to the selected base model', () => {
+ const env = generateCopilotEnv({
+ ...baseConfig,
+ model: 'claude-sonnet-4.5',
+ haiku_model: 'raptor-mini',
+ });
+
+ expect(env.ANTHROPIC_MODEL).toBe('claude-sonnet-4.5');
+ expect(env.ANTHROPIC_DEFAULT_HAIKU_MODEL).toBe('claude-sonnet-4.5');
+ expect(env.ANTHROPIC_SMALL_FAST_MODEL).toBe('claude-sonnet-4.5');
+ });
+
it('includes inherited CLAUDE_CONFIG_DIR when provided', () => {
const env = generateCopilotEnv(baseConfig, '/tmp/.ccs/instances/pro');
expect(env.CLAUDE_CONFIG_DIR).toBe('/tmp/.ccs/instances/pro');
@@ -23,4 +51,3 @@ describe('generateCopilotEnv', () => {
expect(env.CLAUDE_CONFIG_DIR).toBeUndefined();
});
});
-
diff --git a/tests/unit/copilot/copilot-model-normalizer.test.ts b/tests/unit/copilot/copilot-model-normalizer.test.ts
new file mode 100644
index 00000000..016f12ec
--- /dev/null
+++ b/tests/unit/copilot/copilot-model-normalizer.test.ts
@@ -0,0 +1,80 @@
+import { describe, expect, it } from 'bun:test';
+import { DEFAULT_COPILOT_CONFIG } from '../../../src/config/unified-config-types';
+import {
+ DEPRECATED_COPILOT_MODEL_IDS,
+ normalizeCopilotConfig,
+ normalizeCopilotConfigWithWarnings,
+ normalizeCopilotModelId,
+ normalizeCopilotSettings,
+ normalizeCopilotSettingsWithWarnings,
+} from '../../../src/copilot/copilot-model-normalizer';
+
+describe('copilot-model-normalizer', () => {
+ it('tracks raptor-mini as deprecated', () => {
+ expect(DEPRECATED_COPILOT_MODEL_IDS).toContain('raptor-mini');
+ });
+
+ it('normalizes deprecated model IDs to the safe default', () => {
+ expect(normalizeCopilotModelId('raptor-mini')).toBe(DEFAULT_COPILOT_CONFIG.model);
+ });
+
+ it('falls back deprecated tier overrides to the normalized base model', () => {
+ const result = normalizeCopilotConfigWithWarnings({
+ ...DEFAULT_COPILOT_CONFIG,
+ model: 'claude-sonnet-4.5',
+ haiku_model: 'raptor-mini',
+ });
+
+ expect(result.config.model).toBe('claude-sonnet-4.5');
+ expect(result.config.haiku_model).toBe('claude-sonnet-4.5');
+ expect(result.warnings).toHaveLength(1);
+ expect(result.warnings[0]?.message).toContain("'raptor-mini'");
+ expect(result.warnings[0]?.message).toContain("'claude-sonnet-4.5'");
+ });
+
+ it('normalizes raw settings payloads without dropping unrelated env keys', () => {
+ const normalized = normalizeCopilotSettings(
+ {
+ env: {
+ ANTHROPIC_BASE_URL: 'http://127.0.0.1:4141',
+ ANTHROPIC_MODEL: 'raptor-mini',
+ ANTHROPIC_DEFAULT_OPUS_MODEL: 'raptor-mini',
+ ANTHROPIC_DEFAULT_SONNET_MODEL: 'raptor-mini',
+ ANTHROPIC_DEFAULT_HAIKU_MODEL: 'raptor-mini',
+ EXTRA_FLAG: 'keep-me',
+ },
+ },
+ {
+ ...DEFAULT_COPILOT_CONFIG,
+ model: 'raptor-mini',
+ }
+ );
+
+ expect(normalized.env?.ANTHROPIC_MODEL).toBe('gpt-4.1');
+ expect(normalized.env?.ANTHROPIC_DEFAULT_OPUS_MODEL).toBe('gpt-4.1');
+ expect(normalized.env?.ANTHROPIC_DEFAULT_SONNET_MODEL).toBe('gpt-4.1');
+ expect(normalized.env?.ANTHROPIC_DEFAULT_HAIKU_MODEL).toBe('gpt-4.1');
+ expect(normalized.env?.EXTRA_FLAG).toBe('keep-me');
+ });
+
+ it('keeps small-fast and haiku env settings in lockstep', () => {
+ const result = normalizeCopilotSettingsWithWarnings(
+ {
+ env: {
+ ANTHROPIC_MODEL: 'claude-sonnet-4.5',
+ ANTHROPIC_SMALL_FAST_MODEL: 'raptor-mini',
+ },
+ },
+ {
+ ...DEFAULT_COPILOT_CONFIG,
+ model: 'claude-sonnet-4.5',
+ }
+ );
+
+ expect(result.settings.env?.ANTHROPIC_DEFAULT_HAIKU_MODEL).toBe('claude-sonnet-4.5');
+ expect(result.settings.env?.ANTHROPIC_SMALL_FAST_MODEL).toBe('claude-sonnet-4.5');
+ expect(result.effectiveConfig.haiku_model).toBe('claude-sonnet-4.5');
+ expect(result.warnings).toHaveLength(1);
+ expect(result.warnings[0]?.tier).toBe('haiku');
+ });
+});
diff --git a/tests/unit/copilot/copilot-models.test.ts b/tests/unit/copilot/copilot-models.test.ts
index c7074ced..b82cb6fa 100644
--- a/tests/unit/copilot/copilot-models.test.ts
+++ b/tests/unit/copilot/copilot-models.test.ts
@@ -3,6 +3,10 @@ import * as http from 'http';
import { DEFAULT_COPILOT_MODELS, fetchModelsFromDaemon } from '../../../src/copilot/copilot-models';
describe('fetchModelsFromDaemon', () => {
+ it('does not advertise deprecated fallback models', () => {
+ expect(DEFAULT_COPILOT_MODELS.some((model) => model.id === 'raptor-mini')).toBe(false);
+ });
+
it('falls back to defaults when daemon is unreachable', async () => {
const models = await fetchModelsFromDaemon(9999);
expect(models).toEqual(DEFAULT_COPILOT_MODELS);
diff --git a/tests/unit/utils/fetch-proxy-setup.test.ts b/tests/unit/utils/fetch-proxy-setup.test.ts
new file mode 100644
index 00000000..446d765c
--- /dev/null
+++ b/tests/unit/utils/fetch-proxy-setup.test.ts
@@ -0,0 +1,198 @@
+import { afterEach, beforeEach, describe, expect, it } from 'bun:test';
+import * as http from 'node:http';
+import {
+ Agent,
+ Dispatcher,
+ ProxyAgent,
+ fetch,
+ getGlobalDispatcher,
+ setGlobalDispatcher,
+} from 'undici';
+import {
+ applyGlobalFetchProxy,
+ createGlobalFetchProxyDispatcher,
+} from '../../../src/utils/fetch-proxy-setup';
+
+const PROXY_ENV_KEYS = [
+ 'http_proxy',
+ 'HTTP_PROXY',
+ 'https_proxy',
+ 'HTTPS_PROXY',
+ 'all_proxy',
+ 'ALL_PROXY',
+ 'no_proxy',
+ 'NO_PROXY',
+] as const;
+
+describe('global fetch proxy setup', () => {
+ const originalEnv = new Map();
+ const originalDispatcher = getGlobalDispatcher();
+
+ beforeEach(() => {
+ for (const key of PROXY_ENV_KEYS) {
+ originalEnv.set(key, process.env[key]);
+ delete process.env[key];
+ }
+ setGlobalDispatcher(originalDispatcher);
+ });
+
+ afterEach(() => {
+ setGlobalDispatcher(originalDispatcher);
+ for (const key of PROXY_ENV_KEYS) {
+ const value = originalEnv.get(key);
+ if (value === undefined) {
+ delete process.env[key];
+ } else {
+ process.env[key] = value;
+ }
+ }
+ });
+
+ async function captureDispatchRouting(
+ origin: string
+ ): Promise<{ directCalls: number; proxyCalls: number }> {
+ const dispatcher = createGlobalFetchProxyDispatcher();
+ if (!dispatcher) {
+ throw new Error('Expected proxy dispatcher to be configured');
+ }
+
+ let directCalls = 0;
+ let proxyCalls = 0;
+ const originalAgentDispatch = Agent.prototype.dispatch;
+ const originalProxyDispatch = ProxyAgent.prototype.dispatch;
+
+ Agent.prototype.dispatch = function mockAgentDispatch(
+ _options: Dispatcher.DispatchOptions,
+ _handler: Dispatcher.DispatchHandlers
+ ): boolean {
+ directCalls += 1;
+ return true;
+ };
+
+ ProxyAgent.prototype.dispatch = function mockProxyDispatch(
+ _options: Dispatcher.DispatchOptions,
+ _handler: Dispatcher.DispatchHandlers
+ ): boolean {
+ proxyCalls += 1;
+ return true;
+ };
+
+ try {
+ dispatcher.dispatch(
+ {
+ origin,
+ method: 'GET',
+ path: '/',
+ } as Dispatcher.DispatchOptions,
+ {} as Dispatcher.DispatchHandlers
+ );
+ } finally {
+ Agent.prototype.dispatch = originalAgentDispatch;
+ ProxyAgent.prototype.dispatch = originalProxyDispatch;
+ }
+
+ return { directCalls, proxyCalls };
+ }
+
+ it('does not fail when proxy configuration is invalid', () => {
+ process.env.HTTP_PROXY = 'not-a-valid-url';
+
+ expect(applyGlobalFetchProxy()).toEqual({
+ enabled: false,
+ error: 'Invalid URL',
+ });
+ });
+
+ it('rejects unsupported proxy protocols for global fetch setup', () => {
+ process.env.ALL_PROXY = 'socks5://proxy:1080';
+
+ expect(applyGlobalFetchProxy()).toEqual({
+ enabled: false,
+ error: 'Unsupported proxy protocol: socks5:',
+ });
+ });
+
+ it('rebinds globalThis.fetch to undici fetch when proxying is enabled', () => {
+ const originalFetch = globalThis.fetch;
+ process.env.HTTP_PROXY = 'http://proxy.example:8080';
+
+ try {
+ expect(applyGlobalFetchProxy()).toEqual({ enabled: true });
+ expect(globalThis.fetch).toBe(fetch);
+ } finally {
+ globalThis.fetch = originalFetch;
+ }
+ });
+
+ it('bypasses loopback fetches even when HTTP_PROXY is set', async () => {
+ process.env.HTTP_PROXY = 'http://127.0.0.1:9';
+
+ const server = http.createServer((_req, res) => {
+ res.writeHead(200, { 'content-type': 'text/plain' });
+ res.end('ok');
+ });
+
+ await new Promise((resolve) => server.listen(0, '127.0.0.1', resolve));
+ const address = server.address();
+ if (!address || typeof address === 'string') {
+ throw new Error('Failed to bind test server');
+ }
+
+ try {
+ expect(applyGlobalFetchProxy()).toEqual({ enabled: true });
+
+ const response = await fetch(`http://127.0.0.1:${address.port}/health`);
+ expect(response.status).toBe(200);
+ expect(await response.text()).toBe('ok');
+ } finally {
+ await new Promise((resolve, reject) => {
+ server.close((error) => (error ? reject(error) : resolve()));
+ });
+ }
+ });
+
+ it('routes non-loopback HTTP requests through HTTP_PROXY', async () => {
+ process.env.HTTP_PROXY = 'http://proxy.example:8080';
+
+ const result = await captureDispatchRouting('http://example.com/quota');
+ expect(result).toEqual({ directCalls: 0, proxyCalls: 1 });
+ });
+
+ it('routes HTTPS requests through HTTPS_PROXY', async () => {
+ process.env.HTTPS_PROXY = 'http://proxy.example:8443';
+
+ const result = await captureDispatchRouting('https://example.com/secure');
+ expect(result).toEqual({ directCalls: 0, proxyCalls: 1 });
+ });
+
+ it('supports ALL_PROXY as a fetch proxy fallback', async () => {
+ process.env.ALL_PROXY = 'http://proxy.example:8080';
+
+ const result = await captureDispatchRouting('http://example.com/all-proxy');
+ expect(result).toEqual({ directCalls: 0, proxyCalls: 1 });
+ });
+
+ it('falls back to ALL_PROXY when HTTP_PROXY is invalid', async () => {
+ process.env.HTTP_PROXY = 'not-a-valid-url';
+ process.env.ALL_PROXY = 'http://proxy.example:8080';
+
+ const result = await captureDispatchRouting('http://example.com/fallback');
+ expect(result).toEqual({ directCalls: 0, proxyCalls: 1 });
+ });
+
+ it('falls back from invalid HTTPS_PROXY to HTTP_PROXY for HTTPS requests', async () => {
+ process.env.HTTPS_PROXY = 'not-a-valid-url';
+ process.env.HTTP_PROXY = 'http://proxy.example:8080';
+
+ const result = await captureDispatchRouting('https://example.com/fallback-secure');
+ expect(result).toEqual({ directCalls: 0, proxyCalls: 1 });
+ });
+
+ it('honors NO_PROXY on the fetch routing path', async () => {
+ process.env.HTTP_PROXY = 'http://proxy.example:8080';
+ process.env.NO_PROXY = 'example.com';
+
+ const result = await captureDispatchRouting('http://example.com/direct');
+ expect(result).toEqual({ directCalls: 1, proxyCalls: 0 });
+ });
+});
diff --git a/tests/unit/utils/proxy-env.test.ts b/tests/unit/utils/proxy-env.test.ts
new file mode 100644
index 00000000..efb38ea1
--- /dev/null
+++ b/tests/unit/utils/proxy-env.test.ts
@@ -0,0 +1,96 @@
+import { afterEach, beforeEach, describe, expect, it } from 'bun:test';
+import { getProxyResolution, shouldBypassProxy } from '../../../src/utils/proxy-env';
+
+const PROXY_ENV_KEYS = [
+ 'http_proxy',
+ 'HTTP_PROXY',
+ 'https_proxy',
+ 'HTTPS_PROXY',
+ 'all_proxy',
+ 'ALL_PROXY',
+ 'no_proxy',
+ 'NO_PROXY',
+] as const;
+
+describe('proxy env helpers', () => {
+ const originalEnv = new Map();
+
+ beforeEach(() => {
+ for (const key of PROXY_ENV_KEYS) {
+ originalEnv.set(key, process.env[key]);
+ delete process.env[key];
+ }
+ });
+
+ afterEach(() => {
+ for (const key of PROXY_ENV_KEYS) {
+ const value = originalEnv.get(key);
+ if (value === undefined) {
+ delete process.env[key];
+ } else {
+ process.env[key] = value;
+ }
+ }
+ });
+
+ describe('getProxyResolution', () => {
+ it('falls back from invalid HTTPS_PROXY to valid HTTP_PROXY for HTTPS requests', () => {
+ process.env.HTTPS_PROXY = 'not-a-valid-url';
+ process.env.HTTP_PROXY = 'http://http-proxy:8080';
+
+ expect(getProxyResolution(true, process.env, { allowedProtocols: ['http:', 'https:'] })).toEqual(
+ {
+ url: 'http://http-proxy:8080',
+ }
+ );
+ });
+
+ it('preserves socks proxy URLs when no protocol restriction is requested', () => {
+ process.env.https_proxy = 'socks5://proxy:1080';
+
+ expect(getProxyResolution(true)).toEqual({ url: 'socks5://proxy:1080' });
+ });
+
+ it('falls back from unsupported HTTPS_PROXY to valid ALL_PROXY when protocols are restricted', () => {
+ process.env.https_proxy = 'socks5://proxy:1080';
+ process.env.ALL_PROXY = 'http://all-proxy:8080';
+
+ expect(getProxyResolution(true, process.env, { allowedProtocols: ['http:', 'https:'] })).toEqual(
+ {
+ url: 'http://all-proxy:8080',
+ }
+ );
+ });
+
+ it('returns an error when only invalid proxy env values are configured for restricted protocols', () => {
+ process.env.https_proxy = 'socks5://proxy:1080';
+ process.env.HTTP_PROXY = 'not-a-valid-url';
+
+ expect(getProxyResolution(true, process.env, { allowedProtocols: ['http:', 'https:'] })).toEqual(
+ {
+ error: 'Unsupported proxy protocol: socks5:',
+ }
+ );
+ });
+ });
+
+ describe('shouldBypassProxy', () => {
+ it('automatically bypasses loopback hosts without NO_PROXY', () => {
+ expect(shouldBypassProxy('localhost')).toBe(true);
+ expect(shouldBypassProxy('api.localhost')).toBe(true);
+ expect(shouldBypassProxy('0.0.0.0')).toBe(true);
+ expect(shouldBypassProxy('127.0.0.2')).toBe(true);
+ expect(shouldBypassProxy('::1')).toBe(true);
+ expect(shouldBypassProxy('::ffff:127.0.0.1')).toBe(true);
+ expect(shouldBypassProxy('::ffff:7f00:1')).toBe(true);
+ });
+
+ it('supports wildcard NO_PROXY domain suffix patterns', () => {
+ process.env.NO_PROXY = '*.example.com';
+
+ expect(shouldBypassProxy('example.com')).toBe(true);
+ expect(shouldBypassProxy('api.example.com')).toBe(true);
+ expect(shouldBypassProxy('other.test')).toBe(false);
+ });
+ });
+});
diff --git a/tests/unit/web-server/claude-extension-routes.test.ts b/tests/unit/web-server/claude-extension-routes.test.ts
new file mode 100644
index 00000000..84e27c77
--- /dev/null
+++ b/tests/unit/web-server/claude-extension-routes.test.ts
@@ -0,0 +1,483 @@
+import { afterAll, afterEach, beforeAll, beforeEach, describe, expect, it } from 'bun:test';
+import express from 'express';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import type { Server } from 'http';
+import claudeExtensionRoutes from '../../../src/web-server/routes/claude-extension-routes';
+import { createEmptyUnifiedConfig } from '../../../src/config/unified-config-types';
+import { saveUnifiedConfig } from '../../../src/config/unified-config-loader';
+
+describe('web-server claude-extension-routes', () => {
+ let server: Server;
+ let baseUrl = '';
+ let tempHome = '';
+ let originalCcsHome: string | undefined;
+
+ beforeAll(async () => {
+ const app = express();
+ app.use(express.json());
+ app.use('/api/claude-extension', claudeExtensionRoutes);
+
+ await new Promise((resolve, reject) => {
+ server = app.listen(0, '127.0.0.1');
+ const handleError = (error: Error) => reject(error);
+ server.once('error', handleError);
+ server.once('listening', () => {
+ server.off('error', handleError);
+ resolve();
+ });
+ });
+
+ const address = server.address();
+ if (!address || typeof address === 'string') {
+ throw new Error('Unable to resolve test server port');
+ }
+ baseUrl = `http://127.0.0.1:${address.port}`;
+ });
+
+ afterAll(async () => {
+ await new Promise((resolve) => server.close(() => resolve()));
+ });
+
+ beforeEach(() => {
+ tempHome = fs.mkdtempSync(path.join(os.tmpdir(), 'ccs-claude-extension-routes-'));
+ originalCcsHome = process.env.CCS_HOME;
+ process.env.CCS_HOME = tempHome;
+
+ const ccsDir = path.join(tempHome, '.ccs');
+ fs.mkdirSync(ccsDir, { recursive: true });
+ fs.writeFileSync(
+ path.join(ccsDir, 'glm.settings.json'),
+ JSON.stringify(
+ {
+ env: {
+ ANTHROPIC_BASE_URL: 'https://api.example.test',
+ ANTHROPIC_API_KEY: 'sk-ant-test-123456',
+ ANTHROPIC_MODEL: 'claude-sonnet-4-5',
+ },
+ },
+ null,
+ 2
+ ) + '\n'
+ );
+ fs.writeFileSync(
+ path.join(ccsDir, 'rich.settings.json'),
+ JSON.stringify(
+ {
+ env: {
+ ANTHROPIC_BASE_URL: 'https://rich.example.test',
+ ANTHROPIC_API_KEY: 'sk-ant-rich-123456',
+ ANTHROPIC_MODEL: 'claude-opus-4-1',
+ ANTHROPIC_MAX_TOKENS: '65536',
+ API_TIMEOUT_MS: '120000',
+ EXPERIMENTAL_ROUTER_HEADER: 'tenant-alpha',
+ },
+ },
+ null,
+ 2
+ ) + '\n'
+ );
+
+ const config = createEmptyUnifiedConfig();
+ config.profiles.glm = {
+ type: 'api',
+ settings: path.join(ccsDir, 'glm.settings.json'),
+ };
+ config.profiles.rich = {
+ type: 'api',
+ settings: path.join(ccsDir, 'rich.settings.json'),
+ };
+ config.accounts.work = {
+ created: '2026-03-15T00:00:00.000Z',
+ last_used: null,
+ context_mode: 'isolated',
+ };
+ config.default = 'work';
+ saveUnifiedConfig(config);
+ });
+
+ afterEach(() => {
+ if (originalCcsHome !== undefined) process.env.CCS_HOME = originalCcsHome;
+ else delete process.env.CCS_HOME;
+
+ if (tempHome && fs.existsSync(tempHome)) {
+ fs.rmSync(tempHome, { recursive: true, force: true });
+ }
+ });
+
+ it('lists profile options and IDE host targets', async () => {
+ const response = await fetch(`${baseUrl}/api/claude-extension/profiles`);
+ expect(response.status).toBe(200);
+
+ const payload = (await response.json()) as {
+ profiles: Array<{ name: string }>;
+ hosts: Array<{ id: string; defaultSettingsPath: string }>;
+ };
+
+ expect(payload.profiles.some((profile) => profile.name === 'default')).toBe(true);
+ expect(payload.profiles.some((profile) => profile.name === 'glm')).toBe(true);
+ expect(payload.profiles.some((profile) => profile.name === 'work')).toBe(true);
+ expect(payload.profiles.some((profile) => profile.name === 'gemini')).toBe(true);
+ expect(payload.hosts.map((host) => host.id)).toEqual(['vscode', 'cursor', 'windsurf']);
+ expect(payload.hosts.every((host) => host.defaultSettingsPath.endsWith('settings.json'))).toBe(
+ true
+ );
+ });
+
+ it('renders VS Code setup for API profiles with disableLoginPrompt', async () => {
+ const response = await fetch(`${baseUrl}/api/claude-extension/setup?profile=glm&host=vscode`);
+ expect(response.status).toBe(200);
+
+ const payload = (await response.json()) as {
+ host: { settingsKey: string; disableLoginPromptKey?: string };
+ ideSettings: { json: string };
+ sharedSettings: { command: string; json: string };
+ };
+
+ expect(payload.host.settingsKey).toBe('claudeCode.environmentVariables');
+ expect(payload.host.disableLoginPromptKey).toBe('claudeCode.disableLoginPrompt');
+ expect(payload.ideSettings.json).toContain('"claudeCode.disableLoginPrompt": true');
+ expect(payload.ideSettings.json).toContain('"ANTHROPIC_API_KEY"');
+ expect(payload.sharedSettings.command).toBe('ccs persist glm');
+ expect(payload.sharedSettings.json).toContain('"env"');
+ });
+
+ it('renders Windsurf setup for default account resolution via CLAUDE_CONFIG_DIR', async () => {
+ const response = await fetch(
+ `${baseUrl}/api/claude-extension/setup?profile=default&host=windsurf`
+ );
+ expect(response.status).toBe(200);
+
+ const payload = (await response.json()) as {
+ profile: { profileType: string; resolvedProfileName: string };
+ host: { settingsKey: string };
+ ideSettings: { json: string };
+ sharedSettings: { command: string };
+ };
+
+ expect(payload.profile.profileType).toBe('account');
+ expect(payload.profile.resolvedProfileName).toBe('work');
+ expect(payload.host.settingsKey).toBe('claude-code.environmentVariables');
+ expect(payload.ideSettings.json).toContain('"claude-code.environmentVariables"');
+ expect(payload.ideSettings.json).toContain('"CLAUDE_CONFIG_DIR"');
+ expect(payload.sharedSettings.command).toBe('ccs persist default');
+ });
+
+ it('creates a binding and applies managed settings to shared + IDE targets', async () => {
+ const ideSettingsPath = path.join(tempHome, 'ide', 'vscode', 'settings.json');
+ const createResponse = await fetch(`${baseUrl}/api/claude-extension/bindings`, {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({
+ name: 'GLM in VS Code',
+ profile: 'glm',
+ host: 'vscode',
+ ideSettingsPath,
+ }),
+ });
+ expect(createResponse.status).toBe(201);
+
+ const created = (await createResponse.json()) as {
+ binding: { id: string; effectiveIdeSettingsPath: string; usesDefaultIdeSettingsPath: boolean };
+ };
+ expect(created.binding.effectiveIdeSettingsPath).toBe(ideSettingsPath);
+ expect(created.binding.usesDefaultIdeSettingsPath).toBe(false);
+
+ const applyResponse = await fetch(
+ `${baseUrl}/api/claude-extension/bindings/${created.binding.id}/apply`,
+ {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({ target: 'all' }),
+ }
+ );
+ expect(applyResponse.status).toBe(200);
+
+ const applied = (await applyResponse.json()) as {
+ sharedSettings: { state: string };
+ ideSettings: { state: string };
+ };
+ expect(applied.sharedSettings.state).toBe('applied');
+ expect(applied.ideSettings.state).toBe('applied');
+
+ const sharedSettingsPath = path.join(tempHome, '.claude', 'settings.json');
+ const sharedSettings = JSON.parse(fs.readFileSync(sharedSettingsPath, 'utf8')) as {
+ env?: Record;
+ };
+ const ideSettings = JSON.parse(fs.readFileSync(ideSettingsPath, 'utf8')) as Record<
+ string,
+ unknown
+ >;
+
+ expect(sharedSettings.env?.ANTHROPIC_API_KEY).toBe('sk-ant-test-123456');
+ expect(sharedSettings.env?.ANTHROPIC_MODEL).toBe('claude-sonnet-4-5');
+ expect(
+ Array.isArray(ideSettings['claudeCode.environmentVariables']) &&
+ (ideSettings['claudeCode.environmentVariables'] as Array<{ name: string }>).some(
+ (entry) => entry.name === 'ANTHROPIC_API_KEY'
+ )
+ ).toBe(true);
+ expect(ideSettings['claudeCode.disableLoginPrompt']).toBe(true);
+ });
+
+ it('resets only managed keys and preserves unrelated shared + IDE settings', async () => {
+ const ideSettingsPath = path.join(tempHome, 'ide', 'cursor', 'settings.json');
+ fs.mkdirSync(path.dirname(ideSettingsPath), { recursive: true });
+ fs.mkdirSync(path.join(tempHome, '.claude'), { recursive: true });
+
+ fs.writeFileSync(
+ path.join(tempHome, '.claude', 'settings.json'),
+ JSON.stringify(
+ {
+ theme: 'dark',
+ env: {
+ KEEP_ME: '1',
+ ANTHROPIC_API_KEY: 'stale',
+ },
+ },
+ null,
+ 2
+ ) + '\n'
+ );
+ fs.writeFileSync(
+ ideSettingsPath,
+ JSON.stringify(
+ {
+ 'editor.fontSize': 14,
+ 'claudeCode.environmentVariables': [{ name: 'ANTHROPIC_API_KEY', value: 'stale' }],
+ 'claudeCode.disableLoginPrompt': true,
+ },
+ null,
+ 2
+ ) + '\n'
+ );
+
+ const createResponse = await fetch(`${baseUrl}/api/claude-extension/bindings`, {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({
+ name: 'Cursor reset',
+ profile: 'glm',
+ host: 'cursor',
+ ideSettingsPath,
+ }),
+ });
+ const created = (await createResponse.json()) as { binding: { id: string } };
+
+ const resetResponse = await fetch(
+ `${baseUrl}/api/claude-extension/bindings/${created.binding.id}/reset`,
+ {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({ target: 'all' }),
+ }
+ );
+ expect(resetResponse.status).toBe(200);
+
+ const resetPayload = (await resetResponse.json()) as {
+ sharedSettings: { state: string };
+ ideSettings: { state: string };
+ };
+ expect(resetPayload.sharedSettings.state).toBe('unconfigured');
+ expect(resetPayload.ideSettings.state).toBe('unconfigured');
+
+ const sharedSettings = JSON.parse(
+ fs.readFileSync(path.join(tempHome, '.claude', 'settings.json'), 'utf8')
+ ) as {
+ theme?: string;
+ env?: Record;
+ };
+ const ideSettings = JSON.parse(fs.readFileSync(ideSettingsPath, 'utf8')) as Record<
+ string,
+ unknown
+ >;
+
+ expect(sharedSettings.theme).toBe('dark');
+ expect(sharedSettings.env?.KEEP_ME).toBe('1');
+ expect(sharedSettings.env?.ANTHROPIC_API_KEY).toBeUndefined();
+ expect(ideSettings['editor.fontSize']).toBe(14);
+ expect(ideSettings['claudeCode.environmentVariables']).toBeUndefined();
+ expect(ideSettings['claudeCode.disableLoginPrompt']).toBeUndefined();
+ });
+
+ it('removes optional shared env keys even after the profile payload shrinks', async () => {
+ const ideSettingsPath = path.join(tempHome, 'ide', 'vscode', 'settings.json');
+ const createResponse = await fetch(`${baseUrl}/api/claude-extension/bindings`, {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({
+ name: 'Rich env binding',
+ profile: 'rich',
+ host: 'vscode',
+ ideSettingsPath,
+ }),
+ });
+ const created = (await createResponse.json()) as { binding: { id: string } };
+
+ const applyResponse = await fetch(
+ `${baseUrl}/api/claude-extension/bindings/${created.binding.id}/apply`,
+ {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({ target: 'shared' }),
+ }
+ );
+ expect(applyResponse.status).toBe(200);
+
+ const sharedSettingsPath = path.join(tempHome, '.claude', 'settings.json');
+ let sharedSettings = JSON.parse(fs.readFileSync(sharedSettingsPath, 'utf8')) as {
+ env?: Record;
+ };
+
+ expect(sharedSettings.env?.ANTHROPIC_API_KEY).toBe('sk-ant-rich-123456');
+ expect(sharedSettings.env?.ANTHROPIC_MAX_TOKENS).toBe('65536');
+ expect(sharedSettings.env?.API_TIMEOUT_MS).toBe('120000');
+ expect(sharedSettings.env?.EXPERIMENTAL_ROUTER_HEADER).toBe('tenant-alpha');
+
+ fs.writeFileSync(
+ path.join(tempHome, '.ccs', 'rich.settings.json'),
+ JSON.stringify(
+ {
+ env: {
+ ANTHROPIC_BASE_URL: 'https://rich.example.test',
+ ANTHROPIC_API_KEY: 'sk-ant-rich-123456',
+ ANTHROPIC_MODEL: 'claude-opus-4-1',
+ },
+ },
+ null,
+ 2
+ ) + '\n'
+ );
+
+ const resetResponse = await fetch(
+ `${baseUrl}/api/claude-extension/bindings/${created.binding.id}/reset`,
+ {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({ target: 'shared' }),
+ }
+ );
+ expect(resetResponse.status).toBe(200);
+
+ const verifyResponse = await fetch(
+ `${baseUrl}/api/claude-extension/bindings/${created.binding.id}/verify`
+ );
+ expect(verifyResponse.status).toBe(200);
+
+ const verified = (await verifyResponse.json()) as {
+ sharedSettings: { state: string };
+ };
+ expect(verified.sharedSettings.state).toBe('unconfigured');
+
+ sharedSettings = JSON.parse(fs.readFileSync(sharedSettingsPath, 'utf8')) as {
+ env?: Record;
+ };
+ expect(sharedSettings.env?.ANTHROPIC_API_KEY).toBeUndefined();
+ expect(sharedSettings.env?.ANTHROPIC_MAX_TOKENS).toBeUndefined();
+ expect(sharedSettings.env?.API_TIMEOUT_MS).toBeUndefined();
+ expect(sharedSettings.env?.EXPERIMENTAL_ROUTER_HEADER).toBeUndefined();
+ });
+
+ it('preserves unrelated IDE env entries while applying and resetting managed values', async () => {
+ const ideSettingsPath = path.join(tempHome, 'ide', 'vscode', 'settings.json');
+ fs.mkdirSync(path.dirname(ideSettingsPath), { recursive: true });
+ fs.writeFileSync(
+ ideSettingsPath,
+ `{
+ // VS Code stores JSONC here, not strict JSON
+ "editor.tabSize": 2,
+ "claudeCode.environmentVariables": [
+ { "name": "KEEP_ME", "value": "1" },
+ { "name": "ANTHROPIC_API_KEY", "value": "stale" },
+ ],
+ "claudeCode.disableLoginPrompt": false,
+}
+`
+ );
+
+ const createResponse = await fetch(`${baseUrl}/api/claude-extension/bindings`, {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({
+ name: 'VS Code preserved env',
+ profile: 'glm',
+ host: 'vscode',
+ ideSettingsPath,
+ }),
+ });
+ const created = (await createResponse.json()) as { binding: { id: string } };
+
+ const applyResponse = await fetch(
+ `${baseUrl}/api/claude-extension/bindings/${created.binding.id}/apply`,
+ {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({ target: 'ide' }),
+ }
+ );
+ expect(applyResponse.status).toBe(200);
+
+ let ideSettings = JSON.parse(fs.readFileSync(ideSettingsPath, 'utf8')) as Record;
+ const appliedEnv = ideSettings['claudeCode.environmentVariables'] as Array<{
+ name: string;
+ value: string;
+ }>;
+
+ expect(appliedEnv.some((entry) => entry.name === 'KEEP_ME' && entry.value === '1')).toBe(true);
+ expect(
+ appliedEnv.some((entry) => entry.name === 'ANTHROPIC_API_KEY' && entry.value === 'sk-ant-test-123456')
+ ).toBe(true);
+
+ const verifyAppliedResponse = await fetch(
+ `${baseUrl}/api/claude-extension/bindings/${created.binding.id}/verify`
+ );
+ expect(verifyAppliedResponse.status).toBe(200);
+
+ const verifiedApplied = (await verifyAppliedResponse.json()) as {
+ ideSettings: { state: string };
+ };
+ expect(verifiedApplied.ideSettings.state).toBe('applied');
+
+ const resetResponse = await fetch(
+ `${baseUrl}/api/claude-extension/bindings/${created.binding.id}/reset`,
+ {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({ target: 'ide' }),
+ }
+ );
+ expect(resetResponse.status).toBe(200);
+
+ ideSettings = JSON.parse(fs.readFileSync(ideSettingsPath, 'utf8')) as Record;
+ expect(ideSettings['editor.tabSize']).toBe(2);
+ expect(ideSettings['claudeCode.disableLoginPrompt']).toBeUndefined();
+ expect(ideSettings['claudeCode.environmentVariables']).toEqual([{ name: 'KEEP_ME', value: '1' }]);
+
+ const verifyResetResponse = await fetch(
+ `${baseUrl}/api/claude-extension/bindings/${created.binding.id}/verify`
+ );
+ expect(verifyResetResponse.status).toBe(200);
+
+ const verifiedReset = (await verifyResetResponse.json()) as {
+ ideSettings: { state: string };
+ };
+ expect(verifiedReset.ideSettings.state).toBe('unconfigured');
+ });
+
+ it('rejects bindings for profiles that do not exist', async () => {
+ const response = await fetch(`${baseUrl}/api/claude-extension/bindings`, {
+ method: 'POST',
+ headers: { 'Content-Type': 'application/json' },
+ body: JSON.stringify({
+ name: 'Broken profile binding',
+ profile: 'does-not-exist',
+ host: 'vscode',
+ }),
+ });
+
+ expect(response.status).toBe(400);
+ const payload = (await response.json()) as { error: string };
+ expect(payload.error).toContain('Unknown profile');
+ });
+});
diff --git a/tests/unit/web-server/copilot-routes.test.ts b/tests/unit/web-server/copilot-routes.test.ts
new file mode 100644
index 00000000..897f4476
--- /dev/null
+++ b/tests/unit/web-server/copilot-routes.test.ts
@@ -0,0 +1,311 @@
+import { afterAll, beforeAll, beforeEach, describe, expect, it } from 'bun:test';
+import express from 'express';
+import * as fs from 'fs';
+import * as os from 'os';
+import * as path from 'path';
+import type { Server } from 'http';
+import { normalizeCopilotConfig } from '../../../src/copilot/copilot-model-normalizer';
+import { DEFAULT_COPILOT_CONFIG } from '../../../src/config/unified-config-types';
+
+let server: Server;
+let baseUrl = '';
+let tempDir = '';
+let originalCcsHome: string | undefined;
+
+let setGlobalConfigDir: (dir: string | undefined) => void;
+let getCcsDir: () => string;
+let loadOrCreateUnifiedConfig: () => {
+ copilot?: {
+ enabled?: boolean;
+ auto_start?: boolean;
+ port?: number;
+ account_type?: 'individual' | 'business' | 'enterprise';
+ rate_limit?: number | null;
+ wait_on_limit?: boolean;
+ model?: string;
+ opus_model?: string;
+ sonnet_model?: string;
+ haiku_model?: string;
+ };
+};
+let saveUnifiedConfig: (config: {
+ copilot?: {
+ enabled?: boolean;
+ auto_start?: boolean;
+ port?: number;
+ account_type?: 'individual' | 'business' | 'enterprise';
+ rate_limit?: number | null;
+ wait_on_limit?: boolean;
+ model?: string;
+ opus_model?: string;
+ sonnet_model?: string;
+ haiku_model?: string;
+ };
+}) => void;
+
+function seedCopilotConfig(
+ overrides: {
+ enabled?: boolean;
+ auto_start?: boolean;
+ port?: number;
+ account_type?: 'individual' | 'business' | 'enterprise';
+ rate_limit?: number | null;
+ wait_on_limit?: boolean;
+ model?: string;
+ opus_model?: string;
+ sonnet_model?: string;
+ haiku_model?: string;
+ } = {}
+): void {
+ const config = loadOrCreateUnifiedConfig();
+ config.copilot = {
+ enabled: overrides.enabled ?? true,
+ auto_start: overrides.auto_start ?? false,
+ port: overrides.port ?? 4141,
+ account_type: overrides.account_type ?? 'individual',
+ rate_limit: overrides.rate_limit ?? null,
+ wait_on_limit: overrides.wait_on_limit ?? true,
+ model: overrides.model ?? 'gpt-4.1',
+ opus_model: overrides.opus_model,
+ sonnet_model: overrides.sonnet_model,
+ haiku_model: overrides.haiku_model,
+ };
+ saveUnifiedConfig(config);
+}
+
+function getCopilotSettingsPath(): string {
+ return path.join(getCcsDir(), 'copilot.settings.json');
+}
+
+function writeCopilotSettings(settings: Record): void {
+ fs.writeFileSync(getCopilotSettingsPath(), JSON.stringify(settings, null, 2) + '\n');
+}
+
+beforeAll(async () => {
+ originalCcsHome = process.env.CCS_HOME;
+ tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'ccs-copilot-routes-test-'));
+ process.env.CCS_HOME = tempDir;
+
+ const configManager = await import('../../../src/utils/config-manager');
+ setGlobalConfigDir = configManager.setGlobalConfigDir;
+ getCcsDir = configManager.getCcsDir;
+ setGlobalConfigDir(undefined);
+
+ const unifiedConfig = await import('../../../src/config/unified-config-loader');
+ loadOrCreateUnifiedConfig = unifiedConfig.loadOrCreateUnifiedConfig;
+ saveUnifiedConfig = unifiedConfig.saveUnifiedConfig;
+
+ const copilotRoutesModule = await import('../../../src/web-server/routes/copilot-routes');
+
+ const app = express();
+ app.use(express.json());
+ app.use('/api/copilot', copilotRoutesModule.default);
+
+ server = app.listen(0, '127.0.0.1');
+ await new Promise((resolve) => server.on('listening', () => resolve()));
+ const address = server.address();
+ if (!address || typeof address === 'string') {
+ throw new Error('Unable to resolve test server port');
+ }
+ baseUrl = `http://127.0.0.1:${address.port}`;
+});
+
+beforeEach(() => {
+ fs.rmSync(tempDir, { recursive: true, force: true });
+ fs.mkdirSync(tempDir, { recursive: true });
+
+ setGlobalConfigDir(undefined);
+ const ccsDir = getCcsDir();
+ if (!fs.existsSync(ccsDir)) {
+ fs.mkdirSync(ccsDir, { recursive: true });
+ }
+
+ seedCopilotConfig();
+});
+
+afterAll(async () => {
+ if (server) {
+ await new Promise((resolve) => server.close(() => resolve()));
+ }
+
+ if (originalCcsHome !== undefined) {
+ process.env.CCS_HOME = originalCcsHome;
+ } else {
+ delete process.env.CCS_HOME;
+ }
+ setGlobalConfigDir(undefined);
+
+ if (tempDir && fs.existsSync(tempDir)) {
+ fs.rmSync(tempDir, { recursive: true, force: true });
+ }
+});
+
+describe('Copilot Routes', () => {
+ it('GET /api/copilot/config returns normalized values and warnings without persisting', async () => {
+ seedCopilotConfig({
+ model: 'claude-sonnet-4.5',
+ haiku_model: 'raptor-mini',
+ });
+
+ const response = await fetch(`${baseUrl}/api/copilot/config`);
+ expect(response.status).toBe(200);
+
+ const body = (await response.json()) as {
+ model: string;
+ warnings?: Array<{ tier: string; message: string }>;
+ opus_model?: string;
+ sonnet_model?: string;
+ haiku_model?: string;
+ };
+ expect(body.model).toBe('claude-sonnet-4.5');
+ expect(body.haiku_model).toBeUndefined();
+ expect(body.warnings ?? []).toHaveLength(0);
+
+ const persisted = loadOrCreateUnifiedConfig().copilot;
+ expect(persisted?.model).toBe('claude-sonnet-4.5');
+ expect(persisted?.haiku_model).toBeUndefined();
+ });
+
+ it('PUT /api/copilot/config normalizes deprecated overrides before save', async () => {
+ const response = await fetch(`${baseUrl}/api/copilot/config`, {
+ method: 'PUT',
+ headers: { 'content-type': 'application/json' },
+ body: JSON.stringify({
+ model: 'claude-sonnet-4.5',
+ haiku_model: 'raptor-mini',
+ }),
+ });
+ expect(response.status).toBe(200);
+
+ const body = (await response.json()) as {
+ success: boolean;
+ warnings?: Array<{ tier: string; replacement: string }>;
+ copilot: {
+ model: string;
+ opus_model?: string;
+ sonnet_model?: string;
+ haiku_model?: string;
+ };
+ };
+ expect(body.success).toBe(true);
+ expect(body.copilot.model).toBe('claude-sonnet-4.5');
+ expect(body.copilot.haiku_model).toBe('claude-sonnet-4.5');
+ expect(body.warnings?.[0]?.tier).toBe('haiku');
+ expect(body.warnings?.[0]?.replacement).toBe('claude-sonnet-4.5');
+
+ const persisted = loadOrCreateUnifiedConfig().copilot;
+ expect(persisted?.model).toBe('claude-sonnet-4.5');
+ expect(
+ normalizeCopilotConfig(persisted ?? { ...DEFAULT_COPILOT_CONFIG }).haiku_model
+ ).toBeUndefined();
+ expect(persisted?.haiku_model).not.toBe('raptor-mini');
+ });
+
+ it('GET /api/copilot/settings/raw keeps stored JSON untouched and returns effective warnings', async () => {
+ seedCopilotConfig({ model: 'claude-sonnet-4.5' });
+ writeCopilotSettings({
+ env: {
+ ANTHROPIC_BASE_URL: 'http://127.0.0.1:4141',
+ ANTHROPIC_AUTH_TOKEN: 'copilot-managed',
+ ANTHROPIC_DEFAULT_HAIKU_MODEL: 'raptor-mini',
+ ANTHROPIC_SMALL_FAST_MODEL: 'raptor-mini',
+ },
+ });
+ const beforeContent = fs.readFileSync(getCopilotSettingsPath(), 'utf-8');
+
+ const response = await fetch(`${baseUrl}/api/copilot/settings/raw`);
+ expect(response.status).toBe(200);
+
+ const body = (await response.json()) as {
+ settings: {
+ env: Record;
+ };
+ effectiveSettings: {
+ env: Record;
+ };
+ exists: boolean;
+ warnings?: Array<{ tier: string }>;
+ };
+ expect(body.exists).toBe(true);
+ expect(body.settings.env.ANTHROPIC_DEFAULT_HAIKU_MODEL).toBe('raptor-mini');
+ expect(body.settings.env.ANTHROPIC_SMALL_FAST_MODEL).toBe('raptor-mini');
+ expect(body.effectiveSettings.env.ANTHROPIC_DEFAULT_HAIKU_MODEL).toBe('claude-sonnet-4.5');
+ expect(body.effectiveSettings.env.ANTHROPIC_SMALL_FAST_MODEL).toBe('claude-sonnet-4.5');
+ expect(body.warnings?.map((warning) => warning.tier)).toEqual(['haiku']);
+
+ expect(fs.readFileSync(getCopilotSettingsPath(), 'utf-8')).toBe(beforeContent);
+ expect(loadOrCreateUnifiedConfig().copilot?.model).toBe('claude-sonnet-4.5');
+ });
+
+ it('PUT /api/copilot/settings/raw normalizes stale models before save and syncs unified config', async () => {
+ const response = await fetch(`${baseUrl}/api/copilot/settings/raw`, {
+ method: 'PUT',
+ headers: { 'content-type': 'application/json' },
+ body: JSON.stringify({
+ settings: {
+ env: {
+ ANTHROPIC_BASE_URL: 'http://127.0.0.1:4141',
+ ANTHROPIC_AUTH_TOKEN: 'copilot-managed',
+ ANTHROPIC_MODEL: 'claude-sonnet-4.5',
+ ANTHROPIC_SMALL_FAST_MODEL: 'raptor-mini',
+ },
+ },
+ }),
+ });
+ expect(response.status).toBe(200);
+
+ const body = (await response.json()) as {
+ success: boolean;
+ warnings?: Array<{ tier: string; replacement: string }>;
+ };
+ expect(body.success).toBe(true);
+ expect(body.warnings?.[0]?.tier).toBe('haiku');
+ expect(body.warnings?.[0]?.replacement).toBe('claude-sonnet-4.5');
+
+ const persistedSettings = JSON.parse(fs.readFileSync(getCopilotSettingsPath(), 'utf-8')) as {
+ env: Record;
+ };
+ expect(persistedSettings.env.ANTHROPIC_MODEL).toBe('claude-sonnet-4.5');
+ expect(persistedSettings.env.ANTHROPIC_DEFAULT_HAIKU_MODEL).toBe('claude-sonnet-4.5');
+ expect(persistedSettings.env.ANTHROPIC_SMALL_FAST_MODEL).toBe('claude-sonnet-4.5');
+
+ const persistedConfig = loadOrCreateUnifiedConfig().copilot;
+ expect(persistedConfig?.model).toBe('claude-sonnet-4.5');
+ expect(
+ normalizeCopilotConfig(persistedConfig ?? { ...DEFAULT_COPILOT_CONFIG }).haiku_model
+ ).toBeUndefined();
+ expect(persistedConfig?.haiku_model).not.toBe('raptor-mini');
+ });
+
+ it('PUT /api/copilot/settings/raw rejects non-object settings payloads', async () => {
+ const response = await fetch(`${baseUrl}/api/copilot/settings/raw`, {
+ method: 'PUT',
+ headers: { 'content-type': 'application/json' },
+ body: JSON.stringify({
+ settings: ['invalid'],
+ }),
+ });
+
+ expect(response.status).toBe(400);
+ const body = (await response.json()) as { error: string };
+ expect(body.error).toBe('settings must be a JSON object');
+ });
+
+ it('GET /api/copilot/models reports normalized current model without persisting', async () => {
+ seedCopilotConfig({ model: 'raptor-mini' });
+
+ const response = await fetch(`${baseUrl}/api/copilot/models`);
+ expect(response.status).toBe(200);
+
+ const body = (await response.json()) as {
+ current: string;
+ warnings?: Array<{ tier: string }>;
+ models: Array<{ id: string; isCurrent?: boolean }>;
+ };
+
+ expect(body.current).toBe('gpt-4.1');
+ expect(body.models.some((model) => model.id === 'gpt-4.1' && model.isCurrent)).toBe(true);
+ expect(body.warnings?.map((warning) => warning.tier)).toEqual(['default']);
+ expect(loadOrCreateUnifiedConfig().copilot?.model).toBe('raptor-mini');
+ });
+});
diff --git a/ui/src/App.tsx b/ui/src/App.tsx
index 7b70e49b..31b3f343 100644
--- a/ui/src/App.tsx
+++ b/ui/src/App.tsx
@@ -28,6 +28,9 @@ const CliproxyControlPanelPage = lazy(() =>
);
const CopilotPage = lazy(() => import('@/pages/copilot').then((m) => ({ default: m.CopilotPage })));
const CursorPage = lazy(() => import('@/pages/cursor').then((m) => ({ default: m.CursorPage })));
+const ClaudeExtensionPage = lazy(() =>
+ import('@/pages/claude-extension').then((m) => ({ default: m.ClaudeExtensionPage }))
+);
const DroidPage = lazy(() => import('@/pages/droid').then((m) => ({ default: m.DroidPage })));
const AccountsPage = lazy(() =>
import('@/pages/accounts').then((m) => ({ default: m.AccountsPage }))
@@ -119,6 +122,14 @@ export default function App() {
}
/>
+ }>
+
+
+ }
+ />
0 && (
- {legacyTargetCount} legacy account
- {legacyTargetCount > 1 ? 's still need' : ' still needs'} explicit confirmation.
+ {t('historySyncLearningMap.legacyConfirmation', { count: legacyTargetCount })}
)}
diff --git a/ui/src/components/copilot/config-form/index.tsx b/ui/src/components/copilot/config-form/index.tsx
index 059477ed..0acec851 100644
--- a/ui/src/components/copilot/config-form/index.tsx
+++ b/ui/src/components/copilot/config-form/index.tsx
@@ -9,8 +9,9 @@
/* eslint-disable react-refresh/only-export-components */
import { Skeleton } from '@/components/ui/skeleton';
+import { Alert, AlertDescription, AlertTitle } from '@/components/ui/alert';
import { Tabs, TabsList, TabsTrigger } from '@/components/ui/tabs';
-import { Code2 } from 'lucide-react';
+import { AlertTriangle, Code2 } from 'lucide-react';
import { ConfirmDialog } from '@/components/shared/confirm-dialog';
import { HeaderSection } from './header-section';
@@ -43,6 +44,7 @@ export function CopilotConfigForm() {
haikuModel,
isRawJsonValid,
hasChanges,
+ normalizationWarnings,
conflictDialog,
updateField,
applyPreset,
@@ -77,6 +79,26 @@ export function CopilotConfigForm() {
onSave={handleSave}
/>
+ {normalizationWarnings.length > 0 && (
+
+
+
+ Deprecated Copilot models detected
+
+
+ Loading this page did not rewrite your files. Save the Copilot configuration to
+ persist these replacements.
+
+
+ {normalizationWarnings.map((warning) => (
+
{warning.message}
+ ))}
+
+
{/* Left Column: Friendly UI */}
diff --git a/ui/src/components/copilot/config-form/presets.ts b/ui/src/components/copilot/config-form/presets.ts
index e7aad884..f882f932 100644
--- a/ui/src/components/copilot/config-form/presets.ts
+++ b/ui/src/components/copilot/config-form/presets.ts
@@ -23,14 +23,6 @@ export const FREE_PRESETS: ModelPreset[] = [
sonnet: 'gpt-5-mini',
haiku: 'gpt-5-mini',
},
- {
- name: 'Raptor Mini (Free)',
- description: 'Free tier - fine-tuned for coding',
- default: 'raptor-mini',
- opus: 'raptor-mini',
- sonnet: 'raptor-mini',
- haiku: 'raptor-mini',
- },
];
export const PAID_PRESETS: ModelPreset[] = [
diff --git a/ui/src/components/copilot/config-form/use-copilot-config-form.ts b/ui/src/components/copilot/config-form/use-copilot-config-form.ts
index 461c5688..32b5ccfd 100644
--- a/ui/src/components/copilot/config-form/use-copilot-config-form.ts
+++ b/ui/src/components/copilot/config-form/use-copilot-config-form.ts
@@ -5,6 +5,7 @@
import { useState, useMemo, useCallback } from 'react';
import { useCopilot } from '@/hooks/use-copilot';
+import type { CopilotNormalizationWarning } from '@/hooks/use-copilot';
import { isApiConflictError } from '@/lib/api-client';
import { toast } from 'sonner';
import type { ModelPreset } from './types';
@@ -18,6 +19,17 @@ function checkMissingFields(settings: { env?: Record } | undefin
return REQUIRED_ENV_KEYS.filter((key) => !env[key]?.trim());
}
+function dedupeWarnings(
+ warnings: CopilotNormalizationWarning[] | undefined
+): CopilotNormalizationWarning[] {
+ if (!warnings || warnings.length === 0) return [];
+ const unique = new Map();
+ warnings.forEach((warning) => {
+ unique.set(warning.message, warning);
+ });
+ return [...unique.values()];
+}
+
export function useCopilotConfigForm() {
const {
config,
@@ -128,11 +140,20 @@ export function useCopilotConfigForm() {
[currentSettingsForValidation]
);
- const handleSave = async () => {
+ const normalizationWarnings = useMemo(
+ () => dedupeWarnings([...(config?.warnings ?? []), ...(rawSettings?.warnings ?? [])]),
+ [config?.warnings, rawSettings?.warnings]
+ );
+
+ const handleSave = async ({
+ overwriteRawSettings = false,
+ }: { overwriteRawSettings?: boolean } = {}) => {
try {
+ const saveWarnings: CopilotNormalizationWarning[] = [];
+
// Save config changes
if (Object.keys(localOverrides).length > 0) {
- await updateConfigAsync({
+ const configResult = await updateConfigAsync({
enabled,
auto_start: autoStart,
port,
@@ -144,26 +165,39 @@ export function useCopilotConfigForm() {
sonnet_model: sonnetModel || undefined,
haiku_model: haikuModel || undefined,
});
+ saveWarnings.push(...(configResult.warnings ?? []));
}
// Save raw JSON changes (no blocking validation - runtime uses defaults)
+ let missing: string[] = [];
if (rawJsonEdits !== null && isRawJsonValid) {
const settingsToSave = JSON.parse(rawJsonContent);
- const missing = checkMissingFields(settingsToSave);
+ missing = checkMissingFields(settingsToSave);
- await saveRawSettingsAsync({
+ const saveResult = await saveRawSettingsAsync({
settings: settingsToSave,
- expectedMtime: rawSettings?.mtime,
+ expectedMtime: overwriteRawSettings ? undefined : rawSettings?.mtime,
});
+ saveWarnings.push(...(saveResult.warnings ?? []));
+ }
- // Show warning if fields missing
- if (missing.length > 0) {
- toast.success('Copilot configuration saved', {
- description: `Missing fields will use defaults: ${missing.join(', ')}`,
- });
- } else {
- toast.success('Copilot configuration saved');
- }
+ const uniqueWarnings = dedupeWarnings(saveWarnings);
+ const descriptions: string[] = [];
+ if (uniqueWarnings.length > 0) {
+ descriptions.push(uniqueWarnings.map((warning) => warning.message).join(' '));
+ }
+ if (missing.length > 0) {
+ descriptions.push(`Missing fields will use defaults: ${missing.join(', ')}`);
+ }
+
+ if (uniqueWarnings.length > 0) {
+ toast.warning('Copilot configuration saved with model adjustments', {
+ description: descriptions.join(' '),
+ });
+ } else if (descriptions.length > 0) {
+ toast.success('Copilot configuration saved', {
+ description: descriptions.join(' '),
+ });
} else {
toast.success('Copilot configuration saved');
}
@@ -183,8 +217,7 @@ export function useCopilotConfigForm() {
const handleConflictResolve = async (overwrite: boolean) => {
setConflictDialog(false);
if (overwrite) {
- await refetchRawSettings();
- handleSave();
+ await handleSave({ overwriteRawSettings: true });
} else {
setRawJsonEdits(null);
}
@@ -217,6 +250,7 @@ export function useCopilotConfigForm() {
haikuModel,
isRawJsonValid,
hasChanges,
+ normalizationWarnings,
// Dialog state
conflictDialog,
diff --git a/ui/src/components/layout/app-sidebar.tsx b/ui/src/components/layout/app-sidebar.tsx
index 91ee0c12..a393ba06 100644
--- a/ui/src/components/layout/app-sidebar.tsx
+++ b/ui/src/components/layout/app-sidebar.tsx
@@ -11,6 +11,7 @@ import {
BarChart3,
Gauge,
Github,
+ Puzzle,
TerminalSquare,
} from 'lucide-react';
import type { LucideIcon } from 'lucide-react';
@@ -115,7 +116,10 @@ function buildNavGroups(t: (key: string) => string): SidebarGroupDef[] {
},
{
title: t('nav.compatibleClis'),
- items: [{ path: '/droid', icon: TerminalSquare, label: t('nav.factoryDroid') }],
+ items: [
+ { path: '/claude-extension', icon: Puzzle, label: t('nav.claudeExtension') },
+ { path: '/droid', icon: TerminalSquare, label: t('nav.factoryDroid') },
+ ],
},
{
title: t('nav.system'),
diff --git a/ui/src/hooks/use-claude-extension.ts b/ui/src/hooks/use-claude-extension.ts
new file mode 100644
index 00000000..058e2e0b
--- /dev/null
+++ b/ui/src/hooks/use-claude-extension.ts
@@ -0,0 +1,224 @@
+import { useMutation, useQuery, useQueryClient } from '@tanstack/react-query';
+import { toast } from 'sonner';
+import { withApiBase } from '@/lib/api-client';
+
+export interface ClaudeExtensionProfileOption {
+ name: string;
+ profileType: string;
+ label: string;
+ description: string;
+}
+
+export interface ClaudeExtensionHostOption {
+ id: 'vscode' | 'cursor' | 'windsurf';
+ label: string;
+ settingsKey: string;
+ disableLoginPromptKey?: string;
+ settingsTargetLabel: string;
+ description: string;
+ defaultSettingsPath: string;
+}
+
+export interface ClaudeExtensionSetupPayload {
+ profile: {
+ requestedProfile: string;
+ resolvedProfileName: string;
+ profileType: string;
+ label: string;
+ description: string;
+ };
+ host: ClaudeExtensionHostOption;
+ env: Array<{ name: string; value: string }>;
+ warnings: string[];
+ notes: string[];
+ removeEnvKeys: string[];
+ sharedSettings: {
+ path: string;
+ command: string;
+ json: string;
+ };
+ ideSettings: {
+ path: string;
+ targetLabel: string;
+ json: string;
+ };
+}
+
+export interface ClaudeExtensionBinding {
+ id: string;
+ name: string;
+ profile: string;
+ host: ClaudeExtensionHostOption['id'];
+ ideSettingsPath?: string;
+ effectiveIdeSettingsPath: string;
+ usesDefaultIdeSettingsPath: boolean;
+ notes?: string;
+ createdAt: string;
+ updatedAt: string;
+}
+
+export interface ClaudeExtensionBindingInput {
+ name: string;
+ profile: string;
+ host: ClaudeExtensionHostOption['id'];
+ ideSettingsPath?: string;
+ notes?: string;
+}
+
+export type ClaudeExtensionActionTarget = 'shared' | 'ide' | 'all';
+export type ClaudeExtensionFileState = 'applied' | 'drifted' | 'missing' | 'unconfigured';
+
+export interface ClaudeExtensionTargetStatus {
+ target: 'shared' | 'ide';
+ path: string;
+ exists: boolean;
+ mtime: number | null;
+ state: ClaudeExtensionFileState;
+ message: string;
+}
+
+export interface ClaudeExtensionBindingStatus {
+ binding: ClaudeExtensionBinding;
+ bindingId: string;
+ sharedSettings: ClaudeExtensionTargetStatus;
+ ideSettings: ClaudeExtensionTargetStatus;
+}
+
+const bindingsQueryKey = ['claude-extension-bindings'] as const;
+
+async function requestJson(url: string, options?: RequestInit): Promise {
+ const res = await fetch(withApiBase(url), {
+ headers: { 'Content-Type': 'application/json' },
+ ...options,
+ });
+ if (!res.ok) {
+ const payload = (await res.json().catch(() => null)) as { error?: string } | null;
+ throw new Error(payload?.error || `Request failed (${res.status})`);
+ }
+ return res.status === 204 ? (undefined as T) : ((await res.json()) as T);
+}
+
+export function useClaudeExtensionOptions() {
+ return useQuery({
+ queryKey: ['claude-extension-options'],
+ queryFn: () =>
+ requestJson<{ profiles: ClaudeExtensionProfileOption[]; hosts: ClaudeExtensionHostOption[] }>(
+ '/claude-extension/profiles'
+ ),
+ });
+}
+
+export function useClaudeExtensionSetup(profile?: string, host: string = 'vscode') {
+ return useQuery({
+ queryKey: ['claude-extension-setup', profile, host],
+ enabled: Boolean(profile),
+ queryFn: () =>
+ requestJson(
+ `/claude-extension/setup?profile=${encodeURIComponent(profile || '')}&host=${encodeURIComponent(host)}`
+ ),
+ });
+}
+
+export function useClaudeExtensionBindings() {
+ return useQuery({
+ queryKey: bindingsQueryKey,
+ queryFn: () =>
+ requestJson<{ bindings: ClaudeExtensionBinding[] }>('/claude-extension/bindings'),
+ });
+}
+
+export function useClaudeExtensionBindingStatus(bindingId?: string) {
+ return useQuery({
+ queryKey: ['claude-extension-binding-status', bindingId],
+ enabled: Boolean(bindingId),
+ queryFn: () =>
+ requestJson(
+ `/claude-extension/bindings/${encodeURIComponent(bindingId || '')}/verify`
+ ),
+ });
+}
+
+export function useCreateClaudeExtensionBinding() {
+ const queryClient = useQueryClient();
+
+ return useMutation({
+ mutationFn: (binding: ClaudeExtensionBindingInput) =>
+ requestJson<{ binding: ClaudeExtensionBinding }>('/claude-extension/bindings', {
+ method: 'POST',
+ body: JSON.stringify(binding),
+ }),
+ onSuccess: () => {
+ queryClient.invalidateQueries({ queryKey: bindingsQueryKey });
+ toast.success('Binding created');
+ },
+ onError: (error: Error) => toast.error(error.message),
+ });
+}
+
+export function useUpdateClaudeExtensionBinding() {
+ const queryClient = useQueryClient();
+
+ return useMutation({
+ mutationFn: ({ id, binding }: { id: string; binding: ClaudeExtensionBindingInput }) =>
+ requestJson<{ binding: ClaudeExtensionBinding }>(
+ `/claude-extension/bindings/${encodeURIComponent(id)}`,
+ {
+ method: 'PUT',
+ body: JSON.stringify(binding),
+ }
+ ),
+ onSuccess: (_result, variables) => {
+ queryClient.invalidateQueries({ queryKey: bindingsQueryKey });
+ queryClient.invalidateQueries({
+ queryKey: ['claude-extension-binding-status', variables.id],
+ });
+ toast.success('Binding saved');
+ },
+ onError: (error: Error) => toast.error(error.message),
+ });
+}
+
+export function useDeleteClaudeExtensionBinding() {
+ const queryClient = useQueryClient();
+
+ return useMutation({
+ mutationFn: (id: string) =>
+ requestJson(`/claude-extension/bindings/${encodeURIComponent(id)}`, {
+ method: 'DELETE',
+ }),
+ onSuccess: () => {
+ queryClient.invalidateQueries({ queryKey: bindingsQueryKey });
+ toast.success('Binding deleted');
+ },
+ onError: (error: Error) => toast.error(error.message),
+ });
+}
+
+function useClaudeExtensionActionMutation(action: 'apply' | 'reset', successMessage: string) {
+ const queryClient = useQueryClient();
+
+ return useMutation({
+ mutationFn: ({ id, target }: { id: string; target: ClaudeExtensionActionTarget }) =>
+ requestJson(
+ `/claude-extension/bindings/${encodeURIComponent(id)}/${action}`,
+ {
+ method: 'POST',
+ body: JSON.stringify({ target }),
+ }
+ ),
+ onSuccess: (result) => {
+ queryClient.invalidateQueries({ queryKey: bindingsQueryKey });
+ queryClient.setQueryData(['claude-extension-binding-status', result.bindingId], result);
+ toast.success(successMessage);
+ },
+ onError: (error: Error) => toast.error(error.message),
+ });
+}
+
+export function useApplyClaudeExtensionBinding() {
+ return useClaudeExtensionActionMutation('apply', 'Binding applied');
+}
+
+export function useResetClaudeExtensionBinding() {
+ return useClaudeExtensionActionMutation('reset', 'Managed values removed');
+}
diff --git a/ui/src/hooks/use-copilot.ts b/ui/src/hooks/use-copilot.ts
index 6b497e54..300f6558 100644
--- a/ui/src/hooks/use-copilot.ts
+++ b/ui/src/hooks/use-copilot.ts
@@ -9,6 +9,14 @@ import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
import { ApiConflictError, withApiBase } from '@/lib/api-client';
// Types
+export interface CopilotNormalizationWarning {
+ source: 'config' | 'settings';
+ tier: 'default' | 'opus' | 'sonnet' | 'haiku';
+ original: string;
+ replacement: string;
+ message: string;
+}
+
export interface CopilotStatus {
enabled: boolean;
installed: boolean;
@@ -23,6 +31,10 @@ export interface CopilotStatus {
wait_on_limit: boolean;
}
+export interface CopilotStatusResponse extends CopilotStatus {
+ warnings?: CopilotNormalizationWarning[];
+}
+
export interface CopilotInfo {
installed: boolean;
version: string | null;
@@ -51,6 +63,10 @@ export interface CopilotConfig {
haiku_model?: string;
}
+export interface CopilotConfigResponse extends CopilotConfig {
+ warnings?: CopilotNormalizationWarning[];
+}
+
/** GitHub Copilot plan tiers */
export type CopilotPlanTier = 'free' | 'pro' | 'pro+' | 'business' | 'enterprise';
@@ -80,25 +96,33 @@ export interface CopilotRawSettings {
settings: {
env?: Record;
};
+ effectiveSettings?: {
+ env?: Record;
+ };
mtime: number;
path: string;
exists: boolean;
+ warnings?: CopilotNormalizationWarning[];
}
// API functions
-async function fetchCopilotStatus(): Promise {
+async function fetchCopilotStatus(): Promise {
const res = await fetch(withApiBase('/copilot/status'));
if (!res.ok) throw new Error('Failed to fetch copilot status');
return res.json();
}
-async function fetchCopilotConfig(): Promise {
+async function fetchCopilotConfig(): Promise {
const res = await fetch(withApiBase('/copilot/config'));
if (!res.ok) throw new Error('Failed to fetch copilot config');
return res.json();
}
-async function fetchCopilotModels(): Promise<{ models: CopilotModel[]; current: string }> {
+async function fetchCopilotModels(): Promise<{
+ models: CopilotModel[];
+ current: string;
+ warnings?: CopilotNormalizationWarning[];
+}> {
const res = await fetch(withApiBase('/copilot/models'));
if (!res.ok) throw new Error('Failed to fetch copilot models');
return res.json();
@@ -110,7 +134,11 @@ async function fetchCopilotRawSettings(): Promise {
return res.json();
}
-async function updateCopilotConfig(config: Partial): Promise<{ success: boolean }> {
+async function updateCopilotConfig(config: Partial): Promise<{
+ success: boolean;
+ copilot: CopilotConfig;
+ warnings?: CopilotNormalizationWarning[];
+}> {
const res = await fetch(withApiBase('/copilot/config'), {
method: 'PUT',
headers: { 'Content-Type': 'application/json' },
@@ -123,7 +151,12 @@ async function updateCopilotConfig(config: Partial): Promise<{ su
async function saveCopilotRawSettings(data: {
settings: CopilotRawSettings['settings'];
expectedMtime?: number;
-}): Promise<{ success: boolean; mtime: number }> {
+}): Promise<{
+ success: boolean;
+ mtime: number;
+ settings?: CopilotRawSettings['settings'];
+ warnings?: CopilotNormalizationWarning[];
+}> {
const res = await fetch(withApiBase('/copilot/settings/raw'), {
method: 'PUT',
headers: { 'Content-Type': 'application/json' },
diff --git a/ui/src/lib/i18n.ts b/ui/src/lib/i18n.ts
index d590470e..31f6d592 100644
--- a/ui/src/lib/i18n.ts
+++ b/ui/src/lib/i18n.ts
@@ -9,6 +9,7 @@ const resources = {
en: 'English',
'zh-CN': 'Simplified Chinese',
vi: 'Vietnamese',
+ ja: 'Japanese',
},
layout: {
languageSwitcher: 'Language',
@@ -24,10 +25,11 @@ const resources = {
controlPanel: 'Control Panel',
githubCopilot: 'GitHub Copilot',
cursorIde: 'Cursor IDE',
+ claudeExtension: 'Claude Extension',
accounts: 'Accounts',
allAccounts: 'All Accounts',
sharedData: 'Shared Data',
- compatibleClis: 'Compatible CLIs',
+ compatibleClis: 'Compatible',
factoryDroid: 'Factory Droid',
system: 'System',
health: 'Health',
@@ -417,6 +419,8 @@ const resources = {
historySyncGroup: 'History Sync Group',
historySyncGroupDesc:
'Same group means shared project context lane. Default fallback is default.',
+ legacyConfirmation_one: '{{count}} legacy account still needs explicit confirmation.',
+ legacyConfirmation_other: '{{count}} legacy accounts still need explicit confirmation.',
},
accountsTable: {
name: 'Name',
@@ -1176,6 +1180,7 @@ const resources = {
en: 'English',
'zh-CN': '简体中文',
vi: '越南语',
+ ja: '日语',
},
layout: {
languageSwitcher: '语言',
@@ -1191,10 +1196,11 @@ const resources = {
controlPanel: '控制面板',
githubCopilot: 'GitHub Copilot',
cursorIde: 'Cursor IDE',
+ claudeExtension: 'Claude Extension',
accounts: '账号',
allAccounts: '全部账号',
sharedData: '共享数据',
- compatibleClis: '兼容 CLI',
+ compatibleClis: '兼容',
factoryDroid: 'Factory Droid',
system: '系统',
health: '健康',
@@ -1565,6 +1571,8 @@ const resources = {
modeSwitchDesc: '同步对话框可让用户在隔离/共享间切换并选择更深连续性。',
historySyncGroup: '历史同步分组',
historySyncGroupDesc: '同一分组即共享项目上下文。默认回退为 default。',
+ legacyConfirmation_one: '{{count}} 个旧账号仍需要显式确认。',
+ legacyConfirmation_other: '{{count}} 个旧账号仍需要显式确认。',
},
accountsTable: {
name: '名称',
@@ -1962,6 +1970,7 @@ const resources = {
createProfile: '创建配置',
noProfileMatch: '没有匹配“{{query}}”的配置',
profileCount: '{{count}} 个配置',
+ profileCount_other: '{{count}} 个配置',
configuredCount: '{{count}} 个已配置',
deleteProfileTitle: '删除配置',
deleteProfileDesc: '确定要删除“{{name}}”吗？这会移除设置文件且无法恢复。',
@@ -1982,7 +1991,9 @@ const resources = {
openCliProxyClaudePool: '打开 CLIProxy Claude Pool',
migrationFollowup: '迁移后续处理',
legacyContextPending: '{{count}} 个账号仍需首次模式确认。',
+ legacyContextPending_other: '{{count}} 个账号仍需首次模式确认。',
legacyContinuityPending: '{{count}} 个共享账号仍处于标准旧版连续性深度。',
+ legacyContinuityPending_other: '{{count}} 个共享账号仍处于标准旧版连续性深度。',
confirmingLegacy: '正在确认旧版策略...',
confirmLegacy: '确认旧版策略（{{count}}）',
noLegacyFollowup: '暂无待处理的迁移后续项。',
@@ -2072,6 +2083,7 @@ const resources = {
providers: '提供商',
variants: '变体',
providerCount: '{{count}} 个提供商',
+ providerCount_other: '{{count}} 个提供商',
connectedCount: '{{count}} 个已连接',
variantDisplay: '{{name}}（{{provider}} 变体）',
},
@@ -2298,6 +2310,7 @@ const resources = {
en: 'Tiếng Anh',
'zh-CN': 'Tiếng Trung giản thể',
vi: 'Tiếng Việt',
+ ja: 'Tiếng Nhật',
},
layout: {
languageSwitcher: 'Ngôn ngữ',
@@ -2313,10 +2326,11 @@ const resources = {
controlPanel: 'Bảng điều khiển',
githubCopilot: 'GitHub Copilot',
cursorIde: 'Cursor IDE',
+ claudeExtension: 'Claude Extension',
accounts: 'Tài khoản',
allAccounts: 'Tất cả tài khoản',
sharedData: 'Dữ liệu dùng chung',
- compatibleClis: 'CLI tương thích',
+ compatibleClis: 'Tương thích',
factoryDroid: 'Factory Droid',
system: 'Hệ thống',
health: 'Sức khỏe',
@@ -2712,6 +2726,8 @@ const resources = {
historySyncGroup: 'Nhóm đồng bộ hóa lịch sử',
historySyncGroupDesc:
'Cùng một nhóm nghĩa là chia sẻ cùng bối cảnh project. Nếu để trống sẽ dùng nhóm mặc định.',
+ legacyConfirmation_one: '{{count}} tài khoản cũ vẫn cần xác nhận rõ ràng.',
+ legacyConfirmation_other: '{{count}} tài khoản cũ vẫn cần xác nhận rõ ràng.',
},
accountsTable: {
name: 'Tên',
@@ -3478,6 +3494,1201 @@ const resources = {
},
},
},
+ ja: {
+ translation: {
+ locale: {
+ en: '英語',
+ 'zh-CN': '簡体字中国語',
+ vi: 'ベトナム語',
+ ja: '日本語',
+ },
+ layout: {
+ languageSwitcher: '言語',
+ },
+ nav: {
+ general: '全般',
+ home: 'ホーム',
+ analytics: '分析',
+ identityAccess: '認証とアクセス',
+ apiProfiles: 'API プロファイル',
+ cliproxyPlus: 'CLIProxy Plus',
+ cliproxyOverview: '概要',
+ controlPanel: 'コントロールパネル',
+ githubCopilot: 'GitHub Copilot',
+ cursorIde: 'Cursor IDE',
+ claudeExtension: 'Claude Extension',
+ accounts: 'アカウント',
+ allAccounts: 'すべてのアカウント',
+ sharedData: '共有データ',
+ compatibleClis: '互換',
+ factoryDroid: 'Factory Droid',
+ system: 'システム',
+ health: 'ヘルス',
+ settings: '設定',
+ openrouterTooltip: '注目: OpenRouter + Alibaba Coding Plan + Ollama',
+ },
+ home: {
+ profiles: 'プロファイル',
+ cliproxy: 'CLIProxy',
+ accounts: 'アカウント',
+ health: 'ヘルス',
+ configurationRequired: '設定が必要',
+ },
+ auth: {
+ dashboardTitle: 'CCS Dashboard',
+ loginDescription: 'ダッシュボードにアクセスするには認証情報を入力してください',
+ username: 'ユーザー名',
+ password: 'パスワード',
+ usernamePlaceholder: 'ユーザー名を入力',
+ passwordPlaceholder: 'パスワードを入力',
+ signIn: 'サインイン',
+ signingIn: 'サインイン中...',
+ loginFailed: 'ログインに失敗しました',
+ },
+ commonToast: {
+ apiKeyRequired: 'API キーは必須です',
+ accountAddedPresetFailed:
+ 'アカウントは追加されましたが、デフォルトプリセットの適用に失敗しました',
+ settingsCopied: '設定をクリップボードにコピーしました',
+ enterPresetName: '保存するプリセット名を入力してください',
+ codeCopied: 'コードをクリップボードにコピーしました',
+ copyCodeFailed: 'コードのコピーに失敗しました',
+ appliedModelAllTiers: 'すべてのティアにモデルを適用しました',
+ settingsSaved: '設定を保存しました',
+ defaultTargetUpdated: 'デフォルトターゲットを更新しました',
+ failedUpdateDefaultTarget:
+ 'デフォルトターゲットを {{target}}{{suffix}} に更新できませんでした',
+ },
+ profileDialog: {
+ editTitle: 'プロファイルを編集',
+ createTitle: 'API プロファイルを作成',
+ name: '名前',
+ namePlaceholder: 'my-api',
+ baseUrl: 'ベース URL',
+ baseUrlPlaceholder: 'https://api.example.com',
+ apiKey: 'API キー',
+ defaultModel: 'デフォルトモデル (ANTHROPIC_MODEL)',
+ defaultModelHint: '空欄の場合は {{model}} を使用',
+ modelMappingTitle: 'モデルマッピング (Opus/Sonnet/Haiku)',
+ modelMappingDesc:
+ '各ティアに異なるモデル ID を設定します。異なるモデル種別を別バックエンドへ振り分ける API プロキシで便利です。',
+ opusModel: 'Opus モデル (ANTHROPIC_DEFAULT_OPUS_MODEL)',
+ sonnetModel: 'Sonnet モデル (ANTHROPIC_DEFAULT_SONNET_MODEL)',
+ haikuModel: 'Haiku モデル (ANTHROPIC_DEFAULT_HAIKU_MODEL)',
+ cancel: 'キャンセル',
+ saving: '保存中...',
+ update: '更新',
+ create: '作成',
+ },
+ modelTierMapping: {
+ title: 'モデルティアマッピング',
+ advanced: '詳細',
+ description: 'Claude Code の opus/sonnet/haiku ティアごとに別のモデルを設定します。',
+ autoSuggest: '{{provider}} に基づいて自動提案',
+ opusPlaceholder: '例: anthropic/claude-opus-4',
+ sonnetPlaceholder: '例: anthropic/claude-sonnet-4',
+ haikuPlaceholder: '例: anthropic/claude-3.5-haiku',
+ footer:
+ 'これにより ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL を設定します。',
+ },
+ envEditor: {
+ sensitive: '機密',
+ none: '環境変数は設定されていません。',
+ noneHint: '下の入力から追加するか、JSON を直接編集してください。',
+ addVariable: '環境変数を追加',
+ keyPlaceholder: 'VARIABLE_NAME',
+ valuePlaceholder: '値',
+ },
+ setupVariant: {
+ using: '使用中:',
+ variantNameRequired: 'バリアント名 *',
+ variantNamePlaceholder: '例: my-gemini, g3, flash',
+ invokeHintPrefix: 'この名前で呼び出せます:',
+ model: 'モデル',
+ modelPlaceholder: '例: gemini-2.5-pro, claude-opus-4-6-thinking',
+ choosePresetInstead: '代わりにプリセットから選択',
+ selectModel: 'モデルを選択',
+ customModelName: 'カスタムモデル名...',
+ enterAnyModel: 'CLIProxy がサポートする任意のモデル名を入力',
+ defaultModel: 'デフォルト: {{model}}',
+ providerDefault: 'プロバイダーのデフォルト',
+ back: '戻る',
+ skip: 'スキップ',
+ creating: '作成中...',
+ createVariant: 'バリアントを作成',
+ skipHint: 'アカウント追加だけが目的なら、バリアント作成はスキップできます',
+ },
+ customPresetDialog: {
+ title: 'カスタムプリセット',
+ presetNameOptional: 'プリセット名 (任意)',
+ presetNamePlaceholder: '例: My Custom Config',
+ codexTipPrefix: 'Codex のヒント: サフィックス',
+ codexTipSuffix: 'で推論強度を固定できます。サフィックスなしのモデルは思考設定を使います。',
+ defaultModel: 'デフォルトモデル',
+ defaultModelDesc: '特定のティア指定がない場合に使用',
+ opusModel: 'Opus (最上位)',
+ opusModelDesc: '複雑な推論タスク向け',
+ sonnetModel: 'Sonnet (バランス)',
+ sonnetModelDesc: '速度と性能のバランス',
+ haikuModel: 'Haiku (高速)',
+ haikuModelDesc: '単純なタスクにすばやく応答',
+ cancel: 'キャンセル',
+ savePreset: 'プリセットを保存',
+ applyPreset: 'プリセットを適用',
+ },
+ componentModelSelector: {
+ selectModel: 'モデルを選択',
+ availableModelsCount: '利用可能なモデル ({{count}})',
+ preview: 'プレビュー',
+ },
+ copilotSettings: {
+ enableCopilot: 'Copilot を有効化',
+ enableCopilotDesc: 'GitHub Copilot サブスクリプションを利用できるようにします',
+ basicSettings: '基本設定',
+ accountType: 'アカウント種別',
+ accountTypeIndividual: '個人',
+ accountTypeBusiness: 'ビジネス',
+ accountTypeEnterprise: 'エンタープライズ',
+ rateLimiting: 'レート制限',
+ rateLimitSeconds: 'レート制限 (秒)',
+ noLimit: '制限なし',
+ waitOnRateLimit: 'レート制限時に待機',
+ waitOnRateLimitDesc: '制限到達時にエラーではなく待機します',
+ daemonSettings: 'デーモン設定',
+ autoStartDaemon: 'デーモンを自動起動',
+ autoStartDaemonDesc: 'プロファイル使用時に copilot-api を起動します',
+ },
+ providerModelSelector: {
+ selectModel: 'モデルを選択',
+ noModelsForProvider: 'このプロバイダーで利用可能なモデルはありません',
+ broken: '問題あり',
+ deprecated: '非推奨',
+ paid: '有料',
+ freeTier: '無料ティア',
+ paidTier: '有料ティア',
+ modelKnownIssues: 'このモデルには既知の問題があります',
+ viewIssueDetails: '問題の詳細を見る',
+ modelDeprecated: 'このモデルは非推奨です',
+ recommended: '推奨',
+ allModelsCount: 'すべてのモデル ({{count}})',
+ noModelsAvailable: '利用可能なモデルはありません',
+ },
+ createAuthProfileDialog: {
+ title: '新しいアカウントを作成',
+ description:
+ '認証プロファイルには Claude CLI へのログインが必要です。以下のコマンドをターミナルで実行してください。同期モード、グループ、継続性の深さは後でアカウント一覧から編集できます。',
+ profileName: 'プロファイル名',
+ profileNamePlaceholder: '例: work, personal, client',
+ invalidProfileName: '名前は英字で始め、英数字、ハイフン、アンダースコアのみ使用できます。',
+ enableSharedHistory: '他の ccs 認証アカウントとの共有履歴同期を有効にする',
+ historySyncGroupOptional: '履歴同期グループ (任意)',
+ historySyncGroupPlaceholder: 'default, sprint-a, client-x',
+ historySyncGroupHint:
+ '空欄の場合はデフォルトの共有グループを使用します。スペースはハイフンに正規化されます。',
+ deeperContinuity: '詳細: より深い継続性モード',
+ deeperContinuityHint:
+ 'session-env、file-history、shell-snapshots、todos の同期も追加します。認証情報は分離されたままです。',
+ invalidContextGroup:
+ 'グループは英字で始め、英数字、ハイフン、アンダースコアのみ使用できます (最大 {{max}} 文字)。',
+ command: 'コマンド',
+ commandFallback: 'ccs auth create ',
+ afterRunPrefix: 'コマンド実行後:',
+ afterRunStep1: 'ブラウザで Claude のログインを完了します',
+ afterRunStep2: 'ここに戻って更新し、新しいアカウントを確認します',
+ poolingHint:
+ 'Claude OAuth のプールルーティングを使う場合は、アカウントページのアクションボタンから CLIProxy Claude Pool を利用してください。',
+ close: '閉じる',
+ copied: 'コピーしました!',
+ copyCommand: 'コマンドをコピー',
+ },
+ cliproxyModelCategory: {
+ google: 'Google (Gemini)',
+ openai: 'OpenAI (GPT)',
+ anthropic: 'Anthropic (Claude)',
+ antigravity: 'Antigravity',
+ other: 'その他',
+ },
+ cliproxyOverviewComponents: {
+ availableModels: '利用可能なモデル',
+ noModelsAvailable: '利用可能なモデルはありません',
+ startSessionHint: '利用可能なモデルを取得するには CLIProxy セッションを開始してください',
+ totalCount: '合計 {{count}}',
+ availableThroughGroupedByProvider:
+ '{{backendLabel}} 経由で利用可能なモデルをプロバイダー別に表示',
+ moreCount: '+{{count}} 件',
+ },
+ categorizedModelSelector: {
+ selectModel: 'モデルを選択',
+ noModelsAvailable: '利用可能なモデルはありません',
+ modelPlaceholder: 'モデル...',
+ },
+ openrouterQuickStart: {
+ recommended: '推奨',
+ title: 'OpenRouter から始める',
+ description:
+ 'OpenAI、Anthropic、Google、Meta などの {{modelCountLabel}} モデルを、1 つの API で利用できます。',
+ featureOneApi: '1 つの API で全プロバイダー',
+ featureTierMapping: 'モデルティアマッピング',
+ createOpenRouterProfile: 'OpenRouter プロファイルを作成',
+ getApiKeyAt: 'API キー取得:',
+ or: 'または',
+ createCustomProfile: 'カスタム API プロファイルを作成',
+ },
+ alibabaCodingPlanQuickStart: {
+ recommended: '推奨',
+ title: 'Alibaba Coding Plan を試す',
+ description:
+ 'コーディング用途向けに、Anthropic 互換エンドポイント経由で Alibaba Cloud Coding Plan を利用します。',
+ featureEndpoint: 'Anthropic 互換エンドポイント',
+ featureKeyFormat: '専用の sk-sp API キー',
+ createAlibabaProfile: 'Alibaba Coding Plan プロファイルを作成',
+ readGuideAt: 'セットアップガイド:',
+ },
+ alibabaCodingPlanPromo: {
+ title: 'Alibaba Coding Plan',
+ subtitle: 'Anthropic エンドポイント経由の Model Studio Coding Plan',
+ add: '追加',
+ },
+ credentialHealth: {
+ title: '認証情報の状態',
+ ready: '準備完了',
+ noCredentialsConfigured: '認証情報が未設定です。上のログインボタンから認証してください。',
+ neverUsed: '未使用',
+ justNow: 'たった今',
+ unknown: '不明',
+ daysAgo: '{{count}}日前',
+ hoursAgo: '{{count}}時間前',
+ minutesAgo: '{{count}}分前',
+ },
+ proxyStatusWidget: {
+ justNow: 'たった今',
+ minutesAgo: '{{count}}分前',
+ hoursAgo: '{{count}}時間前',
+ syncReady: '同期準備完了',
+ noConfig: '設定なし',
+ remoteProxy: 'リモートプロキシ',
+ active: '稼働中',
+ trafficAutoRouted: 'トラフィックは自動でリモートサーバーにルーティングされます',
+ tooltipSync: 'CLIProxy にプロファイルを同期',
+ tooltipRestart: '再起動',
+ tooltipStop: '停止',
+ tooltipClose: '閉じる',
+ tooltipVersionSettings: 'バージョン設定',
+ versionManagement: 'バージョン管理',
+ selectVersionPlaceholder: 'インストールするバージョンを選択...',
+ stable: '(安定版)',
+ install: 'インストール',
+ versionsAboveUnstable: '{{version}} より新しいバージョンには既知の問題があります',
+ versionsKnownIssues: 'バージョン {{version}} には既知の問題があります',
+ lastChecked: '最終確認: {{time}}',
+ notRunning: '停止中',
+ start: '起動',
+ port: 'ポート {{port}}',
+ sessionCount: '{{count}} セッション',
+ sessionCount_other: '{{count}} セッション',
+ installFaultyTitle: '既知の問題があるバージョンをインストールしますか？',
+ installFaultyDesc:
+ '既知の不具合範囲 {{range}} に含まれる v{{version}} をインストールしようとしています。',
+ installFaultyWarning:
+ 'このバージョンには既知のバグがあり、失敗したりプロキシが不安定になる可能性があります。',
+ installUnstableTitle: '不安定なバージョンをインストールしますか？',
+ installUnstableDesc:
+ '最大安定版 v{{maxStable}} を上回る v{{version}} をインストールしようとしています。',
+ installUnstableWarning:
+ 'このバージョンには安定性の問題があり、予期しない動作を引き起こす可能性があります。',
+ installUnstableConfirm: 'このまま続行しますか？',
+ cancel: 'キャンセル',
+ installAnyway: 'このままインストール',
+ clickToDowngrade: 'クリックしてダウングレード',
+ clickToUpdate: 'クリックして更新',
+ },
+ syncStatusCard: {
+ profileSync: 'プロファイル同期',
+ ready: '準備完了',
+ noConfig: '設定なし',
+ syncsProfilesDesc: 'API プロファイルをローカルの CLIProxy 設定に同期します',
+ runDoctorHint: '設定を生成するには ccs doctor --fix を実行してください。',
+ details: '詳細',
+ syncNow: '今すぐ同期',
+ },
+ syncDialog: {
+ title: 'プロファイルをローカル CLIProxy に同期',
+ description: 'CCS の API プロファイルをローカルの CLIProxy config.yaml に同期します。',
+ noProfiles: '同期するプロファイルがありません。',
+ createProfilesFirst: '先にプロファイルタブで API プロファイルを作成してください。',
+ modelLabel: 'モデル:',
+ ready: '準備完了',
+ profilesToSync_one: '{{count}} 件のプロファイルを同期',
+ profilesToSync_other: '{{count}} 件のプロファイルを同期',
+ cancel: 'キャンセル',
+ syncing: '同期中...',
+ synced: '同期完了',
+ syncNow: '今すぐ同期',
+ },
+ errorLogs: {
+ title: 'エラーログ',
+ failedRequests_one: '{{count}} 件の失敗したリクエスト',
+ failedRequests_other: '{{count}} 件の失敗したリクエスト',
+ cliproxyDiagnostics: 'CLIProxy 診断',
+ showingCount: '{{total}} 件中 50 件のログを表示',
+ selectLog: '詳細を表示するログを選択してください',
+ failedLoadContent: 'ログ内容の読み込みに失敗しました',
+ copyAbsolutePath: '絶対パスをコピー',
+ copyRawContent: '生のログ内容をコピー',
+ tabOverview: '概要',
+ tabHeaders: 'ヘッダー',
+ tabRequest: 'リクエスト',
+ tabResponse: 'レスポンス',
+ tabRaw: '生データ',
+ modelLabel: 'モデル:',
+ quotaResetsIn: 'クォータのリセットまで ',
+ method: 'メソッド',
+ provider: 'プロバイダー',
+ version: 'バージョン',
+ endpoint: 'エンドポイント',
+ url: 'URL',
+ timestamp: 'タイムスタンプ',
+ na: '該当なし',
+ noHeaders: '利用可能なヘッダーはありません',
+ noRequestBody: 'リクエストボディなし',
+ noResponseBody: 'レスポンスボディなし',
+ rateLimitedMsg:
+ 'レート制限です。別のアカウントに切り替えるか、クォータのリセットを待ってください。モデル {{model}} のクォータは上限に達しています。',
+ rateLimitedMsgNoModel:
+ 'レート制限です。別のアカウントに切り替えるか、クォータのリセットを待ってください。',
+ authFailedMsg:
+ '認証に失敗しました。CLIProxy 設定で再認証するか、API キーを確認してください。',
+ notFoundMsg:
+ 'エンドポイントが見つかりません。このプロバイダーには存在しない可能性があります。',
+ serverErrorMsg:
+ '上流サーバーでエラーが発生しました。後でもう一度試すか、プロバイダーのステータスページを確認してください。',
+ timeoutMsg:
+ 'リクエストがタイムアウトしました。ネットワーク接続を確認するか、タイムアウト設定を延長してください。',
+ unknown: '不明',
+ },
+ editAccountContext: {
+ title: '履歴同期の設定',
+ description:
+ '"{{name}}" が他の CCS auth アカウントと履歴や継続性を共有する方法を設定します。',
+ syncMode: '同期モード',
+ selectContextMode: 'コンテキストモードを選択',
+ isolatedOption: '分離（同期なし）',
+ sharedOption: '共有（同期あり）',
+ sharedModeHint:
+ '共有モードでは、同じ履歴同期グループ内のアカウントでワークスペースコンテキストを再利用します。',
+ isolatedModeHint:
+ '分離モードでは、このアカウントを他の CCS auth アカウントから完全に切り離します。',
+ historySyncGroup: '履歴同期グループ',
+ groupPlaceholder: 'default',
+ groupHint:
+ '小文字に正規化されます（スペースはダッシュに変換）。使用可能: 英字、数字、_、-（最大 {{max}} 文字）。',
+ invalidGroup: '英字で始まる有効なグループ名を入力してください。',
+ continuityDepth: '継続性レベル',
+ selectContinuityDepth: '継続性レベルを選択',
+ standardOption: '標準（プロジェクトのみ）',
+ deeperOption: '拡張継続性（上級者向け）',
+ deeperHint:
+ '上級モードでは、session-env、file-history、shell-snapshots、todos も同期します。',
+ standardHint: '標準モードでは、プロジェクトのワークスペースコンテキストのみ同期します。',
+ credentialsIsolated:
+ 'どのモードでも、認証情報と .anthropic はアカウントごとに分離されます。',
+ cancel: 'キャンセル',
+ save: '保存',
+ saving: '保存中...',
+ },
+ historySyncLearningMap: {
+ title: '履歴同期の仕組み',
+ description: '分離 -> 共有 -> 拡張共有。変更は各行の「同期」から行います。',
+ learningMap: '概要図',
+ isolated: '分離',
+ shared: '共有',
+ deeper: '拡張共有',
+ cliproxyManaged_one:
+ '{{count}} 件の CLIProxy Claude Pool アカウントは、CLIProxy ページで管理します。',
+ cliproxyManaged_other:
+ '{{count}} 件の CLIProxy Claude Pool アカウントは、CLIProxy ページで管理します。',
+ showDetails: '詳細を表示: グループ、切り替え、レガシーポリシー',
+ modeSwitch: 'モード切り替え',
+ modeSwitchDesc:
+ '「同期」ダイアログでは、分離/共有の切り替えと、より深い継続性の選択ができます。',
+ historySyncGroup: '履歴同期グループ',
+ historySyncGroupDesc:
+ '同じグループのアカウントは、同じプロジェクトのコンテキストレーンを共有します。未設定時は default を使います。',
+ legacyConfirmation_one: '{{count}} 件のレガシーアカウントで明示的な確認がまだ必要です。',
+ legacyConfirmation_other: '{{count}} 件のレガシーアカウントで明示的な確認がまだ必要です。',
+ },
+ accountsTable: {
+ name: '名前',
+ type: '種別',
+ defaultBadge: '既定',
+ created: '作成日',
+ lastUsed: '最終使用',
+ historySync: '履歴同期',
+ actions: '操作',
+ syncTitle: '同期モード、グループ、継続性レベルを編集',
+ confirmLegacyTitle: 'このレガシーアカウントの現在のモードを明示的に確定する',
+ sync: '同期',
+ confirm: '確定',
+ active: '有効',
+ setDefault: '既定に設定',
+ deleteAccount: 'アカウントを削除',
+ cannotDeleteDefault: '既定のアカウントは削除できません',
+ noAccounts:
+ 'CCS auth アカウントが見つかりません。追加するには ccs auth create を使ってください。',
+ resetToDefault: 'CCS の既定値に戻す',
+ deleteDialogTitle: 'アカウントを削除',
+ deleteDialogDesc:
+ 'アカウント "{{name}}" を削除しますか？ この操作でプロファイルと関連するすべてのセッションデータが削除されます。この操作は元に戻せません。',
+ cancel: 'キャンセル',
+ delete: '削除',
+ sharedGroupStandard: '共有（{{group}}、標準）',
+ sharedGroupDeeper: '共有（{{group}}、拡張）',
+ sharedGroupLegacy: '共有（{{group}}、標準・レガシー）',
+ isolatedLegacy: '分離（旧既定値）',
+ isolated: '分離',
+ },
+ addAccountDialog: {
+ title: '{{displayName}} アカウントを追加',
+ descKiro:
+ 'Kiro の認証方法を選び、ブラウザーで認証するか Kiro IDE からインポートしてください。',
+ descDeviceCode:
+ '認証をクリックすると、プロバイダーのサイトで入力する確認コードが表示されます。',
+ descOauth:
+ '認証をクリックすると OAuth URL を取得します。任意のブラウザーで開いてサインインしてください。',
+ powerUserEnabled: '上級者モードが有効です',
+ powerUserSkipped:
+ '設定 > プロキシで AGY の責任確認チェックをスキップしています。OAuth / アカウントに関するリスクはすべて自己責任となります。',
+ authMethod: '認証方法',
+ selectKiroAuthMethod: 'Kiro の認証方法を選択',
+ nicknameRequired: 'ニックネーム（必須）',
+ nicknameOptional: 'ニックネーム（任意）',
+ nicknamePlaceholder: '例: work, personal',
+ nicknameRequiredHint:
+ 'このプロバイダーでは必須です。重複しないわかりやすい名前を付けてください（例: work, personal）。',
+ nicknameOptionalHint:
+ 'このアカウントを識別しやすい名前です。空欄ならメールアドレスから自動生成されます。',
+ waitingForAuth: '認証を待機中...',
+ deviceCodeHint:
+ '確認コードのダイアログがまもなく表示されます。プロバイダーのサイトでコードを入力してください。',
+ browserHint: 'ブラウザーで認証を完了してください。このダイアログは自動で閉じます。',
+ openUrlLabel: 'サインインするには、この URL を任意のブラウザーで開いてください:',
+ copied: 'コピー済み',
+ copy: 'コピー',
+ open: '開く',
+ popupBlocked:
+ 'ポップアップがブロックされました。上の URL をコピーして、ブラウザーで手動で開いてください。',
+ redirectPasteLabel:
+ 'リダイレクトが機能しない場合は、コールバック URL を貼り付けてください:',
+ callbackPlaceholder: 'リダイレクト URL をここに貼り付け...',
+ submitCallback: 'コールバックを送信',
+ submitting: '送信中...',
+ preparingUrl: 'サインイン URL を準備中...',
+ cancel: 'キャンセル',
+ importingToken: 'Kiro IDE からトークンをインポート中...',
+ authenticate: '認証',
+ importFromIde: 'IDE からインポート',
+ importing: 'インポート中...',
+ },
+ flowViz: {
+ backToProviders: 'プロバイダーに戻る',
+ showDetails: '詳細を表示',
+ hideDetails: '詳細を隠す',
+ resetLayout: 'レイアウトをリセット',
+ provider: 'プロバイダー',
+ totalRequests: '総リクエスト数',
+ accounts: 'アカウント',
+ connectionTimeline: '接続タイムライン',
+ noRecentConnections: '最近の接続はありません',
+ },
+ quickStats: {
+ totalRequests: '総リクエスト数',
+ successRate: '成功率',
+ totalTokens: '総トークン数',
+ activeModels: 'アクティブなモデル',
+ },
+ authMonitor: {
+ accounts: 'アカウント',
+ accountsCount: '{{count}} アカウント',
+ success: '成功',
+ failed: '失敗',
+ successRate: '成功率',
+ },
+ accountCard: {
+ resumeAccount: 'アカウントを再開',
+ pauseAccount: 'アカウントを一時停止',
+ quotaLoading: 'クォータ...',
+ quota: 'クォータ',
+ quotaUnavailable: 'クォータ上限を取得できません',
+ reauthNeeded: '再認証が必要',
+ failureLabelReauth: '再認証',
+ failureLabelWorkspace: 'ワークスペース',
+ failureLabelNoAccess: 'アクセス不可',
+ failureLabelRetry: '再試行',
+ failureLabelReconnect: '再接続',
+ failureLabelTemporary: '一時的',
+ failureLabelUnavailable: '利用不可',
+ failureHintReauth: 'このアカウントの認証フローをもう一度実行して更新してください。',
+ failureHintWorkspace:
+ 'このアカウントをアクティブなワークスペースに戻してから、削除して再追加してください。',
+ failureHintNoAccess:
+ 'このアカウントでは、プロバイダーのクォータエンドポイントにアクセスできません。',
+ failureHintRetry: 'しばらく待ってから、クォータリクエストを再試行してください。',
+ failureHintReconnect: '古いアカウントを削除し、再度認証してください。',
+ failureHintTemporary: '一時的な問題のようです。後でもう一度試してください。',
+ removeAndReadd: '削除して再追加',
+ autoRefreshFailed: '自動更新に失敗しました',
+ },
+ antigravityChecklist: {
+ title: 'Antigravity OAuth の責任確認',
+ subtitle: '認証する前に 4 ステップすべて完了してください。',
+ mandatory: '必須',
+ completion: '完了状況',
+ stepsCount: '{{current}}/4 ステップ',
+ },
+ accountSafetyWarning: {
+ title: 'OAuth アカウント安全性の警告',
+ subtitle: 'Issue #509 · Gemini + AGY OAuth リスク',
+ firstLine:
+ 'Issue #509 では、CCS AGY と、CCS Gemini と CCS AGY 間での共有アカウント利用に関連する停止・BAN 報告がまとめられています。',
+ secondLine:
+ 'OAuth とアカウントアクセスのリスクをすべて自己責任で負う場合のみ続行してください。',
+ issueLabel: 'Issue #509 を読む',
+ proxySettingsLabel: 'Gemini + AGY の設定: 設定 > プロキシ',
+ },
+ cliproxyDialog: {
+ name: '名前',
+ provider: 'プロバイダー',
+ account: 'アカウント',
+ accountOptional: 'アカウント（任意）',
+ model: 'モデル',
+ modelOptional: 'モデル（任意）',
+ defaultTarget: 'デフォルトターゲット',
+ defaultTier: 'デフォルトティア',
+ tierConfig: 'ティア設定',
+ selectProvider: 'プロバイダーを選択...',
+ useDefaultAccount: 'デフォルトのアカウントを使用',
+ defaultSuffix: '（デフォルト）',
+ opus: 'Opus',
+ sonnet: 'Sonnet',
+ haiku: 'Haiku',
+ claudeCode: 'Claude Code',
+ factoryDroid: 'Factory Droid',
+ cancel: 'キャンセル',
+ create: '作成',
+ creating: '作成中...',
+ saveChanges: '変更を保存',
+ saving: '保存中...',
+ placeholderName: 'my-gemini',
+ placeholderModel: 'gemini-2.5-pro',
+ placeholderComposite: 'my-composite',
+ placeholderModelId: 'model-id',
+ placeholderAccountId: 'account-id',
+ editCompositeTitle: '複合バリアントを編集: {{name}}',
+ editSingleTitle: '単一バリアントを編集: {{name}}',
+ },
+ profileEditor: {
+ profileInfo: 'プロファイル情報',
+ profileName: 'プロファイル名',
+ filePath: 'ファイルパス',
+ lastModified: '最終更新',
+ defaultTarget: 'デフォルトターゲット',
+ quickUsage: 'クイック実行',
+ runWithProfile: 'このプロファイルで実行',
+ runOnDroid: 'Droid で実行',
+ droidAliasExplicit: 'Droid エイリアス（明示）',
+ overrideToClaude: 'Claude に切り替え',
+ overrideToClaudeExplicit: 'Claude に切り替え（明示）',
+ setAsDefault: 'デフォルトに設定',
+ provider: 'プロバイダー',
+ custom: 'カスタム',
+ },
+ settings: {
+ sectionLoadFailed: 'セクションの読み込みに失敗しました',
+ unknownError: '不明なエラーが発生しました',
+ reloadPage: 'ページを再読み込み',
+ refresh: '更新',
+ copy: 'コピー',
+ copied: 'コピーしました',
+ saved: '保存しました',
+ loading: '読み込み中...',
+ configFileNotFound: '設定ファイルが見つかりません',
+ },
+ settingsTabs: {
+ web: 'Web検索',
+ env: '環境変数',
+ think: '思考',
+ proxy: 'プロキシ',
+ auth: '認証',
+ backup: 'バックアップ',
+ },
+ settingsAuth: {
+ failedFetchTokens: '認証トークンの取得に失敗しました',
+ failedSaveTokens: 'トークンの保存に失敗しました',
+ tokensUpdated: 'トークンを更新しました。反映するには CLIProxy を再起動してください。',
+ failedRegenerate: 'シークレットの再生成に失敗しました',
+ secretRegenerated:
+ '新しい Management Secret を生成しました。反映するには CLIProxy を再起動してください。',
+ failedReset: 'トークンのリセットに失敗しました',
+ tokensReset:
+ 'トークンをデフォルトに戻しました。反映するには CLIProxy を再起動してください。',
+ description:
+ 'CLIProxy の認証トークンを設定します。変更を反映するには CLIProxy の再起動が必要です。',
+ apiKey: 'API Key',
+ custom: 'カスタム',
+ apiKeyDesc: 'Claude Code が CLIProxy への認証に使用します',
+ apiKeyPlaceholder: 'API key',
+ managementSecret: 'Management Secret',
+ managementSecretDesc:
+ 'CCS ダッシュボードが CLIProxy の管理 API にアクセスするために使用します',
+ managementSecretPlaceholder: 'Management secret',
+ generateSecret: '新しい安全なシークレットを生成',
+ resetDefaults: 'デフォルトに戻す',
+ resetDesc: 'API Key と Management Secret の両方をデフォルト値に戻します。',
+ saving: '保存中...',
+ save: '保存',
+ },
+ settingsGlobalEnv: {
+ description:
+ 'Claude 以外のサブスクリプション型プロファイル（gemini、codex、agy、ghcp など）に注入する環境変数',
+ enabled: 'グローバル環境変数を有効化',
+ disabled: 'グローバル環境変数を無効化',
+ enabledDesc: '環境変数をサードパーティープロファイルに注入します',
+ disabledDesc: '環境変数は注入されません',
+ envVars: '環境変数',
+ noneConfigured: '環境変数は未設定です',
+ addNew: '変数を追加',
+ keyName: 'KEY_NAME',
+ value: '値',
+ add: '追加',
+ quickAdd: 'よく使う変数を追加',
+ allConfigured: '主要な変数はすべて設定済みです',
+ },
+ settingsBackups: {
+ failedFetch: 'バックアップの取得に失敗しました',
+ failedRestore: 'バックアップの復元に失敗しました',
+ restoreSuccess: 'バックアップを復元しました',
+ title: '設定バックアップ',
+ description:
+ 'settings.json の以前のバージョンを復元します。設定を変更するとバックアップが自動作成されます。',
+ none: '利用できるバックアップはありません',
+ noneHint: '設定を変更すると、ここにバックアップが表示されます',
+ latest: '最新',
+ restoring: '復元中...',
+ restore: '復元',
+ restoreConfirmTitle: 'バックアップを復元しますか？',
+ restoreConfirmPrefix: '現在の設定を次のバックアップで置き換えます:',
+ restoreConfirmSuffix: 'この操作は元に戻せません。',
+ cancel: 'キャンセル',
+ },
+ settingsWebsearch: {
+ description:
+ 'サードパーティープロファイル（gemini、codex、agy など）向けの CLI ベース Web 検索',
+ enabled: 'WebSearch を有効化',
+ disabled: 'WebSearch を無効化',
+ checking: '状態を確認中...',
+ providers: 'プロバイダー',
+ noneConfigured: 'プロバイダーが設定されていません',
+ noneConfiguredHint:
+ 'Web 検索プロバイダーを有効にするには CLI ツールをインストールしてください',
+ checkProviders: 'プロバイダーを確認',
+ installed: 'インストール済み',
+ notInstalled: '未インストール',
+ model: 'モデル:',
+ howInstall: '{{name}} CLI のインストール方法',
+ installGlobally: 'グローバルにインストール',
+ requiresKey: '(xAI API Key が必要)',
+ freeTier: '(無料枠あり)',
+ viewDocs: 'ドキュメントを見る',
+ },
+ settingsProxy: {
+ failedLoadAgyMode: 'AGY パワーユーザーモードの読み込みに失敗しました',
+ failedUpdateAgyMode: 'AGY パワーユーザーモードの更新に失敗しました',
+ failedVerifyAgyMode: 'AGY パワーユーザーモードの永続化確認に失敗しました',
+ notPersistedAgyMode:
+ 'AGY パワーユーザーモードが保存されませんでした。別のプロセスが設定を変更した可能性があります。',
+ agyModeEnabled: 'AGY パワーユーザーモードを有効にしました。',
+ agyModeDisabled: 'AGY パワーユーザーモードを無効にしました。',
+ typePhraseToContinue: '続行するには「{{value}}」と入力してください。',
+ description:
+ 'プロキシベースのプロファイル用に、ローカルまたはリモートの {{backend}} 接続を設定します',
+ backendPlus: 'CLIProxy Plus',
+ backend: 'CLIProxy',
+ instanceStatus: 'インスタンス状態',
+ connectionMode: '接続モード',
+ local: 'ローカル',
+ remote: 'リモート',
+ localDesc: 'このマシンで {{backend}} バイナリを実行します',
+ remoteDesc: 'リモートの {{backend}} サーバーに接続します',
+ backendBinary: 'バックエンドバイナリ',
+ stopProxyToSwitch:
+ 'バックエンドを切り替える前に、インスタンス状態から実行中のプロキシを停止してください。',
+ default: 'デフォルト',
+ plusDesc: 'Kiro と GitHub Copilot を含むすべてのプロバイダーをサポート',
+ originalDesc: '元のバイナリ（Gemini、Codex、Antigravity のみ）',
+ variantsIncompatible:
+ '既存の Kiro/Copilot バリアントは CLIProxyAPI では動作しません。CLIProxyAPIPlus に切り替えるか、それらのバリアントを削除してください。',
+ safety: '安全設定',
+ agyModeTitle: 'Antigravity パワーユーザーモード',
+ agyModeDesc:
+ 'アカウント追加画面と `ccs agy` フローで、AGY の責任確認チェックをスキップします。',
+ agyWarning:
+ 'OAuth の停止/BAN リスクパターン (#509) を十分理解している場合にのみ使用してください。CCS はアカウント喪失の責任を負いません。',
+ finalConfirm: '最終確認',
+ finalConfirmDesc:
+ '有効にすると、ダッシュボードと CLI の両方で AGY の安全チェックをスキップします。続行する前に issue #509 を確認し、正確なフレーズを入力してください。',
+ step1: 'ステップ 1',
+ readIssue: 'Issue #509 を読む',
+ step2: 'ステップ 2',
+ typePrefix: '有効にするには',
+ typeSuffix: 'と入力してください。',
+ typePhraseAria:
+ 'Antigravity パワーユーザーモードを有効にするには I ACCEPT RISK と入力してください',
+ exactPhrase: '完全一致で入力してください。',
+ enableAgyMode: 'パワーユーザーモードを有効にする',
+ toggleAgyMode: 'AGY パワーユーザーモードを切り替え',
+ fallbackSettings: 'フォールバック設定',
+ enableFallback: 'ローカルへのフォールバックを有効化',
+ enableFallbackDesc: 'リモートに接続できない場合はローカルプロキシを使用します',
+ autoStartLocal: 'ローカルプロキシを自動起動',
+ autoStartLocalDesc: 'フォールバック時にローカルプロキシを自動で起動します',
+ advanced: '詳細設定',
+ debugMode: 'デバッグモード',
+ debugModeDesc: 'ブラウザコンソールで開発者向け診断を有効にします',
+ debugModeEnabled:
+ 'デバッグモードを有効にしました。詳細ログはブラウザコンソールを確認してください。',
+ localProxy: 'ローカルプロキシ',
+ port: 'ポート',
+ autoStart: '自動起動',
+ localAutoStartDesc: '必要になったらローカルプロキシを自動起動します',
+ remoteConfigTitle: 'リモートサーバー設定',
+ host: 'ホスト',
+ hostPlaceholder: '192.168.1.100 または proxy.example.com',
+ defaultPort: 'デフォルト: {{value}}',
+ portPlaceholder: '{{value}} を使う場合は空欄',
+ protocol: 'プロトコル',
+ http: 'HTTP',
+ https: 'HTTPS',
+ apiKeyOptional: 'API Key（任意）',
+ apiKeyPlaceholder: '/v1/* API エンドポイント用',
+ apiKeyDesc: '/v1/chat/completions への API リクエストで使用します',
+ managementKeyOptional: 'Management Key（任意）',
+ managementKeyPlaceholder: '/v0/management/* エンドポイント用',
+ managementKeyDesc:
+ 'ダッシュボードの管理 API で使用します。未設定の場合は API Key を使用します。',
+ testing: 'テスト中...',
+ testConnection: '接続をテスト',
+ connectedLatency: '接続済み（{{value}}ms）',
+ connectionFailed: '接続に失敗しました',
+ invalidPortOrEmpty:
+ 'ポートは 1〜65535 の整数で入力するか、デフォルトを使う場合は空欄にしてください',
+ invalidLocalPort: 'ローカルポートは 1〜65535 の整数で指定してください',
+ backendPlusApi: 'CLIProxyAPIPlus',
+ backendApi: 'CLIProxyAPI',
+ },
+ settingsThinking: {
+ description: '対応モデルの高度な思考 / 推論設定を行います。',
+ supportedProviders: '対応プロバイダー',
+ modeTitle: '思考モード',
+ modeAutoDesc: 'モデルのティアに応じて思考レベルを自動設定します',
+ modeOffDesc: '高度な思考を無効化します',
+ modeManualDesc: '永続的な上書きレベルを設定するか、実行ごとに CLI フラグを使います',
+ tierDefaults: 'ティア別デフォルト',
+ tierDefaultsDesc: '自動モード時に各モデルティアへ適用する既定の思考レベルです。',
+ persistentOverride: '永続オーバーライド',
+ persistentOverrideDesc: 'すべてのセッションに適用されます。CLI フラグが優先されます。',
+ enterCustomBudget: 'カスタム予算を入力',
+ apply: '適用',
+ providerOverrides: 'プロバイダー別オーバーライド（{{count}}）',
+ providerOverridesDesc:
+ '特定のプロバイダーに対してティア別デフォルトを上書きします。必要に応じてカスタムのプロバイダーキーを追加してください。',
+ addProviderPlaceholder: 'プロバイダーキーを追加（例: qwen）',
+ showWarnings: '警告を表示',
+ showWarningsDesc: '思考値が制限または調整された場合に警告を表示します',
+ cliEnvOverride: 'CLI / 環境変数の上書き',
+ supportLine1Prefix: '思考予算:',
+ supportLine1Suffix: '（トークンベース）',
+ supportLine2Prefix: '推論強度:',
+ supportLine2SuffixPrefix: '（サフィックス、または ',
+ supportLine2SuffixPostfix: ': medium/high/xhigh)',
+ supportLine3Prefix: 'Codex のサフィックスは推論強度を固定します（例: ',
+ supportLine3Suffix: '）。サフィックスなしのモデルは思考モードを使います。',
+ },
+ analytics: {
+ title: '分析',
+ subtitle: '利用状況とインサイトを確認',
+ month: '月',
+ allTime: '全期間',
+ updated: '最終更新: {{value}}',
+ },
+ analyticsSummary: {
+ totalTokens: '総トークン数',
+ totalTokensSubtitle: '入力 {{input}} / 出力 {{output}}',
+ totalCost: '総コスト',
+ totalCostSubtitle: '1日平均 ${{value}}',
+ cacheTokens: 'キャッシュトークン',
+ cacheTokensSubtitle: '${{cost}}（コストの{{percent}}%）',
+ inputCost: '入力コスト',
+ outputCost: '出力コスト',
+ tokensSubtitle: '{{value}} トークン',
+ },
+ apiProfiles: {
+ title: 'API プロファイル',
+ new: '新規',
+ searchPlaceholder: 'プロファイルを検索...',
+ loadingProfiles: 'プロファイルを読み込み中...',
+ failedLoadTitle: 'プロファイルを読み込めませんでした',
+ failedLoadDesc: 'API プロファイルを取得できませんでした。もう一度お試しください。',
+ retry: '再試行',
+ noProfilesYet: 'API プロファイルがまだありません',
+ noProfilesDesc: '最初のプロファイルを作成して、カスタム API エンドポイントに接続します',
+ createProfile: 'プロファイルを作成',
+ noProfileMatch: '"{{query}}" に一致するプロファイルはありません',
+ profileCount: '{{count}} 件のプロファイル',
+ profileCount_other: '{{count}} 件のプロファイル',
+ configuredCount: '{{count}} 件設定済み',
+ deleteProfileTitle: 'プロファイルを削除',
+ deleteProfileDesc:
+ '"{{name}}" を削除しますか？設定ファイルも削除され、この操作は元に戻せません。',
+ delete: '削除',
+ unsavedChangesTitle: '未保存の変更',
+ unsavedChangesDesc:
+ '"{{current}}" に未保存の変更があります。破棄して "{{next}}" に切り替えますか？',
+ discardSwitch: '破棄して切り替え',
+ },
+ accountsPage: {
+ title: 'アカウント',
+ managePrefix: '一つの画面で',
+ manageSuffix: 'のアカウント管理とプール導線をまとめて扱えます。',
+ mobileManageSuffix: 'の継続性設定をまとめて管理できます。',
+ primaryActions: '主要アクション',
+ createAccount: 'アカウントを作成',
+ authClaudeInPool: 'Pool で Claude を認証',
+ openClaudePoolSettings: 'Claude Pool の設定を開く',
+ openCliProxyClaudePool: 'CLIProxy Claude Pool を開く',
+ migrationFollowup: '移行フォローアップ',
+ legacyContextPending: '{{count}} 件のアカウントで初回モード確認がまだ必要です。',
+ legacyContextPending_other: '{{count}} 件のアカウントで初回モード確認がまだ必要です。',
+ legacyContinuityPending: '{{count}} 件の共有アカウントが標準のレガシー継続深度のままです。',
+ legacyContinuityPending_other:
+ '{{count}} 件の共有アカウントが標準のレガシー継続深度のままです。',
+ confirmingLegacy: 'レガシーポリシーを確認中...',
+ confirmLegacy: 'レガシーポリシーを確認（{{count}}）',
+ noLegacyFollowup: '保留中のレガシーフォローアップはありません。',
+ continuityGuide: '継続性ガイド',
+ expandWhenNeeded: '必要なときだけ展開。',
+ sharedStandard: '共有標準',
+ sharedStandardDesc:
+ 'プロジェクトワークスペースの同期のみ。ほとんどのチームに最適な既定値です。',
+ sharedDeeper: '共有拡張',
+ sharedDeeperPrefix: '追加で',
+ isolated: '分離',
+ isolatedDesc: 'リンクなし。厳密な分離に最適です。',
+ quickCommands: 'クイックコマンド',
+ quickCommandsDesc: 'コピーしてターミナルで実行します。',
+ workspaceBadge: 'ccs auth ワークスペース',
+ historySyncBadge: '履歴同期設定',
+ authAccounts: '認証アカウント',
+ tableScopePrefix: 'この表では',
+ tableScopeMiddle: 'のアカウントのみを表示します。モード/グループ/継続性の変更は',
+ tableScopeSuffix: 'を使ってください。',
+ accountMatrix: 'アカウント一覧',
+ sharedTotalDesc:
+ '共有アカウント合計: {{count}}。ここから同期設定とレガシー確認を行えます。',
+ loadingAccounts: 'アカウントを読み込み中...',
+ },
+ health: {
+ justNow: 'たった今',
+ secondsAgo: '{{count}}秒前',
+ minutesAgo: '{{count}}分前',
+ hoursAgo: '{{count}}時間前',
+ systemHealth: 'システムヘルス',
+ build: 'ビルド {{version}}',
+ lastScan: '最終スキャン:',
+ autoRefresh: '自動更新:',
+ refresh: '更新',
+ checks: 'チェック',
+ version: 'バージョン',
+ platform: 'プラットフォーム',
+ liveMonitoring: 'ライブ監視中',
+ copied: 'クリップボードにコピーしました',
+ refreshing: 'ヘルスチェックを更新中...',
+ fix: '修正',
+ applyFix: '修正を適用',
+ healthLabel: 'ヘルス',
+ },
+ updates: {
+ actionRequired: '対応が必要',
+ done: '完了',
+ all: 'すべて',
+ inboxTitle: '更新インボックス',
+ inboxSubtitle: '対応を優先し、その後で完了または非表示にします。',
+ needsAction: '要対応',
+ doneCount: '完了',
+ searchPlaceholder: '対応内容またはコマンドを検索',
+ noNotices: 'このビューに一致する通知はありません。',
+ noUpdates: '利用可能な更新はありません。',
+ published: '{{date}} 公開',
+ markDone: '完了にする',
+ dismiss: '非表示',
+ reopen: '再表示',
+ doNext: '次にやる',
+ impactedIntegrations: '影響を受ける連携',
+ impactedDesc: '更新範囲とルーティングに基づく関連領域です。',
+ whyMatters: '重要な理由',
+ whyMattersDesc: '長文のリリースノートではなく、要点だけを表示します。',
+ open: '開く',
+ progressNeedsAction: '要対応',
+ progressInReview: '確認中',
+ progressDone: '完了',
+ progressDismissed: '非表示',
+ statusNew: '新着',
+ statusStable: '安定',
+ statusPlanned: '予定',
+ dashboard: 'ダッシュボード',
+ cliUsage: 'CLI利用状況',
+ },
+ cliproxyPage: {
+ connected: '接続済み',
+ notConnected: '未接続',
+ variant: 'バリアント',
+ parentNotConnected: '親が未接続',
+ viaProvider: '{{provider}} 経由',
+ emptyTitle: 'CCS プロファイルマネージャー',
+ emptyDesc:
+ 'CLIProxy プロバイダー向けの OAuth 認証、アカウント設定、モデル選択を管理します。CCS が各 AI バックエンドへのリクエストをどうルーティングするかを設定できます。',
+ emptyControlPanelPrefix: 'ライブ利用統計とリアルタイム監視は',
+ controlPanel: 'コントロールパネルで確認できます',
+ quickSetup: 'クイックセットアップ',
+ accountManagement: 'CCSレベルのアカウント管理',
+ providers: 'プロバイダー',
+ variants: 'バリアント',
+ providerCount: '{{count}} 件のプロバイダー',
+ providerCount_other: '{{count}} 件のプロバイダー',
+ connectedCount: '{{count}} 件接続済み',
+ variantDisplay: '{{name}}（{{provider}} バリアント）',
+ },
+ copilotPage: {
+ title: 'Copilot',
+ subtitle: 'GitHub Copilot プロキシ',
+ setup: 'セットアップ',
+ auth: '認証',
+ daemon: 'デーモン',
+ unofficialTitle: '非公式API: 自己責任で利用してください',
+ unofficialItem1:
+ 'リバースエンジニアリングされたAPIのため、いつでも動かなくなる可能性があります',
+ unofficialItem2: '過度な利用でアカウントに制限がかかる可能性があります',
+ unofficialItem3: 'CCSは保証も責任も負いません',
+ yes: 'はい',
+ no: 'いいえ',
+ installed: 'インストール済み',
+ missing: '未インストール',
+ integration: '連携',
+ enabled: '有効',
+ disabled: '無効',
+ github: 'GitHub',
+ connected: '接続済み',
+ notConnected: '未接続',
+ authenticate: '認証する',
+ authenticating: '認証中...',
+ status: 'ステータス',
+ running: '稼働中',
+ stopped: '停止',
+ port: 'ポート',
+ stopping: '停止中...',
+ stop: '停止',
+ starting: '起動中...',
+ start: '起動',
+ installing: 'インストール中...',
+ installCopilotApi: 'copilot-api をインストール',
+ proxy: 'プロキシ',
+ active: '有効',
+ inactive: '無効',
+ },
+ cursorPage: {
+ title: 'Cursor',
+ beta: 'ベータ',
+ subtitle: 'Cursor 専用の連携設定',
+ unofficialTitle: '非公式API - 自己責任で利用',
+ unofficialItem1:
+ 'リバースエンジニアリング連携のため、いつでも利用不能になる可能性があります',
+ unofficialItem2: '不正利用や過度な利用により、アカウントが制限されるおそれがあります',
+ unofficialItem3: 'CCSは保証も責任も負いません',
+ integration: '連携',
+ authentication: '認証',
+ daemon: 'デーモン',
+ enabled: '有効',
+ disabled: '無効',
+ expired: '期限切れ',
+ connected: '接続済み',
+ notConnected: '未接続',
+ running: '稼働中',
+ stopped: '停止中',
+ actions: '操作',
+ disableIntegration: '連携を無効化',
+ enableIntegration: '連携を有効化',
+ autoDetectAuth: '認証を自動検出',
+ manualAuthImport: '認証情報を手動インポート',
+ stopDaemon: 'デーモンを停止',
+ startDaemon: 'デーモンを起動',
+ port: 'ポート',
+ configuration: 'Cursor設定',
+ lastModified: '最終更新:',
+ neverSaved: '未保存',
+ saving: '保存中...',
+ save: '保存',
+ modelConfig: 'モデル設定',
+ settings: '設定',
+ info: '情報',
+ presets: 'プリセット',
+ presetsDesc: '事前設定済みのモデルマッピングを適用します',
+ modelMapping: 'モデルマッピング',
+ modelMappingDesc: '各ティアで使うモデルを設定します',
+ defaultModel: 'デフォルトモデル',
+ defaultModelDesc: '特定のティア指定がない場合に使われます。',
+ opusModel: 'Opus（最高性能）',
+ opusModelDesc: '複雑な推論と最高品質の応答向け。',
+ sonnetModel: 'Sonnet（バランス）',
+ sonnetModelDesc: '一般的なコーディングや日常的なチャット向け。',
+ haikuModel: 'Haiku（高速）',
+ haikuModelDesc: '低レイテンシで軽量なリクエスト向け。',
+ runtimeSettings: 'ランタイム設定',
+ autoStartDaemon: 'デーモンを自動起動',
+ autoStartDesc: '連携使用時にCursorデーモンを自動で起動します。',
+ ghostMode: 'ゴーストモード',
+ ghostModeDesc: 'テレメトリ削減のため x-ghost-mode を要求します。',
+ provider: 'プロバイダー',
+ filePath: 'ファイルパス',
+ availableModels: '利用可能なモデル',
+ loadingModels: 'モデルを読み込み中...',
+ noModels: 'モデルメタデータはまだありません。デーモンを起動して更新してください。',
+ default: 'デフォルト',
+ rawConfiguration: '生の設定（JSON）',
+ manualImportTitle: 'Cursor 認証情報の手動インポート',
+ manualImportDesc:
+ '自動検出できない場合は、CursorのアクセストークンとマシンIDを入力してください。',
+ accessToken: 'アクセストークン',
+ accessTokenPlaceholder: 'Cursorのアクセストークンを貼り付け',
+ machineId: 'マシンID',
+ machineIdPlaceholder: '32文字の16進数（ハイフンなしUUID）',
+ cancel: 'キャンセル',
+ import: 'インポート',
+ selectModel: 'モデルを選択',
+ useDefaultModel: 'デフォルトモデルを使用',
+ availableModelCount: '利用可能なモデル（{{count}}）',
+ invalidPort: 'ポートは1から65535の整数で指定してください',
+ defaultModelRequired: 'デフォルトモデルは必須です',
+ savedConfig: 'Cursor設定とモデルマッピングを保存しました',
+ failedSaveConfig: '設定の保存に失敗しました',
+ modelsLoadingWait: 'モデルの読み込み中です。プリセットの適用前にしばらくお待ちください。',
+ noModelsAvailable:
+ 'まだ利用可能なモデルがありません。先にデーモンを起動して更新してください。',
+ appliedCodexPreset: 'GPT-5.3 Codexプリセットを適用しました',
+ appliedClaudePreset: 'Claude 4.6プリセットを適用しました',
+ appliedGeminiPreset: 'Gemini 3プリセットを適用しました',
+ integrationEnabled: 'Cursor連携を有効化しました',
+ integrationDisabled: 'Cursor連携を無効化しました',
+ failedUpdateIntegration: '連携状態の更新に失敗しました',
+ credentialsImported: 'Cursor認証情報をインポートしました',
+ autoDetectFailed: '自動検出に失敗しました',
+ manualRequired: 'トークンとマシンIDは必須です',
+ manualImportFailed: '手動インポートに失敗しました',
+ failedStartDaemon: 'デーモンの起動に失敗しました',
+ daemonStarted: 'デーモンを起動しました',
+ daemonStartedWithPid: 'デーモンを起動しました（PID: {{pid}}）',
+ failedStopDaemon: 'デーモンの停止に失敗しました',
+ daemonStopped: 'デーモンを停止しました',
+ rawLoading: '生の設定をまだ読み込み中です。しばらく待ってから再試行してください。',
+ invalidJson: 'JSONが不正です',
+ rawSaved: '生の設定を保存しました',
+ rawChanged: '生の設定が外部で変更されました。更新して再試行してください。',
+ failedSaveRaw: '生の設定の保存に失敗しました',
+ savedAll: 'Cursor設定を保存しました',
+ },
+ droidPage: {
+ loadingDiagnostics: 'Droid診断を読み込み中...',
+ failedDiagnostics: 'Droid診断の読み込みに失敗しました。',
+ overview: '概要',
+ byok: 'BYOK',
+ docs: 'ドキュメント',
+ runtimeInstall: 'ランタイムとインストール',
+ status: '状態',
+ detected: '検出済み',
+ notFound: '未検出',
+ detectionSource: '検出元',
+ binaryPath: 'バイナリパス',
+ installDirectory: 'インストール先',
+ version: 'バージョン',
+ overridePath: 'オーバーライド（CCS_DROID_PATH）',
+ configFiles: '設定ファイル',
+ path: 'パス',
+ resolved: '解決先',
+ size: 'サイズ',
+ lastModified: '最終更新',
+ parseWarning: '解析警告: {{value}}',
+ readWarning: '読み取り警告: {{value}}',
+ warnings: '警告',
+ byokSummary: 'BYOK概要',
+ activeModelSelector: '現在のモデルセレクター',
+ customModels: 'カスタムモデル',
+ ccsManaged: 'CCS管理',
+ userManaged: 'ユーザー管理',
+ malformedEntries: '不正なエントリ',
+ providers: 'プロバイダー',
+ none: 'なし',
+ customModelsTitle: 'カスタムモデル',
+ modelName: '名前 / モデル',
+ provider: 'プロバイダー',
+ baseUrl: 'ベース URL',
+ noCustomModels: 'カスタムモデルはありません',
+ docsAlignedNotes: 'ドキュメント整合メモ',
+ factoryDocs: 'Factory Docs',
+ providerFactCheckDocs: 'プロバイダー検証ドキュメント',
+ providerValues: 'プロバイダー値: {{value}}',
+ settingsHierarchy: '設定階層: {{value}}',
+ settingsTitle: 'Droid BYOK 設定',
+ fixJsonBeforeQuickSettings: 'クイック設定を使う前に JSON 構文を修正してください。',
+ fixJsonBeforeReasoning: 'BYOK 推論設定を更新する前に JSON 構文を修正してください。',
+ unableUpdateReasoning: '選択した BYOK モデルの推論設定を更新できません。',
+ fixJsonBeforeBudget: '思考予算を更新する前に JSON 構文を修正してください。',
+ anthropicOnlyBudget: '思考予算は Anthropic の BYOK モデルでのみ利用できます。',
+ invalidJson: 'JSON が不正です: {{value}}',
+ saved: 'Droid 設定を保存しました',
+ changedExternally: 'Droid 設定が外部で変更されました。更新して再試行してください。',
+ failedSave: 'Droid 設定の保存に失敗しました',
+ },
+ sharedPage: {
+ commands: 'コマンド',
+ skills: 'スキル',
+ agents: 'エージェント',
+ title: '共有データ',
+ subtitle: 'Claudeインスタンス間で共有されるコマンド、スキル、エージェント',
+ totalShared: '共有数',
+ visible: '表示中',
+ markdownDetail: 'Markdown詳細ビュー',
+ filterPrefix: 'フィルター:',
+ configurationRequired: '設定が必要です',
+ countsUnavailable: '件数を取得できません',
+ retryCounts: '件数を再取得',
+ filterPlaceholder: '{{tab}}を名前、説明、パスで絞り込み',
+ showing: '{{visible}} / {{total}} 件の{{tab}}を表示',
+ showingQuery: '（「{{query}}」で絞り込み）',
+ refreshing: '（更新中...）',
+ loadingShared: '共有{{tab}}を読み込み中...',
+ failedLoadShared: '共有{{tab}}の読み込みに失敗しました',
+ retry: '再試行',
+ noSharedFound:
+ '共有{{tab}}が見つかりません。`ccs sync` を実行するか、共有ディレクトリに項目を追加してください。',
+ noMatch: '{{tab}}で「{{query}}」に一致するものはありません。',
+ selectOne: '内容を表示する{{tab}}を選択してください。',
+ pathLabel: 'パス',
+ resolvedSource: '解決後ソース',
+ loadingMarkdown: 'Markdownコンテンツを読み込み中...',
+ failedLoadContent: 'コンテンツの読み込みに失敗しました',
+ retryContent: '再読み込み',
+ noMarkdown: 'Markdownコンテンツはありません。',
+ },
+ },
+ },
} as const;
if (!i18n.isInitialized) {
diff --git a/ui/src/lib/locales.ts b/ui/src/lib/locales.ts
index ca719231..c9f82d5e 100644
--- a/ui/src/lib/locales.ts
+++ b/ui/src/lib/locales.ts
@@ -1,6 +1,6 @@
export const LOCALE_STORAGE_KEY = 'ccs-ui-locale';
-export const SUPPORTED_LOCALES = ['en', 'zh-CN', 'vi'] as const;
+export const SUPPORTED_LOCALES = ['en', 'zh-CN', 'vi', 'ja'] as const;
export type AppLocale = (typeof SUPPORTED_LOCALES)[number];
@@ -10,6 +10,7 @@ export function isSupportedLocale(locale: string): locale is AppLocale {
export function normalizeLocale(locale: string | null | undefined): AppLocale {
if (!locale) return 'en';
+ if (locale.toLowerCase().startsWith('ja')) return 'ja';
if (locale.toLowerCase().startsWith('zh')) return 'zh-CN';
if (locale.toLowerCase().startsWith('vi')) return 'vi';
return 'en';
diff --git a/ui/src/pages/accounts.tsx b/ui/src/pages/accounts.tsx
index 6b517db5..877b04b4 100644
--- a/ui/src/pages/accounts.tsx
+++ b/ui/src/pages/accounts.tsx
@@ -232,7 +232,7 @@ export function AccountsPage() {
{t('accountsPage.tableScopePrefix')}
ccs auth
{t('accountsPage.tableScopeMiddle')}
- Sync
+ {t('accountsTable.sync')}
{t('accountsPage.tableScopeSuffix')}
diff --git a/ui/src/pages/claude-extension.tsx b/ui/src/pages/claude-extension.tsx
new file mode 100644
index 00000000..00bed2c0
--- /dev/null
+++ b/ui/src/pages/claude-extension.tsx
@@ -0,0 +1,985 @@
+import { useState } from 'react';
+import {
+ AlertTriangle,
+ Loader2,
+ Plus,
+ RefreshCw,
+ Save,
+ Settings2,
+ ShieldCheck,
+ Sparkles,
+ Trash2,
+} from 'lucide-react';
+import { Badge } from '@/components/ui/badge';
+import { Button } from '@/components/ui/button';
+import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card';
+import { CopyButton } from '@/components/ui/copy-button';
+import { Input } from '@/components/ui/input';
+import { ScrollArea } from '@/components/ui/scroll-area';
+import {
+ Select,
+ SelectContent,
+ SelectItem,
+ SelectTrigger,
+ SelectValue,
+} from '@/components/ui/select';
+import { Tabs, TabsContent, TabsList, TabsTrigger } from '@/components/ui/tabs';
+import {
+ type ClaudeExtensionActionTarget,
+ type ClaudeExtensionBinding,
+ type ClaudeExtensionBindingInput,
+ type ClaudeExtensionFileState,
+ type ClaudeExtensionTargetStatus,
+ useApplyClaudeExtensionBinding,
+ useClaudeExtensionBindingStatus,
+ useClaudeExtensionBindings,
+ useClaudeExtensionOptions,
+ useClaudeExtensionSetup,
+ useCreateClaudeExtensionBinding,
+ useDeleteClaudeExtensionBinding,
+ useResetClaudeExtensionBinding,
+ useUpdateClaudeExtensionBinding,
+} from '@/hooks/use-claude-extension';
+import { cn } from '@/lib/utils';
+
+const EMPTY_BINDINGS: ClaudeExtensionBinding[] = [];
+
+interface BindingDraft {
+ name: string;
+ profile: string;
+ host: 'vscode' | 'cursor' | 'windsurf';
+ ideSettingsPath: string;
+ notes: string;
+}
+
+function createEmptyDraft(profile: string): BindingDraft {
+ return {
+ name: '',
+ profile,
+ host: 'vscode',
+ ideSettingsPath: '',
+ notes: '',
+ };
+}
+
+function bindingToDraft(binding: ClaudeExtensionBinding): BindingDraft {
+ return {
+ name: binding.name,
+ profile: binding.profile,
+ host: binding.host,
+ ideSettingsPath: binding.ideSettingsPath || '',
+ notes: binding.notes || '',
+ };
+}
+
+function normalizeBindingDraft(draft: BindingDraft): ClaudeExtensionBindingInput {
+ return {
+ name: draft.name.trim(),
+ profile: draft.profile.trim(),
+ host: draft.host,
+ ideSettingsPath: draft.ideSettingsPath.trim() || undefined,
+ notes: draft.notes.trim() || undefined,
+ };
+}
+
+function isPlainStatusActive(status?: ClaudeExtensionTargetStatus): boolean {
+ return status?.state === 'applied';
+}
+
+function StatusBadge({ state }: { state: ClaudeExtensionFileState }) {
+ const classes =
+ state === 'applied'
+ ? 'border-emerald-500/30 bg-emerald-500/10 text-emerald-700 dark:text-emerald-300'
+ : state === 'drifted'
+ ? 'border-amber-500/30 bg-amber-500/10 text-amber-700 dark:text-amber-300'
+ : state === 'missing'
+ ? 'border-destructive/30 bg-destructive/10 text-destructive'
+ : 'border-border bg-muted text-muted-foreground';
+
+ return (
+
+ {state}
+
+ );
+}
+
+function formatPathForDisplay(value: string): string {
+ return value.replace(/[\\/]/g, '$&\u200b');
+}
+
+function DetailRow({
+ label,
+ value,
+ mono = false,
+ copyValue,
+}: {
+ label: string;
+ value: string;
+ mono?: boolean;
+ copyValue?: string;
+}) {
+ const isPathRow = typeof copyValue === 'string' && copyValue.trim().length > 0;
+
+ return (
+
+
{label}
+ {isPathRow ? (
+
+
+
+ {formatPathForDisplay(value)}
+
+
+
+
+ ) : (
+
+ {value}
+
+ )}
+
+
+ {title}
+ {description}
+
+
+
+ {value}
+
+
+
+ );
+}
+
+function TargetStatusCard({
+ title,
+ description,
+ status,
+ applyLabel,
+ resetLabel,
+ onApply,
+ onReset,
+ disabled,
+ busy,
+}: {
+ title: string;
+ description: string;
+ status?: ClaudeExtensionTargetStatus;
+ applyLabel: string;
+ resetLabel: string;
+ onApply: () => void;
+ onReset: () => void;
+ disabled: boolean;
+ busy: boolean;
+}) {
+ return (
+
+
+
+
+ {title}
+ {description}
+
+ {status ?
: null}
+
+
+
+
+
+
+ {status?.message || 'Verify the binding after saving to inspect the current file state.'}
+
+
+
+
+
+
+
+
+ );
+}
+
+function BindingListItem({
+ binding,
+ isSelected,
+ onSelect,
+}: {
+ binding: ClaudeExtensionBinding;
+ isSelected: boolean;
+ onSelect: () => void;
+}) {
+ return (
+
+ );
+}
+
+export function ClaudeExtensionPage() {
+ const optionsQuery = useClaudeExtensionOptions();
+ const bindingsQuery = useClaudeExtensionBindings();
+ const createBinding = useCreateClaudeExtensionBinding();
+ const updateBinding = useUpdateClaudeExtensionBinding();
+ const deleteBinding = useDeleteClaudeExtensionBinding();
+ const applyBinding = useApplyClaudeExtensionBinding();
+ const resetBinding = useResetClaudeExtensionBinding();
+
+ const profiles = optionsQuery.data?.profiles ?? [];
+ const hosts = optionsQuery.data?.hosts ?? [];
+ const bindings = bindingsQuery.data?.bindings ?? EMPTY_BINDINGS;
+ const defaultProfile = profiles[0]?.name ?? 'default';
+
+ const [isCreating, setIsCreating] = useState(false);
+ const [selectedBindingId, setSelectedBindingId] = useState(null);
+ const [draft, setDraft] = useState(() => createEmptyDraft('default'));
+
+ const creating = isCreating || bindings.length === 0;
+ const selectedBinding =
+ !creating && bindings.length > 0
+ ? (bindings.find((binding) => binding.id === selectedBindingId) ??
+ (selectedBindingId ? null : bindings[0]))
+ : null;
+ const effectiveSelectedBindingId = selectedBinding?.id ?? null;
+ const currentDraft =
+ creating || !selectedBinding
+ ? draft
+ : selectedBindingId
+ ? draft
+ : bindingToDraft(selectedBinding);
+
+ const setupQuery = useClaudeExtensionSetup(currentDraft.profile, currentDraft.host);
+ const statusQuery = useClaudeExtensionBindingStatus(
+ creating ? undefined : effectiveSelectedBindingId || undefined
+ );
+
+ const selectedHost = hosts.find((host) => host.id === currentDraft.host);
+ const selectedProfile = profiles.find((profile) => profile.name === currentDraft.profile);
+ const activeError =
+ (optionsQuery.error as Error | null) ||
+ (bindingsQuery.error as Error | null) ||
+ (setupQuery.error as Error | null) ||
+ (statusQuery.error as Error | null);
+
+ const bindingCountLabel = `${bindings.length} saved`;
+ const isSaving = createBinding.isPending || updateBinding.isPending;
+ const isBusyShared =
+ (applyBinding.isPending && applyBinding.variables?.target === 'shared') ||
+ (resetBinding.isPending && resetBinding.variables?.target === 'shared');
+ const isBusyIde =
+ (applyBinding.isPending && applyBinding.variables?.target === 'ide') ||
+ (resetBinding.isPending && resetBinding.variables?.target === 'ide');
+ const canPersist = currentDraft.name.trim().length > 0 && currentDraft.profile.trim().length > 0;
+
+ const setup = setupQuery.data;
+ const status = statusQuery.data;
+ const hiddenEnvCount = Math.max((setup?.env.length ?? 0) - 6, 0);
+ const envPreview = setup?.env.slice(0, 6) ?? [];
+
+ function startCreateMode(): void {
+ setIsCreating(true);
+ setSelectedBindingId(null);
+ setDraft(createEmptyDraft(defaultProfile));
+ }
+
+ async function handleSave(): Promise {
+ if (!canPersist) return;
+
+ const payload = normalizeBindingDraft(currentDraft);
+ if (!creating && effectiveSelectedBindingId) {
+ const result = await updateBinding.mutateAsync({
+ id: effectiveSelectedBindingId,
+ binding: payload,
+ });
+ setIsCreating(false);
+ setSelectedBindingId(result.binding.id);
+ setDraft(bindingToDraft(result.binding));
+ return;
+ }
+
+ const result = await createBinding.mutateAsync(payload);
+ setIsCreating(false);
+ setSelectedBindingId(result.binding.id);
+ setDraft(bindingToDraft(result.binding));
+ }
+
+ async function handleDelete(): Promise {
+ if (!effectiveSelectedBindingId || !selectedBinding) return;
+ if (!window.confirm(`Delete binding "${selectedBinding.name}"?`)) return;
+
+ await deleteBinding.mutateAsync(effectiveSelectedBindingId);
+ const remaining = bindings.filter((binding) => binding.id !== effectiveSelectedBindingId);
+ if (remaining.length > 0) {
+ setSelectedBindingId(remaining[0].id);
+ setIsCreating(false);
+ setDraft(bindingToDraft(remaining[0]));
+ } else {
+ startCreateMode();
+ }
+ }
+
+ function updateDraft(key: K, value: BindingDraft[K]): void {
+ if (!creating && selectedBinding && !selectedBindingId) {
+ setSelectedBindingId(selectedBinding.id);
+ setDraft({ ...bindingToDraft(selectedBinding), [key]: value });
+ setIsCreating(false);
+ return;
+ }
+ setDraft((current) => ({ ...current, [key]: value }));
+ }
+
+ function runBindingAction(target: ClaudeExtensionActionTarget, action: 'apply' | 'reset'): void {
+ if (!effectiveSelectedBindingId) return;
+ if (action === 'apply') {
+ applyBinding.mutate({ id: effectiveSelectedBindingId, target });
+ return;
+ }
+ resetBinding.mutate({ id: effectiveSelectedBindingId, target });
+ }
+
+ return (
+
+
+
+
+
+
+
+
+
+
+
Claude Extension
+
+ Saved IDE bindings for CCS profiles
+
+
+
+
+ {bindingCountLabel}
+ {selectedHost ? {selectedHost.label} : null}
+
+
+
+
+
+
+
+
+
+
+
+ {creating ? 'Create binding' : 'Binding editor'}
+
+
+ Save a profile + IDE path once, then apply or reset it from the dashboard.
+
+
+
+
+
Binding name
+
updateDraft('name', event.target.value)}
+ placeholder="VS Code · work profile"
+ />
+
+
CCS profile
+
+
+ {selectedProfile?.description ||
+ 'Choose which CCS profile the IDE should inherit.'}
+
+
+
IDE host
+
+
+
IDE settings path
+
updateDraft('ideSettingsPath', event.target.value)}
+ placeholder={
+ selectedHost?.defaultSettingsPath ||
+ 'Leave blank for the default user settings path'
+ }
+ />
+
+ Leave blank to use the default user settings path for{' '}
+ {selectedHost?.label || 'this IDE'}.
+
+
+
Notes
+
updateDraft('notes', event.target.value)}
+ placeholder="Optional reminder for this machine or workspace"
+ />
+
+
+
+
+
+ {!creating ? (
+
+ ) : null}
+
+
+
+
+
+ Saved bindings
+
+
+ {bindings.length > 0 ? (
+ bindings.map((binding) => (
+ {
+ setIsCreating(false);
+ setSelectedBindingId(binding.id);
+ setDraft(bindingToDraft(binding));
+ }}
+ />
+ ))
+ ) : (
+
+
+ No saved bindings yet. Create one to manage apply, reset, and drift checks
+ from the dashboard.
+
+
+ )}
+
+
+
+
+
+
+
+
+
+
+
+ {selectedProfile ? (
+ {selectedProfile.label}
+ ) : null}
+ {selectedHost ? {selectedHost.label} : null}
+ {creating ? Draft : null}
+ {status?.sharedSettings &&
+ isPlainStatusActive(status.sharedSettings) &&
+ isPlainStatusActive(status.ideSettings) ? (
+ In sync
+ ) : null}
+
+
+
+ {selectedBinding?.name || 'Claude extension binding'}
+
+
+ Manage the shared Claude settings file and the IDE-local settings file as two
+ scoped targets.
+
+
+
+
+
+
+ {setup ? (
+
+ ) : null}
+
+
+
+ {activeError ? (
+
+
+
+ {activeError.message}
+
+
+ ) : null}
+
+ {!activeError ? (
+
+
+ Overview
+ Advanced
+
+
+
+
+ runBindingAction('shared', 'apply')}
+ onReset={() => runBindingAction('shared', 'reset')}
+ disabled={creating}
+ busy={isBusyShared}
+ />
+ runBindingAction('ide', 'apply')}
+ onReset={() => runBindingAction('ide', 'reset')}
+ disabled={creating}
+ busy={isBusyIde}
+ />
+
+
+
+
+
+ Resolved binding
+
+ The binding uses the same profile resolution as `ccs persist` and `ccs
+ env`.
+
+
+
+
+
+
+
+
+
+ {currentDraft.notes.trim() ? (
+
+ ) : null}
+
+
+
+
+
+ Managed payload
+
+ Keep the main view short. The full JSON stays in the Advanced tab.
+
+
+
+
+ {envPreview.map((entry) => (
+
+ {entry.name}
+
+ ))}
+ {hiddenEnvCount > 0 ? (
+ +{hiddenEnvCount} more
+ ) : null}
+
+
+
+ {setup?.env.length ? (
+
+
+ CCS will inject {setup.env.length} environment values.
+
+
+ The IDE-local target receives the extension schema. The shared
+ target receives the same env block through Claude settings.
+
+
+ ) : (
+
+ This profile resolves to native Claude defaults, so apply/reset mainly
+ clears existing CCS-managed overrides.
+
+ )}
+
+
+
+
+ ) : (
+
+ Save this draft to unlock apply, reset, and verify actions.
+
+ )}
+
+
+
+
+
+ Warnings
+
+ Operational details that can break the binding even when JSON is
+ correct.
+
+
+
+ {setup.warnings.length > 0 ? (
+ setup.warnings.map((warning) => (
+
+ ))
+ ) : (
+
+ No runtime warnings for this binding.
+
+ )}
+
+
+
+
+
+ Notes
+
+ Short context from CCS about account continuity and host-specific
+ behavior.
+
+
+
+ {setup.notes.length > 0 ? (
+ setup.notes.map((note) => (
+
+
+ {note}
+
+ ))
+ ) : (
+
+ No extra notes for this binding.
+
+ )}
+
+
+
+
+
+
+
+
+
+
+
+
+ Resolved environment payload
+
+
+ Exact environment values that the extension receives after CCS
+ expands this profile.
+
+
+
+
+ {JSON.stringify(setup.env, null, 2)}
+
+ ) : (
+
+ No env payload. This binding resolves to native Claude defaults.
+
+ )}
+
+
+
+
+
+
+ Shared target metadata
+
+ Useful when debugging drift or comparing with manual edits.
+
+
+
+
+
+
+
+
+
+
+
+ IDE target metadata
+
+ Current file path plus the extension setting key used for this host.
+
+
+
+
+
+
+
+
+
+
+ ) : (
+
+
+
+ Choose a profile and IDE host to preview the generated payload.
+
+
+ )}
+
+
+ ) : null}
+
+
+