{"id":2847,"date":"2026-06-13T21:12:11","date_gmt":"2026-06-13T12:12:11","guid":{"rendered":"https:\/\/www.wakacin-lifestyle.com\/?p=2847"},"modified":"2026-06-14T09:50:41","modified_gmt":"2026-06-14T00:50:41","slug":"how-i-set-up-claude-code-on-my-mac-a-non-engineers-honest-guide","status":"publish","type":"post","link":"https:\/\/www.wakacin-lifestyle.com\/?p=2847","title":{"rendered":"How I Set Up Claude Code on My Mac \u2014 A Non-Engineer&#8217;s Honest Guide"},"content":{"rendered":"\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p class=\"wp-block-paragraph\">I&#8217;m not a software engineer. I&#8217;m a Technical Program Manager, which means I work <em>around<\/em> engineers every day \u2014 but I don&#8217;t usually write code myself. So when I decided to install <strong>Claude Code<\/strong>, Anthropic&#8217;s command-line AI tool, I expected it to be painful.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">It kind of was. But in a fixable way. Here&#8217;s exactly what happened and how I got it working.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">What Is Claude Code?<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Claude Code is a command-line tool that lets you work with Claude (the AI) directly from your terminal. Instead of going back and forth in a chat window, you can ask Claude to write code, edit files, run commands, and build things \u2014 all without leaving your terminal.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Think of it as having an AI developer sitting next to you while you work.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">My Setup<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>MacBook (macOS)<\/li>\n\n\n\n<li>No prior experience with command-line tools beyond the basics<\/li>\n\n\n\n<li>Goal: use Claude Code to build and manage my side projects<\/li>\n<\/ul>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Step 1: Installation<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">I followed the official instructions and ran the install command in Terminal. The installation itself went smoothly and ended with:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>\u2705 Installation complete!\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Great sign. Or so I thought.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Step 2: The Error That Stumped Me<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">After installation, I tried to run Claude Code:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>claude\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">And got this:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>zsh: command not found: claude\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">I tried again. Same error. I even tried <code>claude claude<\/code> (yes, I panicked a little). Still nothing.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">What Was Actually Wrong<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The installer placed the <code>claude<\/code> binary in <code>~\/.local\/bin\/<\/code>, but my terminal didn&#8217;t know to look there. This is a <strong>PATH issue<\/strong> \u2014 a very common problem that catches a lot of people off guard.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">I confirmed the file was there:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>ls ~\/.local\/bin\/\n# claude \u2713\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">It existed. My terminal just couldn&#8217;t find it.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">The Fix<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Two steps:<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>1. Add the path to your shell config:<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>echo 'export PATH=\"$HOME\/.local\/bin:$PATH\"' &gt;&gt; ~\/.zshrc\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>2. Reload your shell:<\/strong><\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>source ~\/.zshrc\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Then verify it works:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>claude --version\n# 2.1.177 (Claude Code)\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">That&#8217;s it. The tool was there the whole time \u2014 my terminal just needed to be told where to look.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Step 3: First Launch<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Once the PATH was fixed, I ran:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>claude\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">And was greeted with this:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>Welcome to Claude Code v2.1.177\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">&#8230;and a tiny ASCII pig. \ud83d\udc37<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">Where to Run Claude Code From<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">This is something I didn&#8217;t think about until after setup: <strong>it matters where in your file system you launch Claude Code from.<\/strong><\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The best practice is to create a dedicated folder for your projects and launch Claude from inside the relevant project folder:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>mkdir -p ~\/Claude\/my-project\ncd ~\/Claude\/my-project\nclaude\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">Claude Code will create its own config files in that folder, so it remembers context for that project each time.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">My Takeaway<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">The installation itself is straightforward. The only real hurdle is the PATH issue \u2014 and once you know what it is, it takes 30 seconds to fix.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">If you hit <code>command not found: claude<\/code> after installation, don&#8217;t reinstall. Just run:<\/p>\n\n\n\n<pre class=\"wp-block-code\"><code>echo 'export PATH=\"$HOME\/.local\/bin:$PATH\"' &gt;&gt; ~\/.zshrc &amp;&amp; source ~\/.zshrc\n<\/code><\/pre>\n\n\n\n<p class=\"wp-block-paragraph\">That&#8217;s all it takes.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<h2 class=\"wp-block-heading\">What&#8217;s Next<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Now that Claude Code is running, I&#8217;m planning to use it for:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Building and iterating on my side projects faster<\/li>\n\n\n\n<li>Managing blog-related automation<\/li>\n\n\n\n<li>Exploring what&#8217;s possible without being a full-stack developer<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">I&#8217;ll keep sharing what I learn here. If you&#8217;re a non-engineer curious about AI dev tools, stick around \u2014 I&#8217;m figuring this out alongside you.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\"\/>\n\n\n\n<p class=\"wp-block-paragraph\"><em>Have questions or hit a different error? Drop a comment below. \ud83d\udc47<\/em><\/p>\n","protected":false},"excerpt":{"rendered":"<p>I&#8217;m not a software engineer. I&#8217;m a Technical Program Manager, which means I work around engineers every day \u2014 but I don&#8217;t usually write code myself. So when I decided to install Claude Code, Anthropic&#8217;s command-line AI tool, I expected it to be painful. It kind of was. But in a fixable way. Here&#8217;s exactly [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":2848,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_jetpack_memberships_contains_paid_content":false,"footnotes":""},"categories":[24],"tags":[],"class_list":["post-2847","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tech"],"jetpack_featured_media_url":"https:\/\/www.wakacin-lifestyle.com\/wp-content\/uploads\/2026\/06\/Facebook\u306e\u6295\u7a3f-How-I-Set-Up-Claude-Code.png","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/www.wakacin-lifestyle.com\/index.php?rest_route=\/wp\/v2\/posts\/2847","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.wakacin-lifestyle.com\/index.php?rest_route=\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.wakacin-lifestyle.com\/index.php?rest_route=\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.wakacin-lifestyle.com\/index.php?rest_route=\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.wakacin-lifestyle.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcomments&post=2847"}],"version-history":[{"count":2,"href":"https:\/\/www.wakacin-lifestyle.com\/index.php?rest_route=\/wp\/v2\/posts\/2847\/revisions"}],"predecessor-version":[{"id":2850,"href":"https:\/\/www.wakacin-lifestyle.com\/index.php?rest_route=\/wp\/v2\/posts\/2847\/revisions\/2850"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.wakacin-lifestyle.com\/index.php?rest_route=\/wp\/v2\/media\/2848"}],"wp:attachment":[{"href":"https:\/\/www.wakacin-lifestyle.com\/index.php?rest_route=%2Fwp%2Fv2%2Fmedia&parent=2847"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.wakacin-lifestyle.com\/index.php?rest_route=%2Fwp%2Fv2%2Fcategories&post=2847"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.wakacin-lifestyle.com\/index.php?rest_route=%2Fwp%2Fv2%2Ftags&post=2847"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}