10 分钟让 Claude Code 在终端跑起来：安装、认证与首次对话
【免费下载链接】claude-codeClaude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code
Claude Code 是一个住在你终端里的 AI 编码助手：你用自然语言下指令，它负责读代码库、跑常规任务、解释复杂代码、处理 git 流程。装好之后，"帮我看看这个报错"就能变成一句终端命令，下面带你从零走到跑通。
开始之前：环境自检
不用装一堆东西，花 30 秒确认这几样就行：
| 要确认的 | 缺了去哪补 |
|---|---|
| Node.js 18 及以上 | Node.js 官网下载 LTS 版 |
| npm 包管理器 | 随 Node.js 一起装好 |
| Anthropic 账号 | 首次登录 OAuth 认证要用，提前注册 |
Windows 用户稍后走 PowerShell 通道，流程和下面一致。
一条命令装好 Claude Code
官方安装脚本负责下载、解压、配置一条龙：
curl -fsSL https://claude.ai/install.sh | bash看到安装完成的回显、记下它提示的安装目录就对了。macOS 也可以换 Homebrew 渠道，Windows 在 PowerShell 里有一行对应的安装命令，效果和这条一样。老教程里的 npm 全局安装方式官方已经标为弃用，不建议再走。全程用普通用户账号操作就行，完全用不到管理员权限。
配置环节：能省则省
Claude Code 基本没有传统意义上的配置文件，装完先验证一下：
claude --version能打出版本号就说明安装到位。认证留到首次运行时再做，这里不用提前折腾；如果你不打算走账号登录、而是拿 API Key 直连，提前把环境变量 ANTHROPIC_API_KEY 设好即可，其余全部保持默认。
跑通第一次对话
进到任意项目目录，只敲一个词：
claude首次运行会拉起 OAuth 认证，浏览器打开后用 Anthropic 账号登录一次，这是唯一需要你手动介入的环节。认证通过后回到终端输入框，直接说人话——"解释一下这个目录的代码结构"，它会开始读你的仓库并作答。⚠️ 如果浏览器没自动弹出，终端里会打印一条链接，复制进浏览器手动完成登录即可。
踩坑速查
claude: command not found：PATH 没刷新，关掉终端重开再试，别急着重装。
npm 安装报 EACCES 权限错误：别拿 sudo 硬怼，换官方安装脚本最干净。
认证页反复跳不进去：确认浏览器和终端里用的是同一个账号，或直接复制终端打印的 URL 打开。
装通之后，先让它通读一遍你的代码库试试手，仓库里的 plugins 目录还有不少现成扩展可以挑；再深的问题，官方文档和社区见。
【免费下载链接】claude-codeClaude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.项目地址: https://gitcode.com/GitHub_Trending/cl/claude-code
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
