diff --git a/changelog.d/fixes/9277-fix.plan.md b/changelog.d/fixes/9277-fix.plan.md
new file mode 100644
index 0000000000..b161675e43
--- /dev/null
+++ b/changelog.d/fixes/9277-fix.plan.md
@@ -0,0 +1 @@
+- fix(qoder): include actionable CLI_QODER_BIN hint in connection test when qodercli is not found (#9277)
\ No newline at end of file
diff --git a/src/app/api/providers/[id]/test/route.ts b/src/app/api/providers/[id]/test/route.ts
index 5e403829c3..f377b80290 100644
--- a/src/app/api/providers/[id]/test/route.ts
+++ b/src/app/api/providers/[id]/test/route.ts
@@ -11,6 +11,7 @@ import { getConsistentMachineId } from "@/shared/utils/machineId";
 import { syncToCloud } from "@/lib/cloudSync";
 import { validateProviderApiKey } from "@/lib/providers/validation";
 import { getCliRuntimeStatus } from "@/shared/services/cliRuntime";
+import { buildQoderCliNotFoundHint } from "@omniroute/open-sse/services/qoderCliResolve.ts";
 // Use the shared open-sse token refresh with built-in dedup/race-condition cache
 import { getAccessToken } from "@omniroute/open-sse/services/tokenRefresh.ts";
 import { rotationGroupFor } from "@omniroute/open-sse/services/refreshSerializer.ts";
@@ -206,7 +207,9 @@ async function getProviderRuntimeStatus(connection: any) {
 
     const runtimeMessage = runtime.installed
       ? `Local CLI runtime is installed but not runnable (${runtime.reason || "healthcheck_failed"})`
-      : "Local CLI runtime is not installed";
+      : provider === "qoder"
+        ? buildQoderCliNotFoundHint(runtime.reason || "not_found")
+        : "Local CLI runtime is not installed";
 
     return {
       ...runtime,