Claude Code 完全指南:让 AI 成为你最得力的编程助手
Claude Code 是 Anthropic 官方推出的 AI 编程助手 CLI 工具,它可以帮助开发者更高效地完成代码编写、调试、重构等日常工作。本文将带你全面了解 Claude Code 的安装、配置及实用技巧。
一、安装与快速开始
1.1 安装 Claude Code
通过 npm 全局安装 Claude Code:
bashnpm install -g @anthropic-ai/claude-code
1.2 初始化项目
在项目目录下启动 Claude Code 后,执行初始化命令:
bash# 英文初始化 /init # 中文初始化 /init --lang=zh-CN
这将在项目根目录生成 CLAUDE.md 文件,用于存储项目上下文和编码规范。
二、核心命令速查表
2.1 启动与交互
| 命令 | 作用 | 示例 |
|---|---|---|
claude | 启动交互模式 | claude |
claude "任务" | 运行一次性任务 | claude "修复构建错误" |
claude -p "查询" | 查询后退出 | claude -p "解释这个函数" |
claude -c | 继续最近的对话 | claude -c |
claude -r | 恢复之前的对话 | claude -r |
claude update | 更新 | claude update |
claude --dangerously-skip-permissions | 危险模式,自动执行不需要授权,谨慎使用,通过配置权限更好 | claude --dangerously-skip-permissions |
2.2 交互模式命令
在 Claude Code 交互模式中,可以使用以下斜杠命令:
| 命令 | 功能 |
|---|---|
/init | 初始化项目,生成 CLAUDE.md |
/clear | 清除对话历史 |
/help | 显示可用命令 |
/plan | 切换到计划模式(适合设计方案) |
/model | 查看和切换模型 |
/status | 查看当前状态 |
/config | 配置,比如设置语言 |
/resume | 恢复上次中断的对话 |
/cost | 查看当前对话的费用(注意是当前会话不是总的) |
/teleport | 会话传递功能,在网页上用,然后换个客户端,可以无缝衔接,测试时没起作用,后续再看下 |
2.3 快捷键
Shift + Tab- 快速切换到 Plan 模式Ctrl + C或exit- 退出 Claude Code- ! 执行shell命令,避免在claude cli命令下不方便执行命令,比如!pwd就可以在claude cli下快速查看当前目录
- ctl+v 是复制(注意,mac日常复制是cmd+v,但是这里是ctl+v,特别是复制图片哪些)
- shift + enter 换行
- ctrl+b 可以让当前任何后台执行
- ESC+ESC 回退
2.4 Git 集成
bash# 创建 Git 提交(Claude 会自动分析变更并生成 commit message) claude commit
实用技巧
- 批量处理文件
shellclaude -p "分析所有.md文件的错别字" --add-dir ./articles
- JSON格式输出
shellclaude -p "列出项目依赖" --output-format json | jq '.dependencies'
- 设置超时
shellclaude --timeout 60 -p "复杂分析任务"
- 会话管理
shell#保存会话 claude --save-session "code-review-20260108" # 恢复会话 claude --load-session "code-review-20260108" --continue
- CI/CD集成
shellcat test_results.txt | claude -p "分析测试结果" --output-format json
三、配置第三方模型
如果你想使用其他兼容的 AI 模型(如智谱 GLM),可以通过修改环境变量来实现:
3.1 修改配置文件
编辑 ~/.bashrc 或 ~/.zshrc 文件,添加以下内容:
bashexport ANTHROPIC_AUTH_TOKEN="你的token" export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic"
3.2 使配置生效
bashsource ~/.bashrc # 或 source ~/.zshrc
四、官方插件:code-simplifier
code-simplifier 是 Claude Code 团队开源的官方代码简化插件,也是 Anthropic 内部使用的代码重构工具。它专注于提高代码的清晰度、一致性和可维护性。
4.1 安装插件
bashclaude plugin install code-simplifier
安装成功后显示:
✔ Successfully installed plugin: code-simplifier@claude-plugins-official (scope: user)
4.2 核心特性
code-simplifier 遵循以下核心原则:
| 特性 | 说明 |
|---|---|
| 功能完整性 | 永不改变代码行为,只改进实现方式 |
| 项目标准 | 自动遵循 CLAUDE.md 中的编码规范 |
| 清晰优先 | 消除不必要的复杂性,使用清晰的命名 |
| 适度简化 | 避免过度简化,保持代码可维护性 |
| 聚焦范围 | 默认只处理最近修改的代码 |
4.3 优化示例
示例 1:简化嵌套三元运算符
javascript// 优化前 const result = condition1 ? value1 : condition2 ? value2 : condition3 ? value3 : defaultValue; // 优化后 let result; if (condition1) { result = value1; } else if (condition2) { result = value2; } else if (condition3) { result = value3; } else { result = defaultValue; }
示例 2:提高可读性
javascript// 优化前 const f = (x, y) => x > y ? x : y; // 优化后 function getMax(x, y) { if (x > y) { return x; } return y; }
示例 3:使用解构
javascript// 优化前 const userName = user.name; const userEmail = user.email; const userAge = user.age; // 优化后 const { name: userName, email: userEmail, age: userAge } = user;
4.4 卸载插件
bashclaude plugin uninstall code-simplifier
五、最佳实践
- 善用 CLAUDE.md - 保持项目规范文档更新,让 Claude 更好地理解你的项目
- 使用 Plan 模式 - 复杂任务先切换到 Plan 模式设计方案
- 代码审查 - 虽然 Claude 很智能,但始终建议审查生成的代码
- 版本控制 - 使用 Git 跟踪变更,便于回滚
- 信任插件 - code-simplifier 会自动优化代码,让它自主工作
六、常见问题
Q: code-simplifier 会改变代码功能吗? A: 不会。插件的核心原则是保持功能完整性,只改进代码的实现方式。
Q: 插件会自动运行吗? A: 是的,code-simplifier 设计为自主运行,会在代码修改后自动进行优化。
Q: 如何控制插件的作用范围? A: 默认只处理最近修改的代码,如需处理更大范围需要明确指示。
Q: 支持哪些编程语言? A: 插件主要针对 JavaScript/TypeScript 项目,特别是使用 React 的项目。
七、相关资源
本文持续更新中,欢迎收藏备用!