模型教程
Claude Code 安装与使用全流程：从环境准备到项目实战
从 macOS、Windows、Linux 安装，到登录、CLAUDE.md、权限模式、企业安全配置和日常开发流程，系统梳理 Claude Code 的完整使用方法。
更新时间：2026-04-30。本文参考 Anthropic 官方 Claude Code 文档，并结合国内用户常见的 macOS / Windows 安装问题整理。微信参考文章提供了“从零安装”和“国内网络环境”的写作方向，本文内容为重新组织后的原创教程。
这篇教程适合谁
Claude Code 是 Anthropic 推出的 Agentic Coding 工具。你可以把它理解成一个在终端、IDE、桌面端和网页端运行的编程助手：它能读取代码库、编辑文件、运行命令、协助排错、写测试、生成提交说明，也能通过 MCP、Hooks、Skills 等机制接入团队工具。
如果你正在做这些事，这篇教程会很有用：
- 想在自己的电脑上安装 Claude Code，但不知道 macOS、Windows、Linux 该选哪条路径。
- 想让 Claude Code 进入真实项目，而不是只停留在“问答聊天”。
- 担心它乱改代码、误读密钥、误执行危险命令，需要一套安全使用方法。
- 希望团队把 Claude Code 用成规范化开发流程，而不是每个人随便用。
先说结论：个人学习优先用官方原生安装命令；macOS 团队环境可以用 Homebrew；Windows 用户建议先装 Git for Windows，再用 PowerShell 原生命令或 WinGet；企业场景要把 CLAUDE.md、.claude/settings.json 和权限模式配置好。
安装前准备
| 项目 | 建议 |
|---|---|
| 操作系统 | macOS 13+、Windows 10 1809+、Windows Server 2019+、Ubuntu 20.04+、Debian 10+、Alpine Linux 3.19+ |
| 硬件 | 至少 4GB 内存，x64 或 ARM64 处理器 |
| 终端 | macOS 用 Terminal / iTerm2；Windows 用 PowerShell、CMD 或 Windows Terminal；Linux / WSL 用 Bash 或 Zsh |
| 账号 | Claude Pro / Max / Team / Enterprise、Anthropic Console，或企业云提供商接入 |
| Windows 额外建议 | 安装 Git for Windows，让 Claude Code 能使用 Bash 工具；WSL 不需要额外装 Git for Windows |
国内用户最容易混淆两件事：安装 CLI 和模型访问是两层。安装成功只说明 Claude Code 这个工具在本机可用；真正执行任务还需要可用账号、套餐或企业云接入。第三方模型切换工具、代理和转发服务不属于官方 Claude Code 能力，个人实验可以谨慎尝试，企业环境不建议把代码和密钥交给不可信中间层。
安装路径怎么选
| 场景 | 推荐方式 | 命令 |
|---|---|---|
| macOS / Linux / WSL 个人安装 | 官方原生安装 | curl -fsSL https://claude.ai/install.sh | bash |
| Windows PowerShell | 官方原生安装 | irm https://claude.ai/install.ps1 | iex |
| Windows CMD | 官方原生安装 | curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd |
| macOS 团队统一安装 | Homebrew 稳定通道 | brew install --cask claude-code |
| macOS 想追最新版本 | Homebrew 最新通道 | brew install --cask claude-code@latest |
| Windows 包管理器 | WinGet | winget install Anthropic.ClaudeCode |
如果你在 PowerShell 里运行 CMD 命令，可能会看到 && 相关报错；如果你在 CMD 里运行 PowerShell 命令，可能会看到 irm 不识别。判断方式很简单：PowerShell 提示符通常长得像 PS C:\...>，CMD 通常是 C:\...>。
macOS 安装
方式一：官方原生命令
打开终端，运行：
curl -fsSL https://claude.ai/install.sh | bash
安装结束后，先检查版本：
claude --version
如果提示找不到 claude，通常是安装目录还没有加入 PATH。官方安装器一般会在终端里提示你应该执行哪条命令。常见处理方式如下：
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
claude --version
如果你用 Bash，则把 .zshrc 换成 .bashrc 或 .bash_profile。
方式二：Homebrew
如果团队已经用 Homebrew 管理开发工具，可以运行：
brew install --cask claude-code
稳定通道通常更适合日常工作。想第一时间拿到最新版本，可以用：
brew install --cask claude-code@latest
Homebrew 安装不会自动更新，后续需要手动升级：
brew upgrade claude-code
或：
brew upgrade claude-code@latest
Windows 安装
第一步：建议先装 Git for Windows
Claude Code 在 Windows 上可以使用 PowerShell，但装好 Git for Windows 后，它能更自然地使用 Bash 工具，许多跨平台项目也更顺手。
打开 Windows Terminal 或 PowerShell，运行：
winget install --id Git.Git -e
安装完成后，重新打开终端。
方式一：PowerShell 原生命令
在 PowerShell 中运行：
irm https://claude.ai/install.ps1 | iex
安装后检查：
claude --version
方式二：CMD 原生命令
如果你打开的是 CMD，使用：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
方式三：WinGet
企业电脑如果更习惯 Windows 官方包管理器，可以用：
winget install Anthropic.ClaudeCode
WinGet 安装也不会自动更新，建议定期运行：
winget upgrade Anthropic.ClaudeCode
Linux / WSL 安装
Linux 和 WSL 优先使用官方原生命令：
curl -fsSL https://claude.ai/install.sh | bash
确认安装：
claude --version
如果是服务器或容器环境，请先确认系统能访问 Anthropic 相关域名，并确认当前用户有写入安装目录的权限。企业部署还可以参考官方的 apt、dnf、apk 安装方式，用包管理器统一升级。
登录和计费方式
第一次运行：
claude
它会引导你登录。你也可以显式运行：
claude auth login
如果你希望使用 Anthropic Console 的 API 额度，而不是 Claude 订阅账号，可以使用：
claude auth login --console
检查登录状态：
claude auth status --text
官方支持的账号路径主要有三类：
- Claude Pro / Max / Team / Enterprise。
- Anthropic Console 账号，适合按 API 额度计费和集中追踪成本。
- Amazon Bedrock、Google Vertex AI、Microsoft Foundry 等企业云提供商接入。
国内用户要特别注意：如果你使用非官方转发、镜像、第三方模型切换工具，要先评估代码、密钥、客户数据是否会经过第三方服务。个人测试可以隔离项目；公司项目建议走官方账号、企业云接入或内部合规网关。
第一次进项目：不要上来就让它改代码
进入项目根目录：
cd /path/to/your/project
claude
新手第一轮建议按这个顺序问：
请先不要修改文件。先阅读项目结构，告诉我这个项目是做什么的，核心入口在哪里，主要技术栈是什么。
继续让它定位关键目录：
请解释 app、components、lib、tests 这些目录分别负责什么。只分析，不修改。
如果你准备让它改代码，再给出明确范围：
我想给登录页增加错误提示。请先列出你准备查看哪些文件、修改哪些文件、如何验证。先不要改代码。
确认计划后再让它动手：
按上面的计划执行。改完后运行相关测试，并说明改了哪些文件。
这种“先读、再计划、再执行、再验证”的节奏，比一句“帮我优化项目”稳定得多。
初始化项目记忆：CLAUDE.md
Claude Code 每次会话都会重新开始上下文。要让它记住项目规则，需要把关键约定写进 CLAUDE.md。在项目根目录里可以先运行：
/init
然后把文件补成团队能用的版本。一个实用模板如下：
# 项目说明
这是一个 Next.js + PostgreSQL 的企业 AI 分享站。
## 常用命令
- 安装依赖：npm ci
- 本地开发：npm run dev
- 类型检查：npm run typecheck
- 单元测试：npm test
- 构建：npm run build
## 编码规范
- 所有用户可见文案使用中文。
- 不要随意改数据库迁移和生产环境变量。
- 修改登录、权限、内容发布相关逻辑时，必须补充测试。
## 工作流程
1. 先说明计划。
2. 小步修改。
3. 运行相关测试。
4. 总结改动和验证结果。
什么时候应该更新 CLAUDE.md？当你第二次纠正同一个问题、代码评审发现它应该早知道的约定、或者新同事也需要这条规则时，就应该写进去。
权限模式：新手建议从 Plan Mode 开始
Claude Code 的强大之处是能动手；风险也在这里。权限模式决定它何时需要暂停并征求你的确认。
| 模式 | 适合场景 | 建议 |
|---|---|---|
default |
初次使用、敏感项目 | 读文件为主，改动和命令都要你确认 |
plan |
先理解项目、先出方案 | 最适合新手和复杂任务 |
acceptEdits |
你已经认可方向，想减少确认 | 适合小范围代码迭代 |
auto |
长任务、低风险项目 | 需要理解后台安全检查和账号条件 |
dontAsk |
CI 或脚本化运行 | 只允许预先批准的工具 |
bypassPermissions |
隔离容器或虚拟机 | 不建议在真实工作目录随便使用 |
启动时进入计划模式：
claude --permission-mode plan
会话中可以按 Shift + Tab 在常用模式间切换。建议新手的默认习惯是：复杂任务先开 plan，确认方案后再切到 acceptEdits。
企业安全配置：先把边界写死
项目级配置文件推荐放在：
.claude/settings.json
个人本机覆盖配置放在：
.claude/settings.local.json
一个保守配置示例：
{
"$schema": "https://json.schemastore.org/claude-code-settings.json",
"permissions": {
"allow": [
"Bash(npm run lint)",
"Bash(npm run test *)",
"Bash(npm run typecheck)",
"Bash(git diff *)",
"Bash(git status *)",
"Read"
],
"deny": [
"Read(./.env)",
"Read(./.env.*)",
"Read(./secrets/**)",
"Bash(rm -rf *)",
"Bash(curl *|*sh*)"
],
"defaultMode": "plan"
}
}
这里的思路不是让 Claude Code 什么都不能做，而是把高频安全边界写清楚：可以跑测试、看 diff、读普通文件；不要读 .env，不要碰 secrets，不要执行危险删除命令，不要随便把远程脚本接进 shell。
日常工作流示例
1. 理解陌生项目
请给我这个项目的高层概览：业务目标、主要模块、技术栈、入口文件、数据流。不要修改文件。
进一步追问：
请画出用户登录从前端页面到后端 API 再到数据库的调用链路，并指出关键文件。
2. 修 Bug
先给复现方式：
运行 npm test 时 auth.test.ts 失败。请先分析失败原因，定位相关文件，形成修复计划。先不要改代码。
再让它执行：
按计划修复。要求只改和登录测试相关的文件，修完后运行 npm test -- tests/integration/auth.test.ts。
3. 写测试
请为收藏功能补充集成测试。先列出已有测试模式，再新增最小覆盖：未登录拒绝、登录后收藏、重复收藏幂等。
4. 代码审查
git diff main --name-only | claude -p "请审查这些改动，重点看安全、权限、边界条件和缺失测试。输出文件名、风险等级和建议。"
5. 自动化脚本
Claude Code 可以作为 Unix 风格工具使用，例如：
cat build-error.txt | claude -p "请解释这段构建错误的根因，并给出最小修复建议。"
如果要接入 CI，建议用 --output-format json 或 --output-format stream-json，便于后续程序解析。
常用命令速查
| 命令 | 用途 |
|---|---|
claude |
进入交互式会话 |
claude "修复登录页报错" |
执行一次性任务 |
claude -p "解释这个函数" |
非交互式提问，输出后退出 |
claude -c |
继续当前目录最近一次会话 |
claude -r |
从历史会话中选择恢复 |
claude --permission-mode plan |
以计划模式启动 |
claude --model sonnet |
指定模型别名 |
claude auth status --text |
检查登录状态 |
claude --version |
查看版本 |
/help |
查看可用斜杠命令 |
/clear |
清空当前会话上下文 |
/init |
初始化项目说明文件 |
/login |
切换或重新登录账号 |
新手最容易踩的坑
1. 安装成功但 claude 找不到
大概率是 PATH 没更新。先重新打开终端，再运行：
echo $PATH
which claude
macOS / Linux 常见修复：
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
2. PowerShell 和 CMD 命令混用
看到 PS C:\ 就用 PowerShell 命令：
irm https://claude.ai/install.ps1 | iex
看到 C:\ 就用 CMD 命令：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
3. 一上来就让它“重构整个项目”
这很容易产生大范围改动。更稳的写法是：
请只分析，不修改。先列出重构风险、影响文件、验证方式，再等我确认。
4. 没有保护 .env
把 .env、密钥文件、客户数据目录放入 deny 规则。即使你信任工具，也不要让敏感文件进入默认上下文。
5. 不看 diff 就提交
让 Claude Code 提交前，先问：
请总结 git diff 中每个文件的改动原因，并指出有没有无关改动。
确认没有问题后再提交。
推荐的企业落地流程
- 先选一个低风险项目试点，例如内部工具、脚手架、文档站。
- 写好
CLAUDE.md，把安装、测试、构建、代码风格、禁止事项写清楚。 - 配置
.claude/settings.json，先用plan或default模式。 - 让团队只从三类任务开始：读代码、写测试、修小 Bug。
- 每周复盘一次，把反复出现的提示词和规则沉淀为命令、技能或文档。
- 涉及客户数据、生产密钥、部署脚本时，必须有人审查 diff 和命令。
Claude Code 真正的价值不是“替你写几行代码”，而是把理解项目、形成计划、修改文件、运行测试、整理提交这条链路连起来。用得好，它会像一个耐心的工程搭档；用得粗糙，它也可能把错误放大。所以第一天就把边界、记忆和验证流程建立起来，比安装命令本身更重要。
参考来源
- Anthropic 官方：Claude Code Overview
https://code.claude.com/docs/en/overview - Anthropic 官方：Quickstart
https://code.claude.com/docs/en/quickstart - Anthropic 官方：Advanced setup
https://code.claude.com/docs/en/setup - Anthropic 官方：CLI reference
https://code.claude.com/docs/en/cli-reference - Anthropic 官方：Settings
https://code.claude.com/docs/en/settings - Anthropic 官方：Permission modes
https://code.claude.com/docs/en/permission-modes - Anthropic 官方：Memory / CLAUDE.md
https://code.claude.com/docs/en/memory - 微信参考文章：从0开始，在国内用上Claude Code的终极保姆教程来了
https://mp.weixin.qq.com/s/AA2NHww4jUBuAfi10EYICw