@@ -81,6 +81,23 @@ altimate /discover
 
 > **Zero additional setup.** One command install.
 
+### Use it from Claude Code or Codex
+
+The Altimate Code plugins let Claude Code and Codex hand dbt and warehouse work to
+altimate. Install the CLI above first — the plugins run it, they do not install it.
+
+```bash
+# Claude Code
+claude plugin install altimate-code
+
+# Codex — add the marketplace, then open Codex, type /plugins and install "Altimate Code"
+codex plugin marketplace add AltimateAI/altimate-codex-plugin
+```
+
+See [Using with Claude Code](docs/docs/data-engineering/guides/using-with-claude-code.md) for
+the marketplace install, sign-in and the `/altimate-code:altimate` command, and the
+[Codex plugin README](https://github.com/AltimateAI/altimate-codex-plugin#install) for Codex.
+
 ## Why a specialized harness?
 
 General AI coding agents can edit SQL files. They cannot *understand* your data stack.
 
@@ -71,10 +71,19 @@ function parse(tip: string): TipPart[] {
 const NO_MODELS_TIP = "Run {highlight}/connect{/highlight} to add an AI provider and start coding"
 const NO_MODELS_PARTS = parse(NO_MODELS_TIP)
 
+// altimate_change start — suggest the Altimate Code plugins for Claude Code and Codex
+const CLAUDE_PLUGIN_TIP =
+  "Using Claude Code? Run {highlight}claude plugin install altimate-code{/highlight} to hand dbt and warehouse work to Altimate Code"
+const CODEX_PLUGIN_TIP =
+  "Using Codex? Run {highlight}codex plugin marketplace add AltimateAI/altimate-codex-plugin{/highlight}, then install Altimate Code from {highlight}/plugins{/highlight}"
+// altimate_change end
+
 // altimate_change start — upstream_fix: restore first-run beginner tip pool
 const BEGINNER_TIPS: Tip[] = [
   "Run {highlight}/connect{/highlight} to add your API key and get started",
   "Run {highlight}/discover{/highlight} to auto-detect your dbt project and warehouse connections",
+  CLAUDE_PLUGIN_TIP,
+  CODEX_PLUGIN_TIP,
   "Press {highlight}Ctrl+P{/highlight} to see all available commands",
   "Press {highlight}Tab{/highlight} to cycle between Build and Plan agents",
   "Use {highlight}/cost-report{/highlight} to analyze warehouse spending",
@@ -320,6 +329,8 @@ const TIPS: Tip[] = [
   "Use {highlight}/ci-check{/highlight} to run pre-merge SQL validation on changed files",
   "Ask me to analyze a SQL query for anti-patterns — I'll detect 19+ issue types with zero false positives",
   "Ask me to trace column-level lineage for any SQL query across dialects",
+  CLAUDE_PLUGIN_TIP,
+  CODEX_PLUGIN_TIP,
   // altimate_change end
 ]
 
 
@@ -155,3 +155,31 @@ test("tips use beginner pool only for first-time users", async () => {
     random.mockRestore()
   }
 })
+
+for (const [name, index, text] of [
+  ["Claude Code", 2, "Using Claude Code? Run claude plugin install altimate-code"],
+  ["Codex", 3, "Using Codex? Run codex plugin marketplace add AltimateAI/altimate-codex-plugin"],
+] as const) {
+  test(`tips suggest the Altimate Code plugin for ${name}`, async () => {
+    // Plugin tips sit at fixed positions in the all-string beginner pool.
+    const random = spyOn(Math, "random").mockReturnValue((index + 0.5) / 14)
+
+    try {
+      const app = await testRender(() => <TipsHarness isFirstTime={true} connected={false} />, {
+        width: 200,
+        height: 4,
+      })
+
+      try {
+        await renderOnceSettled(app)
+        const frame = await captureSettledFrame(app)
+
+        expect(frame).toContain(text)
+      } finally {
+        app.renderer.destroy()
+      }
+    } finally {
+      random.mockRestore()
+    }
+  })
+}