# guides-ai.pages.dev

> 105 short, numbered, copy-paste guides for AI tools — Claude Code, ChatGPT, Cursor, MCP servers,
> local models (Ollama, LM Studio), prompting, and AI image tools. Each guide ends in a command or exact
> steps you can copy. Guides are numbered NN.MM: NN = topic, MM = position inside the topic.

Search index (JSON): https://guides-ai.pages.dev/search-index.json
Log of additions: https://guides-ai.pages.dev/log/

## Topics

- 01 [Install & set up](https://guides-ai.pages.dev/topics/setup/) — Get Claude Code installed, updated, and unstuck — Windows, macOS, Linux, VS Code. (5 guides)
- 02 [First steps](https://guides-ai.pages.dev/topics/first-steps/) — Your first session, plan mode, the shortcuts that matter, and Gemini CLI. (4 guides)
- 03 [Claude Code commands](https://guides-ai.pages.dev/topics/commands/) — Hooks, subagents, slash commands, CLAUDE.md, permissions, context, and costs. (9 guides)
- 04 [Workflows](https://guides-ai.pages.dev/topics/workflow/) — Reviewing PRs, working across a whole codebase, giving an agent the right context. (6 guides)
- 05 [MCP](https://guides-ai.pages.dev/topics/mcp/) — Install servers, connect GitHub, and the best servers to start with. (8 guides)
- 06 [Claude](https://guides-ai.pages.dev/topics/claude/) — Projects and Artifacts in the Claude app. (2 guides)
- 07 [ChatGPT](https://guides-ai.pages.dev/topics/chatgpt/) — Custom GPTs, Projects, custom instructions, voice mode, and long PDFs. (6 guides)
- 08 [Cursor](https://guides-ai.pages.dev/topics/cursor/) — AI coding inside the Cursor editor. (3 guides)
- 09 [Local LLMs](https://guides-ai.pages.dev/topics/local-llm/) — Ollama and LM Studio: run a model locally, pick a quantization, call the API. (12 guides)
- 10 [Prompting](https://guides-ai.pages.dev/topics/prompting/) — Better prompts, system prompts, chaining, RAG, and fewer hallucinations. (8 guides)
- 11 [Choosing tools](https://guides-ai.pages.dev/topics/choosing/) — Claude vs ChatGPT, Claude Code vs Cursor, which model, which API. (5 guides)
- 12 [AI images](https://guides-ai.pages.dev/topics/image/) — Midjourney prompts, inpainting, and free background removal. (7 guides)
- 13 [Everyday tasks](https://guides-ai.pages.dev/topics/tasks/) — Practical jobs: spreadsheets, transcripts, summaries, data analysis with AI. (7 guides)
- 14 [Other coding agents](https://guides-ai.pages.dev/topics/agents/) — Codex CLI, Aider, Copilot CLI, Windsurf — the first session with each. (5 guides)
- 15 [Building with the API](https://guides-ai.pages.dev/topics/api/) — Claude and OpenAI APIs: first request, tool use, structured output, caching, batch, streaming. (18 guides)

## Guides

### 01 Install & set up

- 01.01 [Install Claude Code on Windows: Download, Setup, Run](https://guides-ai.pages.dev/guides/install-claude-code-windows/): irm https://claude.ai/install.ps1 | iex installs Claude Code on Windows 10 1809+. WinGet and npm alternatives, Git Bash setup, and the first login.
- 01.02 [How to Install Claude Code on macOS & Linux](https://guides-ai.pages.dev/guides/install-claude-code-macos-linux/): Install Claude Code with the curl script or Homebrew in under a minute. The npm route now needs Node.js 22+, and a paid Claude plan is required.
- 01.03 [-bash: claude: command not found — 4 Fixes That Work](https://guides-ai.pages.dev/guides/fix-claude-command-not-found/): claude: command not found means the install directory is not on your PATH. Four fixes: a new terminal, the PATH entry, a duplicate install, npm repair.
- 01.04 [How to Use Claude Code in VS Code](https://guides-ai.pages.dev/guides/claude-code-vscode-extension/): Install the Claude Code extension from the VS Code Marketplace for a native panel with inline diffs and rewind — it no longer auto-installs itself.
- 01.05 [How to Update Claude Code (and Unstick It)](https://guides-ai.pages.dev/guides/update-claude-code/): claude update applies the newest Claude Code now, claude doctor says why one stalled, and package-manager installs need upgrading by hand. Copy-paste.

### 02 First steps

- 02.01 [Your First Claude Code Session in 5 Minutes](https://guides-ai.pages.dev/guides/first-claude-code-session/): Run claude inside your project, give it one clear task, and check the permission mode first — auto mode may edit files without asking on paid plans.
- 02.02 [How to Use Plan Mode in Claude Code (and When)](https://guides-ai.pages.dev/guides/claude-code-plan-mode/): Plan mode makes Claude Code research and propose before editing. Enter it with Shift+Tab or /plan, review the plan, then approve — or keep planning.
- 02.03 [Claude Code Keyboard Shortcuts & Terminal Basics](https://guides-ai.pages.dev/guides/claude-code-terminal-shortcuts/): The keys that make Claude Code fast: @ for files, ! for shell, Esc to interrupt, Esc Esc to rewind, Shift+Tab for modes, Ctrl+B to background.
- 02.04 [Getting Started with Gemini CLI](https://guides-ai.pages.dev/guides/gemini-cli-first-steps/): Install Gemini CLI with npm, npx or Homebrew, sign in with Google for 60 requests a minute free, and run your first prompt inside a project.

### 03 Claude Code commands

- 03.01 [How to Set Up a CLAUDE.md That Actually Helps](https://guides-ai.pages.dev/guides/create-claude-md-project-memory/): Run /init, keep CLAUDE.md under 200 lines, and confirm it loaded with /context. Plus .claude/rules for path-scoped instructions and @path imports.
- 03.02 [Create a Custom Slash Command in Claude Code](https://guides-ai.pages.dev/guides/create-claude-code-slash-command/): Drop a Markdown file in .claude/commands/ and the filename becomes the command. Note $0 is the first positional argument, and skills are now preferred.
- 03.03 [How to Configure Hooks in Claude Code](https://guides-ai.pages.dev/guides/claude-code-hooks/): Hooks run a shell command on Claude Code events. Note $CLAUDE_FILE_PATHS no longer exists — read the file path from the JSON on stdin instead.
- 03.04 [How to Use Subagents in Claude Code](https://guides-ai.pages.dev/guides/claude-code-subagents/): A subagent is a separate Claude with its own context window. Write one as a Markdown file in .claude/agents/ — note /agents is no longer a wizard.
- 03.05 [Manage Context in Claude Code: /clear, /compact](https://guides-ai.pages.dev/guides/claude-code-manage-context/): Use /clear between tasks, /compact within one, /context to see what fills the window, and claude -c to resume. Keeps long sessions fast and cheap.
- 03.06 [How to Track and Cut Claude Code Token Usage](https://guides-ai.pages.dev/guides/claude-code-track-costs/): Run /usage to see session tokens, cost and plan limits — /cost is now just an alias. Then cut waste with /clear, subagents and the right model.
- 03.07 [Control What Claude Code Can Do: Permissions](https://guides-ai.pages.dev/guides/claude-code-permissions/): Claude Code now starts in auto mode on Pro, Max and Team plans. Shift+Tab to switch, and write allow/deny rules that actually match the command.
- 03.08 [Claude Code settings.json: Which File, Which Key](https://guides-ai.pages.dev/guides/claude-code-settings-json/): The four settings files Claude Code reads, which one wins when they disagree, and the handful of keys worth setting on day one.
- 03.09 [Claude Code Skills and Plugins](https://guides-ai.pages.dev/guides/claude-code-skills-and-plugins/): Skills are folders with a SKILL.md. Plugins bundle skills, agents and hooks for sharing. Install one from a marketplace, then write your own.

### 04 Workflows

- 04.01 [Let Claude Code Work on a Whole Repo Safely](https://guides-ai.pages.dev/guides/claude-code-whole-codebase-safely/): Branch, plan, deny the destructive commands, review in small chunks. Auto mode now starts on by default, so don't assume Claude will stop and ask.
- 04.02 [Give an AI Coding Agent the Right Context](https://guides-ai.pages.dev/guides/ai-coding-agent-context/): CLAUDE.md, AGENTS.md and .cursor/rules: four habits that fix most bad AI code — a rules file, @file references, one example, a clean context.
- 04.03 [How to Review a Pull Request with Claude Code](https://guides-ai.pages.dev/guides/claude-code-review-a-pr/): Run /code-review (alias /review) on a diff, or check out a PR with gh. Ask for correctness over style, then have Claude apply only the fixes you accept.
- 04.04 [How to Set Up the Claude Code GitHub Action](https://guides-ai.pages.dev/guides/claude-code-github-actions/): Install the Claude GitHub App, add one secret, and drop in a workflow so @claude answers in your issues and PRs. Copy-paste.
- 04.05 [How to Run Claude Code Headless in a Script or CI](https://guides-ai.pages.dev/guides/claude-code-headless-ci/): Run Claude Code non-interactively with claude -p, get JSON back, pre-approve tools, and wire it into a CI job. Copy-paste.
- 04.06 [Run Parallel Claude Code Sessions with Git Worktrees](https://guides-ai.pages.dev/guides/claude-code-parallel-sessions-worktrees/): Start a second Claude Code session in its own git worktree with `claude --worktree`, keep .env files in it, and clean up when you're done. Copy-paste.

### 05 MCP

- 05.01 [How to Install an MCP Server in Claude Code](https://guides-ai.pages.dev/guides/install-mcp-server-claude-code/): Add an MCP server with claude mcp add: -- for local commands, --transport http for hosted ones, --scope to choose who gets it, then /mcp to confirm.
- 05.02 [Connect Claude Code to GitHub with MCP](https://guides-ai.pages.dev/guides/connect-claude-code-to-github/): Add GitHub's hosted MCP server at api.githubcopilot.com with a bearer token — the old @modelcontextprotocol/server-github package has been archived.
- 05.03 [The Best MCP Servers to Start With](https://guides-ai.pages.dev/guides/best-mcp-servers-to-start/): Seven MCP reference servers are still maintained — filesystem, fetch, git, memory, time. GitHub, Postgres, Slack and Puppeteer were archived.
- 05.04 [MCP in Claude Code vs Claude Desktop](https://guides-ai.pages.dev/guides/mcp-claude-code-vs-desktop/): claude mcp add registers a server from the terminal; Claude Desktop edits a JSON config from Settings. Same protocol, two setup flows and one scope trick.
- 05.05 [How to Build an MCP Server in Python](https://guides-ai.pages.dev/guides/build-mcp-server-python/): Write a one-tool MCP server named word_count with the official Python SDK, run it over stdio, and call it from Claude Code with claude mcp add. Copy-paste.
- 05.06 [How to Build an MCP Server in TypeScript](https://guides-ai.pages.dev/guides/build-mcp-server-typescript/): Write a one-tool MCP server with the official TypeScript SDK, serve it over stdio, and call it from Claude Code. Copy-paste.
- 05.07 [MCP Server Not Working in Claude Code?](https://guides-ai.pages.dev/guides/claude-code-mcp-troubleshooting/): claude mcp list shows Failed to connect or Pending approval — the five checks that find the cause: scope, approval, the -- separator, env vars, timeouts.
- 05.08 [Connect a Remote MCP Server to Claude Code over HTTP](https://guides-ai.pages.dev/guides/claude-code-remote-mcp-servers/): Add a hosted MCP server with claude mcp add --transport http, authenticate with OAuth or a header, and pick the right scope for your team.

### 06 Claude

- 06.01 [How to Use Claude Projects](https://guides-ai.pages.dev/guides/claude-projects-getting-started/): Claude Projects keep files and instructions across chats. Free accounts get up to 5 projects; paid plans add RAG that expands knowledge up to 10x.
- 06.02 [How to Use Claude Artifacts](https://guides-ai.pages.dev/guides/claude-artifacts/): Artifacts open code, docs and diagrams in a side panel. Turn on Code execution and file creation in Settings, then iterate in place and publish a link.

### 07 ChatGPT

- 07.01 [ChatGPT PDF Summary: Summarize Long Files in 3 Steps](https://guides-ai.pages.dev/guides/chatgpt-summarize-pdf/): Attach the PDF in ChatGPT, ask for a shape instead of a summary, then drill in. The 512 MB and 2M-token caps, and what to do with a scanned file.
- 07.02 [How to Set ChatGPT Custom Instructions](https://guides-ai.pages.dev/guides/chatgpt-custom-instructions/): Custom instructions moved to Settings then Personalization, and it is now one field, not two boxes. They apply immediately to all chats, on every plan.
- 07.03 [How to Build a Custom GPT (No Code)](https://guides-ai.pages.dev/guides/build-a-custom-gpt/): Custom GPT creation now needs a Business, Enterprise or Edu workspace. Use the Configure tab for instructions, up to 20 knowledge files, and actions.
- 07.04 [How to Use ChatGPT Projects](https://guides-ai.pages.dev/guides/chatgpt-projects/): ChatGPT Projects group chats around shared files and instructions. Free plans get 5 files per project, Plus 25, Pro and Business 40 — and sharing is free.
- 07.05 [How to Use ChatGPT Voice Mode](https://guides-ai.pages.dev/guides/chatgpt-voice-mode/): ChatGPT voice now runs inside the chat, not a separate blue-orb screen. Tap the Voice icon on web, hold the mic on mobile, and when to skip it.
- 07.06 [How to Get Working Excel Formulas from ChatGPT](https://guides-ai.pages.dev/guides/excel-formulas-with-chatgpt/): Describe the sheet so ChatGPT can answer, ask for the formula plus a breakdown, verify it on real rows, and fix the four things that go wrong.

### 08 Cursor

- 08.01 [How to Use Cursor: A 10-Minute First-Edit Tutorial](https://guides-ai.pages.dev/guides/cursor-first-steps/): Cursor in ten minutes: Tab completions, Cmd/Ctrl K inline edits, the Agent sidepane on Cmd/Ctrl I, and how to review or undo what Agent wrote.
- 08.02 [Add an MCP Server to Cursor (.cursor/mcp.json)](https://guides-ai.pages.dev/guides/cursor-mcp-servers/): Configure a local or remote MCP server in Cursor, global or per project, keep the API key out of git, and verify it with a real tool call.
- 08.03 [How to Write a Cursor Project Rule (.cursor/rules)](https://guides-ai.pages.dev/guides/cursor-rules-file/): Cursor project rules are .mdc files with frontmatter. Learn the four rule types, which frontmatter produces each, and copy a working example.

### 09 Local LLMs

- 09.01 [How to Run Ollama on Windows (Install, GPU, Models)](https://guides-ai.pages.dev/guides/run-local-llm-ollama-windows/): Install Ollama on Windows 10 22H2+, run your first model with ollama run, check it landed on the GPU, and move the model store off your C: drive.
- 09.02 [Ollama Modelfile: a Custom Model With a System Prompt](https://guides-ai.pages.dev/guides/ollama-custom-model-modelfile/): An Ollama Modelfile bakes FROM, SYSTEM and PARAMETER into a named local model with ollama create, so behaviour travels with the model, not your scripts.
- 09.03 [Call Your Local Ollama Model from curl & Python](https://guides-ai.pages.dev/guides/call-ollama-api/): Ollama serves a local API on port 11434. Call /api/chat with curl or Python, or point any OpenAI client at http://localhost:11434/v1/ instead.
- 09.04 [Choose a GGUF Quantization: Q4 vs Q5 vs Q8](https://guides-ai.pages.dev/guides/choose-llm-quantization/): Q4_K_M is the default pick for local LLMs. Real bits-per-weight for each GGUF level, why Q8_0 is a legacy format, and how to match one to your RAM.
- 09.05 [Run a Local LLM with LM Studio (No Terminal)](https://guides-ai.pages.dev/guides/run-llm-lm-studio/): LM Studio downloads and runs GGUF models from a desktop app, then serves them at http://localhost:1234/v1 for any OpenAI-compatible client. No terminal.
- 09.06 [Download Models from Hugging Face with the hf CLI](https://guides-ai.pages.dev/guides/hugging-face-cli-download-models/): Install the hf CLI, log in, download one GGUF instead of a whole repo with --include, put files where you want with --local-dir, and clean the cache.
- 09.07 [llama.cpp Quickstart: Run a GGUF Model](https://guides-ai.pages.dev/guides/llama-cpp-quickstart/): Install llama.cpp, pull a GGUF straight from Hugging Face with llama cli -hf, chat in the terminal, then serve an OpenAI-compatible API on localhost:8080.
- 09.08 [How Much RAM or VRAM a Local LLM Needs (1B to 70B)](https://guides-ai.pages.dev/guides/local-llm-ram-vram-requirements/): Real GGUF file sizes at Q4/Q8 for 1B–70B models, the rule of thumb behind them, and what fits in 8, 16, 24 or 64 GB. Pick a model that actually runs.
- 09.09 [How to Run Ollama in Docker with an NVIDIA GPU](https://guides-ai.pages.dev/guides/ollama-in-docker-with-gpu/): NVIDIA Container Toolkit setup, the official docker run command, pulling a model, keeping models in a volume, and AMD or CPU fallbacks.
- 09.10 [How to Run Open WebUI with Ollama (Docker)](https://guides-ai.pages.dev/guides/open-webui-with-ollama/): Give your local Ollama models a ChatGPT-style web interface with one Docker command — first login, model picker, and fixes.
- 09.11 [How to Run a Local LLM with Ollama on macOS/Linux](https://guides-ai.pages.dev/guides/run-local-llm-ollama-macos-linux/): Install Ollama with one command, pull gemma3:4b, chat offline in the terminal, and keep the daemon running as a background service on port 11434.
- 09.12 [How to Serve a Model with vLLM](https://guides-ai.pages.dev/guides/vllm-serve-openai-compatible/): Install vLLM, start a server with vllm serve on localhost:8000, and call it with the OpenAI Python SDK. Needs a Linux box with an NVIDIA GPU.

### 10 Prompting

- 10.01 [How to Write Better AI Prompts (A Framework)](https://guides-ai.pages.dev/guides/write-better-ai-prompts/): A prompt framework that still holds: role, task, context, format — plus the long-input ordering rule Anthropic measures at up to 30% better answers.
- 10.02 [How to Write a System Prompt That Steers a Model](https://guides-ai.pages.dev/guides/write-a-system-prompt/): System prompt structure: role, rules with reasons, exact output format, tagged examples. Set it in the API system parameter and test it by breaking it.
- 10.03 [How to Reduce AI Hallucinations With Prompts](https://guides-ai.pages.dev/guides/reduce-ai-hallucinations/): Ground the answer in pasted source text, allow "not stated", demand a quote per claim, and lower temperature — the prompt habits that cut invented facts.
- 10.04 [How to Chain Prompts to Solve a Big Task](https://guides-ai.pages.dev/guides/prompt-chaining/): Prompt chaining splits a task into separate API calls you can inspect — the draft, review, refine loop — and when a modern model handles it in one call.
- 10.05 [RAG Explained Simply (and When You Need It)](https://guides-ai.pages.dev/guides/rag-explained-simply/): RAG retrieves relevant chunks, then generates. With 1M-token context windows and hosted file_search tools, here is when it still beats pasting the file.
- 10.06 [Prompt Evals with promptfoo: One YAML, One Matrix](https://guides-ai.pages.dev/guides/evals-with-promptfoo/): Install promptfoo, write a config with two prompts, three test cases and real assertions, run it, and read the pass/fail grid.
- 10.07 [LLM-as-Judge Evals: Rubric and Verdict](https://guides-ai.pages.dev/guides/llm-as-judge-evals/): Grade model outputs with a judge model: a copy-paste rubric prompt, a structured verdict, a Python scoring loop, and the biases that fake good scores.
- 10.08 [Prompt Injection Defense for Tool-Using Agents](https://guides-ai.pages.dev/guides/prompt-injection-defense/): Six defenses that actually reduce blast radius — privilege separation, allowlists, fenced tool results, approval gates, output filtering, and tests.

### 11 Choosing tools

- 11.01 [Which AI Model Should You Use?](https://guides-ai.pages.dev/guides/pick-an-ai-model/): Pick an AI model by job — coding, images, very long inputs, or private local inference — with the current tiers and the context-window myth corrected.
- 11.02 [Claude vs ChatGPT for Coding: Which to Use](https://guides-ai.pages.dev/guides/claude-vs-chatgpt-for-coding/): A practical split for real coding work — and the deciding fact most comparisons skip: Claude Code needs a paid plan, ChatGPT answers questions on free.
- 11.03 [Claude Code vs Cursor: Which One to Use](https://guides-ai.pages.dev/guides/claude-code-vs-cursor/): Claude Code is a terminal agent; Cursor is an agent-first editor. Where each one wins, and why the Claude Code extension installs into Cursor too.
- 11.04 [OpenAI API vs Claude API: Which to Build On](https://guides-ai.pages.dev/guides/openai-vs-claude-api/): OpenAI and Claude API compared on price per million tokens, 1M-token context, tool use and long-context surcharges — plus how to decide with your own eval.
- 11.05 [Fine-Tuning vs RAG vs Prompting: How to Choose](https://guides-ai.pages.dev/guides/fine-tuning-vs-rag-vs-prompting/): A decision table plus rules of thumb — which one fixes your problem, and what each costs in money, latency and maintenance.

### 12 AI images

- 12.01 [Remove an Image Background With AI (Free)](https://guides-ai.pages.dev/guides/remove-background-with-ai/): rembg cuts a subject to a transparent PNG from the command line — one file or a whole folder, offline, full resolution, no watermark and no upload.
- 12.02 [Midjourney Prompts That Actually Work](https://guides-ai.pages.dev/guides/midjourney-prompts-that-work/): Midjourney prompt structure: subject, style, details, then parameters last. --raw has replaced --style raw, and --ar still sets the aspect ratio.
- 12.03 [How to Inpaint: Edit One Part of an Image](https://guides-ai.pages.dev/guides/ai-image-inpainting/): Inpainting masks a region and regenerates only that: Midjourney Vary (Region), Firefly Generative Fill, ChatGPT, or Stable Diffusion locally.
- 12.04 [How to Install ComfyUI and Run Your First Workflow](https://guides-ai.pages.dev/guides/comfyui-first-workflow/): Install ComfyUI the reliable way, put a checkpoint in the right folder, load the default text-to-image graph, and generate an image.
- 12.05 [How to Generate Images Locally with FLUX (Python)](https://guides-ai.pages.dev/guides/generate-images-with-flux-locally/): Run FLUX.1-schnell locally on your GPU with a short Python diffusers script — accept the Hugging Face license and offload for low VRAM.
- 12.06 [How to Generate a Short AI Video Locally (Wan 2.2)](https://guides-ai.pages.dev/guides/generate-short-ai-video-locally/): The honest local text-to-video path: Wan 2.2 TI2V-5B in ComfyUI — three model files, real VRAM numbers, and a five-second clip.
- 12.07 [How to Upscale Images Locally with Real-ESRGAN](https://guides-ai.pages.dev/guides/upscale-images-locally/): Enlarge photos and anime art 4x on your own machine with the standalone Real-ESRGAN binary — one command, no Python, and batch folders.

### 13 Everyday tasks

- 13.01 [Clean Up Messy Spreadsheet Data with ChatGPT](https://guides-ai.pages.dev/guides/chatgpt-clean-spreadsheet-data/): Upload the CSV to ChatGPT data analysis, describe the mess once, and get back a cleaned file plus a repeatable formula or script. Limits and traps.
- 13.02 [How to Analyze a CSV with ChatGPT Data Analysis](https://guides-ai.pages.dev/guides/chatgpt-analyze-csv-data/): Upload a spreadsheet, get it cleaned, charted, and summarized — plus the limits worth knowing before you trust the numbers.
- 13.03 [How to Summarize a PDF Locally with Ollama](https://guides-ai.pages.dev/guides/summarize-pdf-locally-with-ollama/): Extract PDF text with pypdf, chunk it, summarize each chunk through the local Ollama API, and merge — about 30 lines, nothing uploaded.
- 13.04 [How to Summarize a YouTube Video with AI](https://guides-ai.pages.dev/guides/summarize-youtube-video-with-ai/): Pull the transcript with yt-dlp --convert-subs srt, then hand the .srt file to Claude or ChatGPT with a prompt that gives you timestamps, not mush.
- 13.05 [How to Generate Speech Locally with Piper TTS](https://guides-ai.pages.dev/guides/text-to-speech-locally/): Turn a text file into a WAV on your own machine — install Piper, download a voice, and choose between quality tiers and languages.
- 13.06 [How to Translate an SRT Subtitle File with AI](https://guides-ai.pages.dev/guides/translate-subtitles-with-ai/): Translate subtitles without breaking timestamps — a copy-paste Python script, the prompt that keeps line counts, and the checks that catch drift.
- 13.07 [How to Transcribe Audio Locally with Whisper](https://guides-ai.pages.dev/guides/whisper-transcribe-audio-locally/): Install OpenAI Whisper and ffmpeg, run whisper file.mp3 --model turbo, and get SRT and TXT subtitle files with timestamps out on your own machine.

### 14 Other coding agents

- 14.01 [How to Get Started with OpenAI Codex CLI](https://guides-ai.pages.dev/guides/codex-cli-first-steps/): Install Codex CLI with npm or Homebrew, sign in with ChatGPT, run your first task in a repo, and use /permissions to set what it can do. Copy-paste.
- 14.02 [How to Start Using Aider](https://guides-ai.pages.dev/guides/aider-first-steps/): Install Aider, point it at Claude or GPT with an API key, make your first edit, and control its git auto-commits. Copy-paste.
- 14.03 [How to Use GitHub Copilot CLI in Your Terminal](https://guides-ai.pages.dev/guides/github-copilot-cli-first-steps/): Install GitHub Copilot CLI, log in, ask it for a command or a code change, and control what it's allowed to run. Copy-paste.
- 14.04 [How to Start with Windsurf (Now Devin Desktop)](https://guides-ai.pages.dev/guides/windsurf-first-steps/): Windsurf is now Devin Desktop. Install it, open a project, run a first agent task, and find where your rules live. Copy-paste.
- 14.05 [Gemini CLI: Add MCP Servers and Install Extensions](https://guides-ai.pages.dev/guides/gemini-cli-mcp-and-extensions/): Wire an MCP server into Gemini CLI's settings.json or add it with one command, check it with /mcp, and install a packaged extension.

### 15 Building with the API

- 15.01 [Your First Claude API Request: curl, Python, Node](https://guides-ai.pages.dev/guides/claude-api-first-request/): Get a key, set ANTHROPIC_API_KEY, and make a working Messages API call in curl, Python, and Node — then read the response properly.
- 15.02 [Claude API Tool Use](https://guides-ai.pages.dev/guides/claude-api-tool-use/): Define a tool with a JSON schema, catch the tool_use block, run your function, and send back a tool_result — in a minimal Python loop.
- 15.03 [Get Reliable JSON Out of the Claude API](https://guides-ai.pages.dev/guides/claude-api-structured-output/): Constrain replies with output_config.format, or use messages.parse with Pydantic and Zod, so the Claude API returns JSON that always validates.
- 15.04 [Prompt Caching in the Claude API with cache_control](https://guides-ai.pages.dev/guides/claude-api-prompt-caching/): Cache a long system prompt or document with cache_control, confirm hits in the usage fields, and know when the 1.25x write cost pays for itself.
- 15.05 [Claude Message Batches API: Bulk Jobs at Half Price](https://guides-ai.pages.dev/guides/claude-api-batch-requests/): Create a batch of Messages requests, poll processing_status, stream results by custom_id — and pay 50% less than synchronous calls.
- 15.06 [Your First OpenAI API Request (Responses API)](https://guides-ai.pages.dev/guides/openai-api-first-request/): Create a key, set OPENAI_API_KEY, and make a working Responses API call in curl, Python, and Node — the API OpenAI recommends for new projects.
- 15.07 [OpenAI Structured Outputs: JSON Schema](https://guides-ai.pages.dev/guides/openai-api-structured-outputs/): Constrain Responses API output with text.format json_schema, parse straight into Pydantic or Zod, and use the same strict schemas for function calling.
- 15.08 [Stream LLM Responses: Claude and OpenAI](https://guides-ai.pages.dev/guides/stream-llm-responses/): Print tokens as they arrive from the Claude and OpenAI APIs — Python and JavaScript, plus the raw SSE events and how to detect the end.
- 15.09 [Claude Agent SDK for Python: Your First Agent](https://guides-ai.pages.dev/guides/claude-agent-sdk-python-quickstart/): Install claude-agent-sdk, run an agent that reads and edits real files, control which tools it may use, and read the final result.
- 15.10 [Claude Agent SDK for TypeScript: Your First Agent](https://guides-ai.pages.dev/guides/claude-agent-sdk-typescript-quickstart/): Install @anthropic-ai/claude-agent-sdk, stream an agent that edits real files, gate its tools, and read the final result message.
- 15.11 [Send a PDF to the Claude API (With Page Citations)](https://guides-ai.pages.dev/guides/claude-api-pdf-documents/): The document content block in Python, the page and size limits from the docs, citations that point at a page — and when to pre-extract text instead.
- 15.12 [Claude API Thinking and Effort](https://guides-ai.pages.dev/guides/claude-api-thinking-and-effort/): Turn adaptive thinking on, read the thinking blocks, dial depth with output_config.effort (low → max), stream deltas, and know what budget_tokens means.
- 15.13 [Send an Image to the Claude API (base64, URL, Files)](https://guides-ai.pages.dev/guides/claude-api-vision-images/): The image content block in Python and curl, the format and size limits from the docs, and a screenshot-to-CSV extraction that doesn't invent numbers.
- 15.14 [Embeddings Explained, With Code](https://guides-ai.pages.dev/guides/embeddings-explained-with-code/): What an embedding vector actually is, how to compute two and compare them in Python, and which model and dimension to pick.
- 15.15 [Your First Gemini API Request](https://guides-ai.pages.dev/guides/gemini-api-first-request/): Get a Gemini API key from AI Studio, set GEMINI_API_KEY, install the google-genai SDK, and make a working request with the Interactions API. Copy-paste.
- 15.16 [Generate Images with the OpenAI API (gpt-image)](https://guides-ai.pages.dev/guides/openai-api-image-generation/): Two ways to make an image with the OpenAI API — the Images endpoint and the image_generation tool — save the PNG, set size, quality and format.
- 15.17 [RAG Without a Vector Database: OpenAI File Search](https://guides-ai.pages.dev/guides/openai-file-search-rag/): Upload files to an OpenAI vector store, attach the file_search tool to a Responses API call, and get cited answers — no embeddings code, no database.
- 15.18 [A Minimal RAG in Python: Folder In, Cited Answer Out](https://guides-ai.pages.dev/guides/rag-with-python-minimal/): Chunk a folder of Markdown, embed it with Voyage, retrieve top-k with a numpy dot product, and answer with Claude citing the chunks it used.

## Paths (curated reading order)

### Get running
Install, run your first session, give the agent memory, then learn to prompt and pick a model.

1. 01.01 [Install Claude Code on Windows: Download, Setup, Run](https://guides-ai.pages.dev/guides/install-claude-code-windows/)
2. 01.02 [How to Install Claude Code on macOS & Linux](https://guides-ai.pages.dev/guides/install-claude-code-macos-linux/)
3. 02.01 [Your First Claude Code Session in 5 Minutes](https://guides-ai.pages.dev/guides/first-claude-code-session/)
4. 03.01 [How to Set Up a CLAUDE.md That Actually Helps](https://guides-ai.pages.dev/guides/create-claude-md-project-memory/)
5. 10.01 [How to Write Better AI Prompts (A Framework)](https://guides-ai.pages.dev/guides/write-better-ai-prompts/)
6. 11.01 [Which AI Model Should You Use?](https://guides-ai.pages.dev/guides/pick-an-ai-model/)

### Make Claude Code yours
Memory, slash commands, hooks, subagents, permissions, and keeping the bill in check.

1. 03.01 [How to Set Up a CLAUDE.md That Actually Helps](https://guides-ai.pages.dev/guides/create-claude-md-project-memory/)
2. 03.02 [Create a Custom Slash Command in Claude Code](https://guides-ai.pages.dev/guides/create-claude-code-slash-command/)
3. 03.03 [How to Configure Hooks in Claude Code](https://guides-ai.pages.dev/guides/claude-code-hooks/)
4. 03.04 [How to Use Subagents in Claude Code](https://guides-ai.pages.dev/guides/claude-code-subagents/)
5. 03.07 [Control What Claude Code Can Do: Permissions](https://guides-ai.pages.dev/guides/claude-code-permissions/)
6. 03.06 [How to Track and Cut Claude Code Token Usage](https://guides-ai.pages.dev/guides/claude-code-track-costs/)

### Run models locally
Ollama on Windows, LM Studio, the right quantization, the local API, and your own Modelfile.

1. 09.01 [How to Run Ollama on Windows (Install, GPU, Models)](https://guides-ai.pages.dev/guides/run-local-llm-ollama-windows/)
2. 09.05 [Run a Local LLM with LM Studio (No Terminal)](https://guides-ai.pages.dev/guides/run-llm-lm-studio/)
3. 09.04 [Choose a GGUF Quantization: Q4 vs Q5 vs Q8](https://guides-ai.pages.dev/guides/choose-llm-quantization/)
4. 09.03 [Call Your Local Ollama Model from curl & Python](https://guides-ai.pages.dev/guides/call-ollama-api/)
5. 09.02 [Ollama Modelfile: a Custom Model With a System Prompt](https://guides-ai.pages.dev/guides/ollama-custom-model-modelfile/)

### Prompt like a pro
Better prompts, a real system prompt, chaining, RAG, and fewer hallucinations.

1. 10.01 [How to Write Better AI Prompts (A Framework)](https://guides-ai.pages.dev/guides/write-better-ai-prompts/)
2. 10.02 [How to Write a System Prompt That Steers a Model](https://guides-ai.pages.dev/guides/write-a-system-prompt/)
3. 10.04 [How to Chain Prompts to Solve a Big Task](https://guides-ai.pages.dev/guides/prompt-chaining/)
4. 10.05 [RAG Explained Simply (and When You Need It)](https://guides-ai.pages.dev/guides/rag-explained-simply/)
5. 10.03 [How to Reduce AI Hallucinations With Prompts](https://guides-ai.pages.dev/guides/reduce-ai-hallucinations/)

### Build with the Claude API
First request, tool use, reliable JSON, prompt caching, batches, and streaming.

1. 15.01 [Your First Claude API Request: curl, Python, Node](https://guides-ai.pages.dev/guides/claude-api-first-request/)
2. 15.02 [Claude API Tool Use](https://guides-ai.pages.dev/guides/claude-api-tool-use/)
3. 15.03 [Get Reliable JSON Out of the Claude API](https://guides-ai.pages.dev/guides/claude-api-structured-output/)
4. 15.04 [Prompt Caching in the Claude API with cache_control](https://guides-ai.pages.dev/guides/claude-api-prompt-caching/)
5. 15.05 [Claude Message Batches API: Bulk Jobs at Half Price](https://guides-ai.pages.dev/guides/claude-api-batch-requests/)
6. 15.08 [Stream LLM Responses: Claude and OpenAI](https://guides-ai.pages.dev/guides/stream-llm-responses/)

### Serve models yourself
Ollama on macOS/Linux, llama.cpp, a GPU server with vLLM, and a chat UI on top.

1. 09.11 [How to Run a Local LLM with Ollama on macOS/Linux](https://guides-ai.pages.dev/guides/run-local-llm-ollama-macos-linux/)
2. 09.07 [llama.cpp Quickstart: Run a GGUF Model](https://guides-ai.pages.dev/guides/llama-cpp-quickstart/)
3. 09.12 [How to Serve a Model with vLLM](https://guides-ai.pages.dev/guides/vllm-serve-openai-compatible/)
4. 09.10 [How to Run Open WebUI with Ollama (Docker)](https://guides-ai.pages.dev/guides/open-webui-with-ollama/)

### Try the other coding agents
One first session each: Codex CLI, Aider, Copilot CLI, Windsurf — then Claude Code in CI.

1. 14.01 [How to Get Started with OpenAI Codex CLI](https://guides-ai.pages.dev/guides/codex-cli-first-steps/)
2. 14.02 [How to Start Using Aider](https://guides-ai.pages.dev/guides/aider-first-steps/)
3. 14.03 [How to Use GitHub Copilot CLI in Your Terminal](https://guides-ai.pages.dev/guides/github-copilot-cli-first-steps/)
4. 14.04 [How to Start with Windsurf (Now Devin Desktop)](https://guides-ai.pages.dev/guides/windsurf-first-steps/)
5. 04.05 [How to Run Claude Code Headless in a Script or CI](https://guides-ai.pages.dev/guides/claude-code-headless-ci/)
6. 04.04 [How to Set Up the Claude Code GitHub Action](https://guides-ai.pages.dev/guides/claude-code-github-actions/)

## Optional

- [About](https://guides-ai.pages.dev/about/)
- [Disclosure](https://guides-ai.pages.dev/disclosure/)