一行命令装好

Claude Code 实战手册（从 WSL 到进阶）

  1. 01. 从 Copilot 到 Claude Code：为什么值得换
  2. 02. 安装 WSL2：Windows 下的 Linux 开发环境
  3. 03. WSL 开发环境搭建：Node、Git、zsh、VS Code
  4. 04. 安装 Claude Code 并完成首次登录 👈 当前
  5. 05. 初次见面：项目初始化与 CLAUDE.md
  6. 06. 核心心智模型：上下文、权限与计划模式
  7. 07. 高效沟通：跳出 Copilot 式补全思维
  8. 08. 日常工作流：Bug 修复、新功能、重构、测试
  9. 09. 进阶武器：Slash Commands、Hooks、Subagents、MCP
  10. 10. 避坑与省钱：上下文管理与常见问题

前置条件不多：Node.js 18+（上一篇已经装好），一个在 claude.ai 注册过的账号，如果你打算按 token 付费还需要在 console.anthropic.com 生成一个 API Key。登录方式两种：订阅（Pro / Max）直接用订阅额度，个人日常用性价比最高；API Key 按 token 计费，适合重度使用或者公司账号走报销。

安装就是一条 npm 命令：

npm install -g @anthropic-ai/claude-code

装完随便进一个项目目录跑 claude，第一次启动会让你选登录方式。选订阅会打开浏览器跳转授权，WSL 里如果浏览器打不开没关系——它会给你一个 URL，复制到 Windows 浏览器打开完成授权就好。选 API 的话把 key 粘进去即可。

登录成功之后你会看到一个输入框。把它当一个能读你代码、能执行命令的智能队友直接用自然语言说话就行，比如：

> 这个项目是做什么的，用什么技术栈？

它会自己去 grep 和读文件，然后给你回答。

先记住这几个快捷键

Enter 发送消息；消息内换行用 Shift+Enter 或 \+Enter；Esc 中断当前任务，连按两次可以回到上一条消息编辑；Ctrl+D 或 /exit 退出 Claude Code。会话管理三个最重要：/clear 清空当前会话、/compact 把长对话压缩摘要、Shift+Tab 切换到 Plan Mode 让它只规划不动手。会话越长 token 越多、越贵、越慢、越容易出错，/clear 和 /compact 是你接下来每天会用到的工具。

权限的三档逻辑

第一次让它执行命令时会弹出三选项：单次允许、本项目永久允许这条命令（写入 .claude/settings.local.json）、拒绝并给反馈。初期建议所有命令都一次次批准，你会在这个过程中逐渐了解它的行为习惯——哪些操作它会自己主动做、哪些它会先问、什么是危险的。用熟之后给一些安全命令（比如 pnpm test、git status）永久放行，高频操作就不再弹窗。

也可以在启动时整体设置权限模式。claude --permission-mode acceptEdits 文件编辑自动放行、claude --permission-mode plan 只读什么都不让做、claude --dangerously-skip-permissions 全部放行。最后一个顾名思义只在一次性脚本或隔离容器里用，本地开发机上不要开。

跑两条简单任务验证

先问一个不涉及命令的问题："看一下这个项目的 README，一句话描述它做什么的。" 它能准确回答就说明读代码一路都通了。

再来个需要执行命令的："跑一下 pnpm install，然后用 pnpm dev 启动项目。" 它会先请求运行 pnpm install、等你批准、执行；再请求 pnpm dev、执行后在后台跑、把访问地址告诉你。这个流程跑通了就算完全就绪。

几个会真的遇到的坑

command not found: claude 意味着 npm 的全局 bin 目录没进 PATH。最快的修法：

echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

或者干脆用 npx @anthropic-ai/claude-code 直接跑。

企业网络或需要代理的环境下，设置 HTTPS_PROXY 和 HTTP_PROXY：

export HTTPS_PROXY=http://127.0.0.1:7890
export HTTP_PROXY=http://127.0.0.1:7890

国内网络访问 Claude API 需要代理，Windows 上开着 Clash 之类的话 WSL 还要额外配置——WSL 和 Windows 不是同一套网络栈，直接写 127.0.0.1 连不上 Windows 上的代理。要拿到 Windows 主机 IP 再配：

# 写进 ~/.zshrc
export hostip=$(cat /etc/resolv.conf | grep nameserver | awk '{ print $2 }')
export HTTPS_PROXY="http://$hostip:7890"
export HTTP_PROXY="http://$hostip:7890"

同时 Clash 里要把 "Allow LAN" 打开，不然 WSL 过去的请求会被拒。

登录成功但每次打开都要重新登，是凭证文件权限出了问题。ls -la ~/.claude/ 看看目录权限和磁盘状态，一般 chown 一下就好。

Claude Code 跑起来之后，下一篇讲怎么正式和它开始一个项目——CLAUDE.md 怎么写、/init 做了什么、它怎么理解你的代码库。

参考资料

版权声明: 如无特别声明，本文版权归 sshipanoo 所有，转载请注明本文链接。

（采用 CC BY-NC-SA 4.0 许可协议进行授权）

本文标题:安装 Claude Code 并完成首次登录

本文链接:https://www.sshipanoo.com/blog/ai/claude-code/04-安装Claude-Code/

本文最后一次更新为 天前，文章中的某些内容可能已过时！

目录