从安装到第一次对话全程不超过 5 分钟。你只需要一个终端和一份好奇心。1. 安装前的准备Claude Code 对运行环境的要求非常宽容绝大多数现代开发机器都能直接使用。系统要求项目最低要求推荐操作系统macOS 11 / Linux (glibc 2.28)macOS 14 / Ubuntu 22.04WindowsWSL2 (Ubuntu)WSL2 最新内核Node.js不依赖 Node独立二进制—网络能访问 api.anthropic.com稳定的国际网络终端支持 UTF-8 和颜色iTerm2 / Windows Terminal / AlacrittyWindows 用户注意官方未提供原生 Windows 版本但通过 WSL2 可以完美运行。后续所有命令均基于 Unix 风格。你需要准备的账户Anthropic 控制台账号访问 console.anthropic.com 注册可能需要国际手机号验证。API Key登录后在API Keys页面创建一个新密钥保存好只显示一次。可选信用卡Claude Code 目前按 Token 用量计费新用户通常有免费额度但长期使用需绑定付费方式。2. 第 1 步安装 Claude Code CLI官方推荐使用 npm或 bun、yarn、pnpm全局安装安装包体积约 50 MB内含完整的 Bun 运行时和 CLI 程序。npminstall-ganthropic-ai/claude-code国内用户如果遇到网络慢可以使用镜像或先配置 npm registrynpminstall-ganthropic-ai/claude-code--registryhttps://registry.npmmirror.com安装完成后验证是否成功claude--version如果输出版本号如0.1.5说明安装成功。其他安装方式按需选择Homebrew (macOS)brew install anthropic-ai/tap/claude-code从 GitHub Releases 下载直接下载二进制文件放到PATH下3. 第 2 步初始化并登录首次运行claude命令时CLI 会自动引导你完成身份认证。claude终端会输出类似Welcome to Claude Code! Please authenticate with Anthropic: 1. Press Enter to open browser and log in...两种认证方式方式一浏览器登录推荐按回车后系统会打开浏览器跳转到 Anthropic 授权页面。登录你的账号授权 CLI 访问权限页面会显示一个“授权成功”的提示然后终端自动继续。方式二使用 API Key适合无 GUI 环境如果你在纯终端环境如 SSH 远程服务器可以用 API Key 直接认证claude auth login然后粘贴你预先创建的 API Key回车即可。认证成功后CLI 会生成一个本地配置文件~/.anthropic/claude-code.json以后不再需要重复登录。4. 第 3 步进入项目目录开始第一次对话Claude Code 的设计哲学是“每个项目一个独立的 AI 会话上下文”。你需要先进入一个 Git 仓库或任意目录然后启动。cdyour-project# 可以是新目录或已有代码claude启动后你会看到类似这样的提示符Claude Code 光标旁边有一个符号表示等待你的输入。第一个指令测试是否正常工作输入打印当前目录下的文件列表Claude Code 会调用内置的ls或Read工具然后输出你目录中的文件。如果正常返回结果说明一切就绪。试试真正有用的指令用注释帮我分析一下这个项目是做什么的不需要改代码AI 会读取package.json、README.md、入口文件等给你一份项目摘要。5. 核心概念CLAUDE.md—— 你的项目“说明书”在运行claude的目录下你可以创建一个名为CLAUDE.md的文件或.claude/CLAUDE.md。这个文件会被自动加载到系统提示词中告诉 AI 关于项目的关键信息。示例CLAUDE.md内容# 项目My API Service ## 技术栈 - Node.js 20 TypeScript - Express 框架 - Prisma ORM PostgreSQL ## 常用命令 - npm run dev启动开发服务器监听 3000 端口 - npm test运行单元测试Jest - npm run build编译 TypeScript ## 代码规范 - 使用 ESLint Prettier - 函数命名采用 camelCase - 所有 API 路由定义在 src/routes/ 下 ## 注意事项 - 不要直接修改 prisma/schema.prisma 而不运行迁移 - 环境变量写在 .env.local不要提交到 Git有了这份文件AI 会自动知道npm run dev是启动服务器在生成代码时遵守命名规范避免提出会破坏 Prisma 迁移的建议 强烈建议将CLAUDE.md提交到 Git 仓库团队成员共享同一份 AI 行为指南。6. 检查点你可能遇到的小问题问题可能原因解决方法command not found: claudenpm 全局安装路径未加入 PATHexport PATH$PATH:$(npm prefix -g)/bin并添加到 shell 配置认证后仍提示unauthorizedAPI Key 无效或过期重新生成 API Key重新运行claude auth login第一次对话响应极慢首次需下载模型缓存等待 10-20 秒即可后续会快很多提示Model not available所在地区模型访问受限使用代理或切换到支持的 regionWindows 下卡在启动WSL2 未安装或网络问题确保 WSL2 内可以curl https://api.anthropic.com通7. 第一次会话后退出与下次使用退出 Claude Code输入/exit或按Ctrl C两次。下次再进入再次运行cd your-project claudeAI 会记住上一次对话的摘要如果开启了项目记忆。你可以随时用/clear清空当前会话历史或/compact压缩上下文节省 token。8. 你已经拥有了什么完成这 3 步之后你的终端里就多了一位AI 工程师✅ 可以读取整个项目的文件✅ 可以执行 shell 命令✅ 可以创建/修改/删除文件需你授权✅ 能够记住项目特定的规范和命令通过CLAUDE.md接下来的所有高级功能MCP 扩展、Agent 模式、GitHub 集成、CI/CD 自动审查等都建立在今天的基础上。9. 下篇预告你已经可以运行 Claude Code 并让它帮你做一些事了。但要想真正驾驭它你需要了解那5 个最常用的斜杠命令——它们控制着 AI 的行为模式、上下文压缩、成本统计等关键功能。下一篇必知必会的5个核心斜杠命令/help、/compact、/clear、/cost、/exit思考题自测理解为什么推荐将CLAUDE.md提交到 Git 仓库团队使用时会有什么好处如果你的项目需要特殊的构建环境比如依赖 Docker如何在CLAUDE.md中描述清楚首次运行claude后配置文件存储在哪里如果更换电脑如何迁移认证信息下一篇文章我们将深入每个斜杠命令的真实使用场景包括/cost如何帮你控制预算。敬请期待。
第二篇：3步搞定安装与初始化：从零开始运行Claude Code
发布时间：2026/5/21 14:50:17
从安装到第一次对话全程不超过 5 分钟。你只需要一个终端和一份好奇心。1. 安装前的准备Claude Code 对运行环境的要求非常宽容绝大多数现代开发机器都能直接使用。系统要求项目最低要求推荐操作系统macOS 11 / Linux (glibc 2.28)macOS 14 / Ubuntu 22.04WindowsWSL2 (Ubuntu)WSL2 最新内核Node.js不依赖 Node独立二进制—网络能访问 api.anthropic.com稳定的国际网络终端支持 UTF-8 和颜色iTerm2 / Windows Terminal / AlacrittyWindows 用户注意官方未提供原生 Windows 版本但通过 WSL2 可以完美运行。后续所有命令均基于 Unix 风格。你需要准备的账户Anthropic 控制台账号访问 console.anthropic.com 注册可能需要国际手机号验证。API Key登录后在API Keys页面创建一个新密钥保存好只显示一次。可选信用卡Claude Code 目前按 Token 用量计费新用户通常有免费额度但长期使用需绑定付费方式。2. 第 1 步安装 Claude Code CLI官方推荐使用 npm或 bun、yarn、pnpm全局安装安装包体积约 50 MB内含完整的 Bun 运行时和 CLI 程序。npminstall-ganthropic-ai/claude-code国内用户如果遇到网络慢可以使用镜像或先配置 npm registrynpminstall-ganthropic-ai/claude-code--registryhttps://registry.npmmirror.com安装完成后验证是否成功claude--version如果输出版本号如0.1.5说明安装成功。其他安装方式按需选择Homebrew (macOS)brew install anthropic-ai/tap/claude-code从 GitHub Releases 下载直接下载二进制文件放到PATH下3. 第 2 步初始化并登录首次运行claude命令时CLI 会自动引导你完成身份认证。claude终端会输出类似Welcome to Claude Code! Please authenticate with Anthropic: 1. Press Enter to open browser and log in...两种认证方式方式一浏览器登录推荐按回车后系统会打开浏览器跳转到 Anthropic 授权页面。登录你的账号授权 CLI 访问权限页面会显示一个“授权成功”的提示然后终端自动继续。方式二使用 API Key适合无 GUI 环境如果你在纯终端环境如 SSH 远程服务器可以用 API Key 直接认证claude auth login然后粘贴你预先创建的 API Key回车即可。认证成功后CLI 会生成一个本地配置文件~/.anthropic/claude-code.json以后不再需要重复登录。4. 第 3 步进入项目目录开始第一次对话Claude Code 的设计哲学是“每个项目一个独立的 AI 会话上下文”。你需要先进入一个 Git 仓库或任意目录然后启动。cdyour-project# 可以是新目录或已有代码claude启动后你会看到类似这样的提示符Claude Code 光标旁边有一个符号表示等待你的输入。第一个指令测试是否正常工作输入打印当前目录下的文件列表Claude Code 会调用内置的ls或Read工具然后输出你目录中的文件。如果正常返回结果说明一切就绪。试试真正有用的指令用注释帮我分析一下这个项目是做什么的不需要改代码AI 会读取package.json、README.md、入口文件等给你一份项目摘要。5. 核心概念CLAUDE.md—— 你的项目“说明书”在运行claude的目录下你可以创建一个名为CLAUDE.md的文件或.claude/CLAUDE.md。这个文件会被自动加载到系统提示词中告诉 AI 关于项目的关键信息。示例CLAUDE.md内容# 项目My API Service ## 技术栈 - Node.js 20 TypeScript - Express 框架 - Prisma ORM PostgreSQL ## 常用命令 - npm run dev启动开发服务器监听 3000 端口 - npm test运行单元测试Jest - npm run build编译 TypeScript ## 代码规范 - 使用 ESLint Prettier - 函数命名采用 camelCase - 所有 API 路由定义在 src/routes/ 下 ## 注意事项 - 不要直接修改 prisma/schema.prisma 而不运行迁移 - 环境变量写在 .env.local不要提交到 Git有了这份文件AI 会自动知道npm run dev是启动服务器在生成代码时遵守命名规范避免提出会破坏 Prisma 迁移的建议 强烈建议将CLAUDE.md提交到 Git 仓库团队成员共享同一份 AI 行为指南。6. 检查点你可能遇到的小问题问题可能原因解决方法command not found: claudenpm 全局安装路径未加入 PATHexport PATH$PATH:$(npm prefix -g)/bin并添加到 shell 配置认证后仍提示unauthorizedAPI Key 无效或过期重新生成 API Key重新运行claude auth login第一次对话响应极慢首次需下载模型缓存等待 10-20 秒即可后续会快很多提示Model not available所在地区模型访问受限使用代理或切换到支持的 regionWindows 下卡在启动WSL2 未安装或网络问题确保 WSL2 内可以curl https://api.anthropic.com通7. 第一次会话后退出与下次使用退出 Claude Code输入/exit或按Ctrl C两次。下次再进入再次运行cd your-project claudeAI 会记住上一次对话的摘要如果开启了项目记忆。你可以随时用/clear清空当前会话历史或/compact压缩上下文节省 token。8. 你已经拥有了什么完成这 3 步之后你的终端里就多了一位AI 工程师✅ 可以读取整个项目的文件✅ 可以执行 shell 命令✅ 可以创建/修改/删除文件需你授权✅ 能够记住项目特定的规范和命令通过CLAUDE.md接下来的所有高级功能MCP 扩展、Agent 模式、GitHub 集成、CI/CD 自动审查等都建立在今天的基础上。9. 下篇预告你已经可以运行 Claude Code 并让它帮你做一些事了。但要想真正驾驭它你需要了解那5 个最常用的斜杠命令——它们控制着 AI 的行为模式、上下文压缩、成本统计等关键功能。下一篇必知必会的5个核心斜杠命令/help、/compact、/clear、/cost、/exit思考题自测理解为什么推荐将CLAUDE.md提交到 Git 仓库团队使用时会有什么好处如果你的项目需要特殊的构建环境比如依赖 Docker如何在CLAUDE.md中描述清楚首次运行claude后配置文件存储在哪里如果更换电脑如何迁移认证信息下一篇文章我们将深入每个斜杠命令的真实使用场景包括/cost如何帮你控制预算。敬请期待。
