何为自律1. 先从终端认识 Claude Code
我在本地项目里跑 claude 这行命令之前，其实已经见过不少“AI 编程助手”：网页聊天、IDE 补全、自动生成 PR 的机器人。Claude Code 给我的第一感觉和这些都不太一样——它不是插在编辑器边上的小翅膀，而是直接住在终端里、能真正把代码仓库当“现场”来操作的一个命令行智能体。简单说，你打开终端进入项目目录，敲 claude，它就能读你的文件、看 git 状态、自己翻代码、改文件、跑测试，甚至一条龙把 commit 都提交了。
从零开始学 Claude Code，最关键的是先建立正确预期：它是“会干活的 agent”，不是“会聊天的对话框”。它的默认工作方式不是一次性丢一大段完整代码给你，而是把任务拆成很多小步，一边做一边向你汇报，需要权限的时候找你确认。正因如此，很多重复性、机械性的开发工作，比如写单元测试、重构公共函数、排查 CI 报错，都能交给它，而且比你自己一个个文件翻要快得多。
1.1 它和普通网页版有什么区别
Claude Code 底层用的还是 Anthropic 的 Claude 模型，所以你会感觉“对话能力”和网页版差不了太多，但它多出来的是三样东西：文件系统访问、命令执行能力、项目上下文。网页版你只能一段段贴代码，它只能猜你项目长什么样；Claude Code 则是自己进到目录里看，知道你有几个 package、哪些测试挂了、最近改了什么。这不是把代码复制进上下文的“伪现场”，而是真正在项目里运行的工具集。
还有一个本质区别：Claude Code 会真的去执行命令。比如你让它“跑一遍测试并修复失败用例”，它可能会先执行 npm test，看到失败输出再定位到对应源码修改，改完再跑一次验证。这个“读取 → 行动 → 验证”的循环，是它和普通聊天助手最大的分水岭。也正因为可以执行命令，它比网页版更需要你在权限上把好关。
1.2 哪些人现在适合上手
适合谁呢？三类人最值回票价：一是日常要写大量样板代码或测试的工程师；二是刚接手陌生项目、需要快速读懂代码库的开发者；三是喜欢在终端里工作、不想在 IDE 和网页之间来回切换效率流失的人。完全零基础也可以入，前提是至少会基本命令行操作，不然容易在权限确认和环境配置阶段被卡住。
这一点很重要，我在别的地方吃过亏：Claude Code 可以执行 shell 命令，所以不要一上来就在生产环境目录里让它“放开了干”。第一次使用建议先开个临时 demo 项目摸清它的脾气。好，现在你应该对“它是什么”有了整体认知。接下来是动手前必须解决的门槛：账号和环境。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 安装前准备与三种接入方式
2.1 Claude Code 不是独立计费的软件
很多人搜“claude code下载”“claude code安装”，第一反应是找安装包。其实 Claude Code 并没有一个单独的“客户端安装包”，它就是一个命令行工具，通过 npm 全局安装或官方脚本安装。先说清楚，安装它本身是免费的，但真正使用 Claude 模型，你有两条路：一是开通 Claude Pro 或 Max 订阅，登录授权后使用；二是使用 Anthropic API，按 token 用量付费。
这也解释了为什么网上没有“claude code 免费版”这种说法——它不是一个独立订阅产品。网上偶尔能看到“free claude code 安装”的教程，本质上是两个方向：要么用的是订阅套餐自带的额度，要么是通过第三方兼容层把 Claude Code 接到本地模型或其他模型服务上，后者我会在后面单独讲。新人建议先老老实实走订阅或官方 API 一条路，把主流程跑通，再折腾模型替换。
我的建议是：如果你是重度开发者，每个月用 Claude Code 干很多活，Max 订阅往往更划算；如果只是偶尔体验、或者想把它接进自动化脚本里高频调用，API 按量付费更灵活。注意不要把 API Key 提交到 git 仓库，Claude Code 的报错里有相当一部分就是鉴权失败导致，后面排查部分我会专门列。
2.2 环境要求：先检查 Node.js
Claude Code 是基于 Node.js 的命令行工具，官方推荐版本通常是 Node 18 以上。你先在终端里跑一下：
bash复制node -v
npm -v
如果 node 命令不存在，或者版本太老，先去官网把 Node.js 装好，LTS 版本即可。这一步不要贪新装奇怪的版本，Claude Code 在部分尚不稳定的 Node 最新版上偶尔会有兼容问题，LTS 是最稳的选择。
Windows 用户还要额外留意终端环境。我推荐直接用 Windows Terminal 或 VS Code 内置终端，别用老旧的 cmd.exe。原因是 Claude Code 的交互显示里有不少特殊字符和颜色，老终端不仅显示难看，还容易出现乱码，这个我在第 8 节会专门给解决方案。
2.3 选择订阅授权还是 API Key
登录方式决定了你后面的环境变量配置。走订阅授权，通常在第一次运行 claude 的时候会弹出浏览器，让你登录 Claude 账号并授权，完成后本地会保存一个凭证，之后打开就能直接用。走 API，则需要设置一个环境变量：
bash复制export ANTHROPIC_API_KEY="你的key"
Windows PowerShell 对应的写法是：
powershell复制$env:ANTHROPIC_API_KEY = "你的key"
需要注意，新版 Claude Code 对“订阅授权”和“API Key”两套逻辑做了区分。如果你两边都配置