Claude Code 完全指南：从安装到精通

Claude Code 是 Anthropic 官方推出的命令行 AI 编程助手。它不仅能聊天，更能直接操作你的代码库——读写文件、执行命令、管理 Git，真正成为你的编程伙伴。

本文从安装、配置到日常使用与进阶技巧，带你完整走一遍。

它能做什么

• 直接读写文件系统
• 执行 Shell 命令
• 理解项目结构与上下文
• 深度集成 Git 工作流
• 支持所有主流编程语言
• 自动定位并修复 Bug

快速安装

选择你的操作系统，一条命令完成安装：

也可以通过包管理器手动安装：

npm install -g @anthropic-ai/claude-code
# 或
pnpm add -g @anthropic-ai/claude-code

初始配置

claude config set apiKey YOUR_API_KEY_HERE

claude --version

选择模型

权限模式

• Prompt 模式（推荐）：每次操作前询问确认。
• Auto 模式（谨慎）：自动执行所有操作。
• Readonly 模式：只读，不修改任何文件。

基本使用

直接用自然语言描述需求，Claude Code 会读写文件、执行命令并反馈结果：

> 创建一个 React 组件 UserProfile，包含头像、姓名和简介
✓ Created src/components/UserProfile.tsx
✓ Added TypeScript interfaces
✓ Included responsive styling

常用内置斜杠命令：

进阶功能

多文件编辑：一次性重构整个项目并保持一致性。Git 工作流集成：从建分支到提交一气呵成。智能代码搜索：语义检索，不只是文本匹配。

> 创建新分支 feature/dark-mode 并实现暗色主题
✓ Created branch feature/dark-mode
✓ Updated 12 components
✓ Committed: "feat: add dark mode support"

最佳实践

• 具体明确：说清楚文件名和功能。
• 提供上下文：交代背景与预期结果。
• 分步执行：复杂任务拆成小步骤。
• 用 .claudeignore 排除敏感文件，提交前检查 git diff，生产环境用 readonly 模式，API Key 不要提交到代码库。

常见问题

延伸阅读：官方文档 · GitHub