Claude Code 安装与使用指南
Claude Code 安装与使用指南
Claude Code 是 Anthropic 官方的终端编程智能体，在命令行中完成读代码、改文件、跑测试、多步重构。适合大型代码库、SSH 远程环境与自动化流水线。
产品概览
| 项目 | 说明 |
|---|---|
| 官网文档 | code.claude.com/docs |
| 类型 | 终端 CLI Agent |
| 支持系统 | macOS、Linux、WSL；Windows 推荐 WSL 或原生 PowerShell |
| 账号 | Anthropic 账号 + Claude Pro/Max 等订阅 |
| 特点 | 强推理、多文件编辑、MCP、会话恢复 |
安装步骤
方式一：原生安装（推荐，自动更新）
macOS / Linux / WSL：
# 官方一键安装脚本（推荐）
curl -fsSL https://claude.ai/install.sh | bash
Windows PowerShell：
# Windows 原生安装
irm https://claude.ai/install.ps1 | iex
Windows CMD：
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Windows 建议安装 Git for Windows，以便 Claude Code 使用 Bash 工具；否则回退到 PowerShell。
方式二：Homebrew（macOS，需手动更新）
# 安装稳定版
brew install --cask claude-code
# 或安装最新频道
brew install --cask claude-code@latest
方式三：WinGet（Windows）
winget install Anthropic.ClaudeCode
方式四：npm
# 需 Node.js 环境
npm install -g @anthropic-ai/claude-code
验证安装
# 检查版本
claude --version
# 进入项目目录并启动
cd your-project
claude
首次运行会在浏览器中提示登录 Anthropic 账号。
核心命令与用法
常用命令
| 命令 | 作用 | 示例 |
|---|---|---|
claude |
交互模式 | claude |
claude "任务" |
单次任务 | claude "修复单元测试失败" |
claude -p "问题" |
问答后退出 | claude -p "解释 auth 模块" |
claude -c |
继续当前目录最近会话 | claude -c |
claude -r |
恢复历史会话 | claude -r |
会话内命令
| 命令 | 作用 |
|---|---|
/help |
查看帮助 |
/clear |
清空上下文 |
/compact |
压缩上下文节省 token |
/exit 或 Ctrl+D |
退出 |
典型工作流
1. 理解陌生项目
cd ~/my-repo
claude
请分析这个项目的目录结构，说明：
1. 入口文件在哪里
2. 核心业务模块有哪些
3. 测试如何运行
2. 多文件重构
将 utils/date.ts 中的 formatDate 重命名为 formatDateTime，
并更新所有引用它的文件。不要改 API 返回值类型。
改完后运行测试确认通过。
3. 补充测试
为 src/services/order.ts 补充 Vitest 单元测试：
- 覆盖空订单、正常下单、库存不足三种情况
- 每个测试用例添加注释说明预期行为
项目配置：CLAUDE.md
在项目根目录创建 CLAUDE.md，作为持久化项目说明（类似 Cursor Rules）：
# 项目规范
- 语言：TypeScript strict 模式
- 框架：Vue 3 Composition API
- 所有导出函数必须有 JSDoc
- GIS：Cesium 坐标用弧度，组件销毁时销毁 viewer
MCP 扩展
Claude Code 支持 Model Context Protocol，可连接文档服务、数据库、自定义 API，扩展 Agent 工具能力。
优缺点分析
优点
| 优点 | 说明 |
|---|---|
| 推理能力强 | Claude 系列在复杂逻辑、架构设计上表现突出 |
| 终端原生 | SSH、CI、无 GUI 服务器均可使用 |
| 多文件 Agent | 自主读写、执行命令、跨目录重构 |
| 会话管理 | -c / -r 恢复上下文，长任务友好 |
| MCP 生态 | 可接企业内外部工具链 |
| 沙箱安全 | 文件改动前可 Review diff |
缺点
| 缺点 | 说明 |
|---|---|
| 需订阅 | 依赖 Anthropic 付费计划，无 TRAE CN 式免费 |
| 国内网络 | 登录与 API 可能需稳定国际网络 |
| 无 IDE 补全 | 不适合替代日常 Tab 补全体验 |
| Windows 体验 | 原生支持在完善中，WSL 更稳 |
| Token 成本 | 大仓库长会话消耗较高 |
| 学习曲线 | 需习惯终端交互与 diff Review |
与 Cursor / Codex 对比
| 维度 | Claude Code | Cursor | Codex |
|---|---|---|---|
| 界面 | 终端 | GUI IDE | 终端 |
| 日常补全 | 弱 | 强 | 弱 |
| 复杂重构 | 强 | 强 | 强 |
| 模型 | Claude | 多模型 | OpenAI |
| 国内免费 | 否 | 有限免费 | 否 |
推荐组合： Cursor 或 TRAE IDE 日常开发 + Claude Code 做大重构与自动化。
常见问题
| 问题 | 解决 |
|---|---|
claude 命令找不到 |
重开终端；检查 PATH；重装 |
| Windows 报错 | 优先用 WSL；或装 Git for Windows |
| 改动过大 | 拆小任务；要求先输出 Plan |
| 敏感代码 | 用企业策略；避免上传机密仓库 |
延伸阅读
本文由 xueyise 创作，AI 编程工具专栏。