import{c as e,Q as t,j as r,m as a}from"./chunks/framework.BPKcPtvA.js";const h=JSON.parse('{"title":"Troubleshooting & FAQ","description":"","frontmatter":{},"headers":[],"relativePath":"troubleshooting.md","filePath":"troubleshooting.md","lastUpdated":1780488246000}'),s={name:"troubleshooting.md"};function n(i,o,l,d,c,p){return t(),r("div",null,[...o[0]||(o[0]=[a('<h1 id="troubleshooting-faq" tabindex="-1">Troubleshooting &amp; FAQ <a class="header-anchor" href="#troubleshooting-faq" aria-label="Permalink to &quot;Troubleshooting &amp; FAQ&quot;">​</a></h1><h2 id="installation" tabindex="-1">Installation <a class="header-anchor" href="#installation" aria-label="Permalink to &quot;Installation&quot;">​</a></h2><p><strong>Q: <code>pip install anthropic</code> fails with SSL error</strong><br> A: Update pip: <code>python -m pip install --upgrade pip</code>. If on Windows behind a corporate proxy, set <code>set HTTPS_PROXY=http://proxy:port</code>.</p><p><strong>Q: <code>python</code> not found on Windows</strong><br> A: Install from python.org. Check &quot;Add Python to PATH&quot; during installation.</p><p><strong>Q: <code>ModuleNotFoundError: No module named &#39;yaml&#39;</code></strong><br> A: <code>pip install pyyaml</code></p><h2 id="labs" tabindex="-1">Labs <a class="header-anchor" href="#labs" aria-label="Permalink to &quot;Labs&quot;">​</a></h2><p><strong>Q: Lab returns &quot;No input provided&quot;</strong><br> A: Check you&#39;re passing <code>messages</code> parameter, not <code>prompt</code>. The mock LLM expects: <code>messages=[{&quot;role&quot;: &quot;user&quot;, &quot;content&quot;: &quot;your prompt&quot;}]</code></p><p><strong>Q: Agent loops forever</strong><br> A: <code>MAX_ITERATIONS</code> is not set or is too high. Set it to 10-15 for labs.</p><p><strong>Q: Tool call returns empty result</strong><br> A: The mock LLM generates tool calls based on keyword detection. If your prompt doesn&#39;t contain trigger words (read, search, write), it won&#39;t generate tool calls.</p><p><strong>Q: <code>str_replace_editor</code> not found</strong><br> A: That&#39;s an Anthropic-specific tool type. The mock LLM only supports basic tool_use blocks. Use the standard tool format shown in the labs.</p><h2 id="skills" tabindex="-1">Skills <a class="header-anchor" href="#skills" aria-label="Permalink to &quot;Skills&quot;">​</a></h2><p><strong>Q: Installed skills don&#39;t appear in <code>/skills</code> menu</strong><br> A: Restart Claude Code after installation. Skills are loaded at startup.</p><p><strong>Q: Skill says &quot;not user-invocable&quot;</strong><br> A: Check the YAML frontmatter has <code>user-invocable: true</code>. Kit master files intentionally omit this (they&#39;re documentation, not invocable skills).</p><p><strong>Q: <code>$ARGUMENTS</code> not being replaced</strong><br> A: <code>$ARGUMENTS</code> is a placeholder. The agent (Claude Code / Pi) replaces it with your input when you invoke the skill via <code>/command</code>.</p><h2 id="api-keys" tabindex="-1">API Keys <a class="header-anchor" href="#api-keys" aria-label="Permalink to &quot;API Keys&quot;">​</a></h2><p><strong>Q: &quot;This model is not available&quot; from Anthropic</strong><br> A: You might need to request access to Claude Sonnet 4 / Opus 4. Check <a href="https://docs.anthropic.com" target="_blank" rel="noreferrer">docs.anthropic.com</a> for available models for your tier.</p><p><strong>Q: Mock LLM works but real API returns 401</strong><br> A: Check <code>ANTHROPIC_API_KEY</code> is set correctly. Test with: <code>python -c &quot;import os; print(os.environ.get(&#39;ANTHROPIC_API_KEY&#39;, &#39;NOT SET&#39;)[:10])&quot;</code></p><p><strong>Q: OpenRouter returns 402 Payment Required</strong><br> A: Your free credits may be exhausted. Add payment method or switch to a different provider.</p><h2 id="general" tabindex="-1">General <a class="header-anchor" href="#general" aria-label="Permalink to &quot;General&quot;">​</a></h2><p><strong>Q: The course files use <code>\\u2192</code> characters that show as garbage</strong><br> A: The course uses Unicode arrows (→) in diagrams. If your terminal doesn&#39;t support UTF-8, set <code>$env:PYTHONIOENCODING=&#39;utf-8&#39;</code> on Windows or use a UTF-8 capable terminal (Windows Terminal, iTerm2, Ghostty).</p><p><strong>Q: How do I cite this course?</strong><br> A: Reference &quot;Agentic Engineering Course&quot; with the module and lesson number.</p><p><strong>Q: Can I teach this course?</strong><br> A: Course materials are provided for personal study. Contact for teaching license.</p>',22)])])}const g=e(s,[["render",n]]);export{h as __pageData,g as default};
