Claude Code 完整使用指南:Anthropic 官方 AI 编程 CLI 工具教程

Claude Code 完整使用指南:Anthropic 官方 AI 编程 CLI 工具教程

深度解析 Claude Code —— Anthropic 推出的命令行 AI 编程助手,覆盖安装、子代理、技能、Hooks、工作流等全部核心功能。

什么是 Claude Code

Claude Code 是 Anthropic 在 2024 年底推出的命令行 AI 编程助手,由 Claude Opus 4 / Sonnet 4 模型驱动。与 Cursor、GitHub Copilot 等编辑器集成方案不同,Claude Code 是纯终端 + Agent 模式的工具,能够自主读写文件、执行命令、运行测试。

它是 Anthropic 官方出品,深度整合 Claude 的最强能力,被认为是当前最强大的 AI 编程工具之一。

Claude Code vs Cursor vs GitHub Copilot

对比项Claude CodeCursorGitHub Copilot
形态命令行 CLI独立 IDEIDE 插件
核心模式Agent对话 + 补全补全为主
底层模型Claude Opus 4 / Sonnet 4多模型多模型
文件操作读 + 写 + 命令执行读 + 写主要读
价格API 按量 / Pro $20$20/月$10/月
编辑器集成VS Code / 任何编辑器独立编辑器多个 IDE

安装

前置要求

  • Node.js 18+ 或 Bun
  • 有效的 Anthropic API Key(或 Claude Pro/Max 订阅)
  • macOS / Linux / Windows(WSL)

安装命令

npm install -g @anthropic-ai/claude-code

# 或使用 bun
bun install -g @anthropic-ai/claude-code

配置 API Key

# 方式 1:环境变量
export ANTHROPIC_API_KEY=sk-ant-...

# 方式 2:登录 Claude Pro/Max
claude
# 然后按提示用浏览器登录

核心功能详解

1. 智能文件操作

Claude Code 可以自主读写整个项目的文件:

$ claude
> 帮我把 src/api/users.ts 的所有 any 类型替换为具体类型

它会自动:

  1. 读取文件内容
  2. 分析类型上下文
  3. 生成修改 patch
  4. 预览变更让你确认
  5. 应用到磁盘

2. 命令执行

能直接运行 shell 命令并解读输出:

> 跑一下测试看哪些挂了

Claude 会执行 npm test、解析失败用例、定位问题代码、提出修复方案。

3. Subagents(子代理)

这是 Claude Code 最强大的功能之一。你可以创建专门的子代理来处理特定任务:

  • code-reviewer:代码审查专家
  • test-writer:自动写单元测试
  • doc-generator:生成文档
  • bug-hunter:定位 Bug 根因

子代理在独立的上下文中运行,处理完后只返回结果,不污染主对话。

4. Skills(技能)

Skills 是预定义的工作流模板,让 Claude Code 知道在特定场景如何处理:

  • commit:分析变更并生成规范的 commit 信息
  • review-pr:审查 Pull Request
  • refactor:执行代码重构
  • migrate:执行数据库迁移

5. Hooks(钩子)

Hooks 允许在 Claude Code 执行特定操作前后运行自定义脚本。例如:

  • 每次写文件后自动跑 lint
  • 每次提交前跑测试
  • 每次运行命令前要求确认

实战工作流

工作流 1:完整功能开发

$ cd my-project
$ claude
> 我要实现用户头像上传功能:
  1. 后端添加 POST /api/users/avatar 接口,接收 multipart 文件
  2. 文件存到 S3,路径为 avatars/{userId}/{timestamp}.jpg
  3. 数据库添加 avatar_url 字段
  4. 前端添加上传组件
  5. 写测试覆盖核心逻辑
  写完后跑测试确认通过

Claude Code 会规划任务、按顺序实现每一部分、运行测试、修复问题,全程自主进行。

工作流 2:Bug 修复

> 用户报告:登录时偶尔会出现 500 错误,看看 logs/app.log 最近的报错并修复

工作流 3:代码重构

> 把 src/services/ 下所有 callback 风格的函数改写成 async/await,并保持原有的错误处理逻辑

高级技巧

1. CLAUDE.md 项目记忆

在项目根目录创建 CLAUDE.md,写下项目规范、架构、常见命令。Claude Code 启动时会自动读取,整个对话都会遵守。

# CLAUDE.md
## Project: My SaaS

### Tech Stack
- Backend: Go + Gin + GORM + PostgreSQL
- Frontend: Vue 3 + Vite + Tailwind

### Code Style
- Always use TypeScript strict mode
- Prefer functional components
- All API responses use { code, message, data } format

### Common Commands
- Build: cd server && go build
- Test: cd server && go test ./...
- Lint: cd web && npm run lint

2. 多代理并行

对于独立的任务,使用多个子代理并行执行:

> 同时做这几件事:
1. 跑测试套件
2. 检查 lint 错误
3. 分析最近 10 个 commit 找出可能的回归

3. Plan 模式

对于复杂任务,让 Claude 先制定计划再执行:

> /plan 重构用户认证系统使用 JWT

Claude 会生成详细的步骤计划,等你审批后再开始执行。

价格与订阅

方案价格说明
API 按量按 token 计费适合轻量使用,约 $0.1-1/会话
Claude Pro$20/月有 5 倍 API 使用配额
Claude Max$100/月有 20 倍 API 使用配额,适合重度

对于专业开发者,Claude Max 性价比最高 —— 月费 $100 但能获得相当于 $1000+ 的 API 使用量。

常见问题

Q: Claude Code 会自动改我的代码吗?

A: 默认情况下每次写文件前都会请求确认。你也可以开启 auto-edit 模式让它自动应用,或在 settings 中设置具体规则。

Q: 上下文窗口多大?

A: 最高支持 200K tokens(约 50 万字),可以一次加载整个中型项目。

Q: 跟 Cursor 哪个更好?

A: 各有所长。Cursor 适合喜欢 IDE 集成、对话 + 补全的用户;Claude Code 适合喜欢命令行、Agent 自主执行、复杂多步任务的用户。两者可以结合使用。

如何便捷开通 Claude Pro/Max

Claude Pro 和 Max 订阅需要绑定国际信用卡,对国内用户不便。通过 9DSC 九度数城

  • Claude Pro 代充:$20/月,无需信用卡
  • Anthropic API 充值:$50 起充,灵活选择
  • 支持人民币、USDT 多种支付
  • 即时到账,立即可用

结语

Claude Code 是 AI 编程的下一个范式 —— 不是补全,而是 Agent。让 AI 真正成为你的开发搭档,而不只是打字辅助。

立即访问 9DSC 九度数城 开通你的 Claude Pro 订阅或充值 Anthropic API,开始体验 Claude Code 带来的开发效率革命。