Claude Code 入门：从安装到上手

2026-08-02约 8 分钟驭光者首发于微信公众号「羲和Lab」

系列第00篇 · 新手第一篇，从零跑通阅读时长：约 10 分钟 · 难度：零基础

开场：这篇为什么是第00篇

《智能编码进化论》系列已经写了十几篇进阶用法，从 Agent 多智能体协作到 Hooks 自动化，讲得越来越深。但有读者反馈：我也想用，可是没装。

这就尴尬了。系列再好，新读者卡在安装这关就走了。

所以这篇回到最前面，补上缺失的入口：装好 Claude Code，跑通第一次对话，记住几个常用命令，顺手了再去看进阶篇。

本文是《智能编码进化论》系列的第00篇——真正的新手起点。

一、Claude Code 是什么

一句话：跑在终端里的 AI 编程 agent。

如果你对"agent"这个词感到陌生，可以这样理解——想象一个能读懂你整个项目代码、自己规划怎么完成任务、动手写代码改文件、跑命令验证结果的智能机器人。它不只是陪聊天的 AI，而是能独立交付的工程师。

这里有个核心理念差异，先说清楚。你可能用过 Cursor、GitHub Copilot 这类工具，它们属于"副驾驶"模式：你写代码，它补全、给建议，方向由你把握。Claude Code 走的是另一条路——代理模式。你告诉它目标，它自己拆解任务、执行、验证，最后交付成果。

打个比方：副驾驶像是坐在你旁边帮你查资料的助手，代理像是你交给任务的工程师。

它是给你招了个能独立干活的工程师，不是配了个打字快的助手。

二、装之前：选你的认证姿势

Claude Code 有两种用法，装之前先选适合你的。

姿势A：订阅版（Claude Pro / Max）

你已经有 Claude.ai 的付费订阅
启动后浏览器登录授权，最省事
注意：免费 Claude.ai 计划不支持 Claude Code

姿势B：API版（自有 key）

你在 Anthropic Console 有预付费账户，按 token 计费（token 是 AI 处理文本的计量单位，1 token 约等于大半个汉字，用多少花多少）
需要走代理、CI/CD 等无浏览器环境
通过 ANTHROPIC_API_KEY 环境变量传入

姿势C：国产渠道（国内用户推荐）

国内用户走姿势 A/B 有现实门槛：Anthropic 官方接口无法直连（要代理）、订阅要海外支付方式。好消息是智谱 GLM、通义千问、DeepSeek 都已提供 Anthropic 兼容接口，Claude Code 能直连；而且国产模型单价约为 Claude 的 1/20，学习试用成本极低。

设两个环境变量就行（以智谱 GLM 为例）：

export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic
export ANTHROPIC_API_KEY=你的智谱key

其他渠道只换 BASE_URL：

渠道	ANTHROPIC_BASE_URL
智谱 GLM	`https://open.bigmodel.cn/api/anthropic`
通义千问（百炼）	`https://coding.dashscope.aliyuncs.com/apps/anthropic`
DeepSeek	`https://api.deepseek.com`

不想每次 export，写进 ~/.claude/settings.json 一劳永逸：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://open.bigmodel.cn/api/anthropic",
    "ANTHROPIC_API_KEY": "你的key"
  }
}

进阶玩法：用 LiteLLM / New API 这类中转把多个国产模型聚合，按场景切换（编码用 GLM、检索用 DeepSeek），原理一样——把 ANTHROPIC_BASE_URL 指向中转端点。这部分系列后续专门讲。

⚠️ 一个坑：部分国产模型不支持 Claude 的"深度思考"参数，遇到报错设 CLAUDE_CODE_DISABLE_THINKING=1 规避。

怎么选：国内个人开发推荐姿势 C（智谱/通义/DeepSeek，性价比高、无网络门槛）；有 Claude Pro/Max 订阅选 A，企业 CI/CD 选 B。三种方式本文都讲。

三、三步装好

推荐方式：原生安装

原生安装会自动配置后台更新，后续省心。

macOS / Linux / WSL：

curl -fsSL https://claude.ai/install.sh | bash

Windows PowerShell：

irm https://claude.ai/install.ps1 | iex

备选安装方式：

方式	命令	适合场景
Homebrew (macOS)	`brew install --cask claude-code`	习惯用 brew 管理工具
WinGet (Windows)	`winget install Anthropic.ClaudeCode`	习惯用 WinGet 管理工具
npm（已不推荐）	`npm install -g @anthropic-ai/claude-code`	已有 Node.js 22+；官方已标记 deprecated，建议优先用原生安装

系统要求：macOS 13+、Windows 10 1809+、Ubuntu 20.04+；内存 4GB 以上；需要联网。

装完你验证一下。终端输入：

claude --version

看到版本号就说明装好了。

四、首次启动：在沙盒里跑通

重要提醒：第一次试，请在一个测试目录里操作，别直接在重要项目上跑。

你先建个练习场：

mkdir claude-code-playground && cd claude-code-playground
git init
claude

启动后：

订阅版会自动弹出浏览器让你登录
API 版 / 国产渠道版：先按第二章设好 ANTHROPIC_API_KEY（国产渠道再加 ANTHROPIC_BASE_URL），然后直接运行 claude，无需登录

登录成功后，你会看到 Claude Code 的对话提示符。可以开始对话了。

第一次对话建议（先读后写，循序渐进）：

先让它解释一个命令：输入 explain what git status does
再让它做一件安全的小事：create a README.md to introduce this playground
观察它怎么理解你的意图、怎么执行

关键安全机制：Claude Code 在修改代码、执行命令之前，会弹出确认提示 (yes/no/explain) 等你批准。新手期全部手动确认——看懂它要做什么再按 yes，它不会在你不知情的情况下乱改文件。

这就是它的安全护栏：读代码不需要确认，改代码、跑命令必须过你这一关。

五、常用命令速查

数据来源：扫描 104 个真实会话统计频率。入门篇只讲"维持对话 + 基础排障"，高级命令留到后续篇。

🆘 会话急救包

/clear（出现 39 次）— 清空当前上下文。你换任务前先 /clear 一下，防止上一次对话的内容干扰下一次
/compact（15 次）— 压缩上下文保留摘要。对话太长时用，相当于"续命"

📁 会话档案员

/rename（73 次，全场最高频）— 给当前会话起个名字，方便以后找回来
/resume — 恢复之前的会话，接着聊
/fork（3 次）— 基于当前会话的摘要开一个新会话继续。适合想换个方向探索，又不想丢失当前进度

🔧 基础排障

/model（6 次）— 切换模型（Opus / Sonnet / Haiku），不同任务选不同模型
/config（5 次）— 修改设置项（模型偏好、权限模式等）
/doctor（4 次）— 配置体检，自检安装状态和环境健康
/login /logout（合计 10 次）— 认证管理

记住 /clear 和 /rename 这两个，你已经比一半用户用得顺。

想学 /mcp、/focus、/goal、/code-review 这些高级命令？它们在系列后续篇里各有专章，先把基础跑顺。

六、一个必须懂的概念：CLAUDE.md

装好 Claude Code 后，第一件事：在你的项目根目录建一个 CLAUDE.md 文件。

这个文件是 AI 的"岗位说明书"。你在里面写清楚：项目用什么技术栈、代码风格怎样、哪些事不能做。写一次，以后每轮对话 AI 都自动读取并遵守，不用重复交代。

举个例子，你在 CLAUDE.md 里写上"所有 API 返回统一用 {"code": 0, "data": {}} 格式"，AI 帮你写接口代码时就会自动按这个格式来，不用你每次提醒。

本文不展开讲怎么写，完整的写法和最佳实践，看系列02篇《AI岗位说明书：CLAUDE.md精讲》。

七、常见坑与解法

问题	解法
`command not found: claude`	`~/.local/bin` 不在 PATH 中，加到 shell 配置文件（如 `~/.zshrc`）
安装脚本返回 HTML 或 403	网络或地区限制，换 Homebrew / WinGet 安装，或配置代理
Windows 装好了但打开是 Desktop 应用	Claude Desktop 版本过旧，更新到最新版
OAuth 登录失败（WSL / SSH 环境）	按提示按 `c` 复制 URL，在浏览器中手动打开完成授权
环境变量覆盖了订阅登录	`unset ANTHROPIC_API_KEY` 再启动
装完不知道哪里有问题	跑 `claude doctor` 自检，它会打印诊断结果和修复建议

万能诊断命令：遇到任何安装问题，先跑 claude doctor。

八、卸载与更新

装了之后后悔了怎么办？放心试，它来去自由。

更新：原生安装方式会自动后台更新，下次启动时生效。也可以手动重跑安装脚本覆盖安装。

卸载：

macOS / Linux（原生安装）：删除二进制文件 rm $(which claude)，再删除配置目录 rm -rf ~/.claude
Windows（原生安装）：设置 → 应用 → 已安装的应用中卸载；或手动删除配置目录 %USERPROFILE%\.claude
npm 安装：npm uninstall -g @anthropic-ai/claude-code
Homebrew 安装：brew uninstall --cask claude-code

放心试，它来去自由。

下一步

到这里你已经能：装好 Claude Code → 完成认证 → 在沙盒里跑通第一次对话 → 用几个常用命令管理会话 → 知道怎么卸载。

两件事能让你的体验从"能用"变成"好用"：

写一份 CLAUDE.md——系列02篇《AI岗位说明书：CLAUDE.md精讲》会手把手教你
学会让 AI 自己看项目——系列01篇《别再教 AI，让它自己看项目》会讲透正确用法

还有 /mcp、/focus、/goal、/code-review 等高级命令，系列后续篇各有专章，等你基础跑顺了再去解锁。

装好只是起点，顺手才是开始。

本文内容仅供学习交流，所述方法需结合实际场景灵活运用。 AI 工具输出结果仅供参考，关键业务决策请结合人工判断。本文由AI辅助创作，经人工审核编辑后发布。

《智能编码进化论》系列第00篇 · 比干撰写 · 2026-08

本文首发于微信公众号「羲和Lab」，公众号内可留言交流

阅读公众号原文