AIToday
Large Language ModelsAI Coding AssistantsZenn AI/MLPublished: Oct 30, 2026, 06:00 JST

Claude Code v2.1.304: three first-run snags, recorded

Send on LINE
Claude Code v2.1.304: three first-run snags, recorded

3 Key Points

  1. What happened

    After the one-line install, v2.1.304 printed a Setup notes warning that ~/.local/bin was not on PATH, so typing claude failed until the displayed export line was run.

  2. Why it matters

    A fresh install can look complete while the claude command still fails, so first-time users on Linux need the displayed PATH step before the tool will launch.

Not sure about something? Ask the AI

Questions and answers are published on this page.

Summaries like this, every morning.

Context & Analysis

The walkthrough comes from Crystal Method, an AI company whose team uses Claude Code daily, and it follows a clean install in an empty practice folder containing just HTML, CSS, and JavaScript files. The recorded session ran on Linux with Opus 5.5 on the Claude Max plan, and from launch to the final edit report it took under a minute in that folder.

The three snags are all front-loaded: the PATH notice appears right after the install command, the trust-folder question comes on first launch, and the manual permission mode asks before even read-only commands. The team started with claude --permission-mode manual specifically to review each action, and the screen explained that the command's variables could not be checked before execution. For repeated prompts, the second on-screen option switches to an auto mode that decides automatically, though the team suggests reading what is about to happen before approving until you are comfortable.

The final task—changing the heading color to blue—showed Claude Code reading style.css and presenting the before (red) and after (green) side by side before asking to rewrite. After choosing Yes, it reported the change from #333333 dark gray to #0066cc blue in Japanese. The team points readers to a separate article for pricing, getting started, and the full set of capabilities.

FAQ
What do I do if claude says the command is not found after installing?
Run the displayed export PATH="$HOME/.local/bin:$PATH" line, then claude --version shows 2.1.304 (Claude Code). Add the same line to your shell config such as ~/.bashrc.
Which option is selected by default when Claude Code asks to trust a folder?
In this version the default is "No, exit." Pressing Enter exits Claude Code, so use the down arrow to choose "Yes, I trust this folder" for a folder you created.
Does Claude Code ask for permission even to read files?
Yes, in manual permission mode it asked before running commands to show the contents of three files, citing that the command's variables cannot be checked before execution.
Send on LINE

AI news that matters for your work, delivered every morning.

Pick your industry and the AI tools you use, and get news related to your work every day.

Free · 30 seconds with Google · unsubscribe anytimeWhat is AIToday? →

Ask AI

Ask AI anything about this article. The AI reads this article, earlier AIToday articles, and Wikipedia, and cites its sources. Q&As are published on this page for other readers too.

Questions and answers are published on this page.

Related Articles

Next articleYann LeCun: LLMs alone can't grasp a cup — world models are the missing layer