零基础也能上手，Claude Code 安装配置与首次运行全指南

为什么编程高手都爱用终端新手也能上手的 AI 助手很多刚接触编程的朋友看到黑底白字的命令行窗口Terminal往往会心里发怵觉得那是只有黑客或者资深工程师才敢碰的“禁区”。大家更习惯点击图形化按钮、拖拽文件的直观操作。但事实上终端才是计算机最本质、最高效的交互界面。对于现在的 AI 编程工具来说终端更是它们的“原生家园”。今天要介绍的Claude Code就是 Anthropic 推出的一款运行在终端里的 AI 编程助手。它不像传统的 IDE 插件那样只是在你打字时给点建议而是像一个真正的结对程序员能直接读取你的项目文件、理解整体架构甚至帮你执行命令、修改代码、运行测试。你可能会问“我连环境都不会配能用好这么‘极客’的工具吗”答案是肯定的。只要跟着本文的步骤哪怕你从未敲过一行命令也能在 Windows 或 Mac 上轻松把它跑起来体验让 AI 帮你写代码、改 Bug 的快感。我们将从零开始一步步拆解安装、配置到首次对话的全过程特别针对国内网络环境提供了稳定的接入方案确保你能顺利开启第一次 AI 编程之旅。动手前的准备只需两个基础软件在正式安装 Claude Code 之前我们需要确保电脑里有两个基础的“地基”软件。别担心这两个软件非常通用即使你不做开发电脑里可能也已经有了。1. 检查 Node.js 环境Claude Code 是基于 Node.js 运行的所以这是必选项。Windows 用户访问 Node.js 官网下载 LTS长期支持版本安装包一路点击“下一步”即可。安装完成后按下Win R输入cmd回车在黑窗口里输入node -v。如果显示了类似v20.x.x的版本号说明安装成功。Mac 用户打开“终端”可以在“启动台”或搜索栏找到输入node -v。如果有版本号则无需操作如果提示“命令未找到”可以通过 Homebrew 输入brew install node安装或者直接去官网下载 pkg 安装包。2. 确认 Git 工具可选但推荐虽然 Claude Code 核心功能不强制依赖 Git但在实际项目中它经常需要配合版本控制来管理代码变更。Windows推荐安装Git for Windows安装时保持默认选项即可。Mac通常在终端输入git --version时系统会提示你安装命令行工具按提示操作即可。一键安装与核心配置打通国内访问链路准备工作就绪后我们就可以开始安装主角了。这里有一个关键点由于网络原因直接连接官方服务可能会不稳定或无法访问。为了让新手朋友能顺畅使用我们将采用国内云厂商提供的中转代理服务如阿里云百炼或蓝耘 MaaS。这种方式不仅速度快而且配置简单完全不需要你去折腾复杂的网络设置。第一步通过 npm 安装工具打开你的命令行工具Windows 上是 CMD 或 PowerShellMac 上是终端输入以下命令并回车npminstall-ganthropic-ai/claude-code你会看到屏幕上滚动一些下载进度条。等待几分钟当最后显示added X packages字样时说明安装成功了。此时你可以在任意目录输入claude -v来验证如果能输出版本号就说明工具已就位。第二步配置代理地址与 API Key这是最关键的一步。我们需要告诉 Claude Code 去哪里获取智能服务。这里以通用的配置逻辑为例具体 API Key 需你在相应的云服务平台注册获取获取凭证登录阿里云百炼或蓝耘 MaaS 平台创建一个 API Key。这就像你的“通行证”。创建配置文件Windows在文件资源管理器地址栏输入%USERPROFILE%\.claude并回车。如果没有settings.json文件就新建一个文本文件并重命名为settings.json。Mac/Linux在终端输入mkdir -p ~/.claude然后输入nano ~/.claude/settings.json编辑文件。填入配置信息将以下内容复制进settings.json文件中记得把你的_API_Key_在这里替换成你刚才复制的真实密钥并将BASE_URL替换为你所使用平台提供的地址{env:{ANTHROPIC_AUTH_TOKEN:你的_API_Key_在这里,ANTHROPIC_BASE_URL:https://coding.dashscope.aliyuncs.com/apps/anthropic,ANTHROPIC_DEFAULT_MODEL:claude-sonnet-4-5-20250929}}小贴士JSON 格式对标点很敏感确保花括号、引号和逗号都是英文半角符号最后一行不要有多余的逗号。跳过新手引导为了让启动更顺畅建议在用户主目录下再创建一个.claude.json文件Windows 路径为C:\Users\你的用户名\.claude.json写入以下内容{hasCompletedOnboarding:true}首次启动实录授权、信任与状态检查配置完成后激动人心的时刻到了。让我们进入一个空文件夹比如桌面上新建的test-project文件夹在终端中输入cd加上空格然后把文件夹拖进终端窗口这样路径就自动填好了。接着输入claude1. 授权与信任确认首次运行时你会看到一段欢迎语紧接着它会询问是否允许访问当前目录的文件。这是为了让他能读取你的代码上下文。屏幕会显示Allow Claude Code to access files in this directory?请直接输入y或选择Yes并回车。接下来可能会询问是否信任该工作目录同样确认即可。这一步是安全机制确保 AI 不会随意读写你电脑的其他隐私文件。2. 验证连接状态进入对话界面后先别急着写代码。为了确保刚才的代理配置生效我们可以输入一个斜杠命令来查看状态/status如果配置正确你会看到当前连接的模型名称、Base URL 地址以及 API Key 的状态显示为正常。如果这里报错通常意味着 API Key 填写有误或网络地址不通请回头检查settings.json的内容。3. 第一个 Hello World 对话现在你可以像和朋友聊天一样给它下指令了。试着输入“帮我写一个简单的 Python 脚本打印出’Hello, Claude Code!并保存为 hello.py。”你会发现它不仅在对话框里回复了你还会直接在当前的文件夹里生成hello.py文件并显示具体的代码差异。你可以直接在这个终端窗口里看到它“思考”和“操作”的过程这种透明感是网页版聊天机器人无法比拟的。新手避坑指南常见报错与排查清单在使用初期遇到一些问题是很正常的。以下是几个高频报错及其解决方法帮你快速排雷问题现象可能原因解决方案Network Timeout / 连接超时代理地址失效或网络波动检查settings.json中的ANTHROPIC_BASE_URL是否正确尝试更换一个 API Key 或稍后重试。Permission Denied / 权限拒绝终端没有写入文件的权限确保你是在自己创建的文件夹如桌面项目中运行不要在系统目录如C:\Program Files下操作。Windows 用户可尝试以管理员身份运行终端。Command not found: claude环境变量未生效安装完成后务必关闭并重新打开终端窗口让新的环境变量加载进来。Invalid JSON in settings配置文件格式错误仔细检查settings.json确保没有中文标点键名必须用双引号包裹最后一个属性后不能有逗号。Model not found模型名称不匹配检查配置中的ANTHROPIC_DEFAULT_MODEL是否是你所购服务支持的模型名称不同平台支持的模型列表可能不同。如果在操作中卡住了随时可以使用/clear命令清空当前对话上下文重新开始或者输入/doctor让工具自动检测一下自身的安装状态。结语从“怕命令行”到“驾驭 AI”走完这一整套流程相信你已经发现所谓的“终端工具”并没有那么可怕。相反它提供了一种更直接、更高效的与计算机沟通的方式。Claude Code 的强大之处不在于它有多复杂的命令而在于它能听懂你的人话并帮你在终端里完成繁琐的代码工作。对于零基础的新手来说迈出这一步的意义在于你不再需要死记硬背语法也不必在无数个网页标签页中查找教程。你只需要专注于“我想做什么”然后告诉身边的这位 AI 伙伴。从今天起试着把那些重复的样板代码、令人头秃的 Bug 修复交给它让自己更多地享受创造的乐趣。当你熟练掌握了这些基础操作你会发现编程的世界其实比你想象的更加广阔和有趣。