fix(cli): clearer profile/proxy/api errors and rich not-found suggestions

Move resolveProfileAndTarget() inside the try block in ccs.ts so a missing
profile shows suggestions/available-profiles instead of a generic error. Use a
typed ProfileError for proxy start on an unknown profile (drops the irrelevant
install hint). api create: honor --yes for the OpenRouter model browser, show
ccs-codex/ccsx aliases for --target codex, and allow ANTHROPIC_EXTRA_MODELS on
import.

src/api/services/profile-lifecycle-validation.ts

@@ -23,6 +23,8 @@ const ALLOWED_ANTHROPIC_ENV_KEYS = new Set<string>([
   'ANTHROPIC_BASE_URL',
   'ANTHROPIC_AUTH_TOKEN',
   'ANTHROPIC_API_KEY',
+  // Written by profile-writer when --extra-models is supplied
+  'ANTHROPIC_EXTRA_MODELS',
   ...MODEL_ENV_KEYS,
 ]);
 

src/ccs.ts

@@ -46,8 +46,15 @@ async function main(): Promise<void> {
     return;
   }
 
-  // Phase C: profile + target detection (extracted to dispatcher/profile-resolver.ts)
+  try {
-  const resolvedProfile = await resolveProfileAndTarget({ args, browserLaunchOverride, cliLogger });
+    // Phase C: profile + target detection — inside try so ProfileNotFoundError
+    // reaches the rich showProfileNotFound() handler below instead of falling
+    // through to the bare unhandledRejection handler.
+    const resolvedProfile = await resolveProfileAndTarget({
+      args,
+      browserLaunchOverride,
+      cliLogger,
+    });
     const { profile, profileInfo, resolvedTarget, nativeClaudeRemainingArgs } = resolvedProfile;
 
     // Dynamic imports needed by Phase E flows — preserve original load ordering.
@@ -70,7 +77,6 @@ async function main(): Promise<void> {
       resolveProfileContinuityInheritance,
     };
 
-  try {
     // Special case: headless delegation (-p/--prompt)
     // Keep existing behavior for Claude targets only; non-claude targets must continue
     // through normal adapter dispatch logic.

src/commands/api-command/create-command.ts

@@ -196,6 +196,8 @@ async function resolveModelConfiguration(
   if (isOpenRouterUrl(baseUrl) && !providedModel) {
     console.log('');
     console.log(info('OpenRouter detected!'));
+    // --yes/-y suppresses interactive model browser; use preset defaultModel instead
+    if (!yes) {
       const useInteractive = await InteractivePrompt.confirm('Browse models interactively?', {
         default: true,
       });
@@ -206,6 +208,7 @@ async function resolveModelConfiguration(
           openRouterTierMapping = selection.tierMapping;
         }
       }
+    }
     console.log('');
     console.log(dim('Note: For OpenRouter, ANTHROPIC_API_KEY should be empty.'));
   }
@@ -571,6 +574,17 @@ export async function handleApiCreateCommand(args: string[]): Promise<void> {
     console.log(
       `  ${color(`ccs ${name} --target claude "your prompt"`, 'command')} ${dim('# override to Claude')}`
     );
+  } else if (target === 'codex') {
+    console.log(
+      `  ${color(`ccs ${name} "your prompt"`, 'command')} ${dim('# uses Codex CLI by default')}`
+    );
+    console.log(
+      `  ${color(`ccs-codex ${name} "your prompt"`, 'command')} ${dim('# explicit Codex alias')}`
+    );
+    console.log(`  ${color(`ccsx ${name} "your prompt"`, 'command')} ${dim('# short alias')}`);
+    console.log(
+      `  ${color(`ccs ${name} --target claude "your prompt"`, 'command')} ${dim('# override to Claude')}`
+    );
   } else {
     console.log(
       `  ${color(`ccs ${name} "your prompt"`, 'command')} ${dim('# uses claude by default')}`

src/commands/proxy-command.ts

@@ -10,7 +10,8 @@ import {
   startOpenAICompatProxy,
   stopOpenAICompatProxy,
 } from '../proxy';
-import { loadSettings } from '../config/config-loader-facade';
+import { loadConfigSafe, loadSettings } from '../config/config-loader-facade';
+import { ProfileError } from '../errors';
 
 function parseOptionValue(args: string[], key: string): string | undefined {
   const exactIndex = args.findIndex((arg) => arg === key);
@@ -82,11 +83,22 @@ function showHelp(): number {
 }
 
 function resolveProfile(profileName: string) {
+  // Pre-check profile in config to avoid the generic error() + npm-install hint from getSettingsPath.
+  const config = loadConfigSafe();
+  if (!config.profiles[profileName]) {
+    throw new ProfileError(
+      `Profile "${profileName}" is not configured for an OpenAI-compatible endpoint`,
+      profileName
+    );
+  }
   const settingsPath = expandPath(getSettingsPath(profileName));
   const settings = loadSettings(settingsPath);
   const profile = resolveOpenAICompatProfileConfig(profileName, settingsPath, settings.env || {});
   if (!profile) {
-    throw new Error(`Profile "${profileName}" is not configured for an OpenAI-compatible endpoint`);
+    throw new ProfileError(
+      `Profile "${profileName}" is not configured for an OpenAI-compatible endpoint`,
+      profileName
+    );
   }
   return profile;
 }