@anthropic-ai/claude-code 快速上手指南
本文重点：快速启动项目、配置 API、常用操作，让开发者立即开始实战，命令清单放在最后参考。
一、安装及配置秘钥
说明：Claude Code 依赖git和npm，这里不赘述基础安装。
1.1 安装 Claude Code
升级或首次安装：
npminstall-g @anthropic-ai/claude-code ⚠️ 不同版本支持的命令略有差异，最终以 /help 输出为准。1.2 配置 API
配置文件路径：
| 系统 | 路径 |
|---|---|
| Windows | C:\Users\用户名\.config\claude-code\config.json |
| Linux/Mac | ~/.config/claude-code/config.json |
参考：https://platform.minimaxi.com/docs/guides/text-ai-coding-tools#手动编辑配置文件
示例：使用 minMax 并设置自己的 ANTHROPIC_AUTH_TOKEN：
⚡ 国内支持模型：DeepSeek、GLM-4
AI 推荐：Kimi、Qwen-Max，不同模型训练数据、价格和擅长领域不同，可按实际需求选择。
二、实际使用流程（优先突出）
安装完成后，直接启动 CLI 进入项目实战：
# 推荐客户端 Windows Terminal： 1）Windows 商店安装 2）GitHub 下载压缩包直接使用 旧版 Win10 可使用 PowerShell 7 (x64) 进入交互模式后：
# 初始化项目 claude /init # 生成 CLAUDE.md，建立项目上下文 # 先加一条默认：全局规范 把用中文回答，加入到全局规范，之后回答全用中文 # 让AI 干活 直接提出问题 # 经常干的 or 比较好的样例； 请把 ** 加到全局规范 请根据 ** 生成全局规范 # 规范太多，超过5k 行 请 规整 和 压缩全局规范 CLAUDE.md （不删减内容） # 有时，经常干的会幻觉 请把 ** 加到CLAUDE.md or 请调整全局规范 日常开发操作示例
# 查看当前状态 /status # 查看上下文使用情况 /context # 分析项目代码（可指定文件或模块） /review src/main/java # 或用中文提问 请分析 xx 方法; 分析 xx 类；简化 ** 方法等 # 出现报错时 请解决 粘贴错误 → Ctrl + V → 让 AI 分析 # 页面或样式调整 请根据效果图调整某页面 粘贴图片 → Alt + V → AI 分析 # 提具体需求 重构某某 Service 为构造器注入 # 上下文过大或讨论方向改变 /clear ⚡ 提示：首次进入项目必须/initCLI 支持/命令或直接自然语言提问常用操作可记录在 CLAUDE.md 作为规范
三、AI 审查代码示例
直接粘贴到 CLI：
你是资深Java后端架构师，具备生产系统代码审查经验（Spring Boot / JPA / 微服务）。请审查以下代码变更，并判断是否可以合并到 master 分支。 【重点专项检查】 1. 稳定性 是否存在空指针、边界条件问题 是否可能引发运行时异常 是否影响已有功能或接口兼容性 2. 数据与事务安全 是否存在 SQL 注入风险 是否正确使用事务（遗漏、传播、回滚问题） 是否存在数据不一致风险 3. 数据访问与性能 是否存在 N+1 查询问题 查询是否可能走全表扫描或缺少索引 是否存在重复查询、不必要循环或高复杂度逻辑 4. 并发与线程安全 是否存在并发问题（共享变量、锁、竞态条件） 是否有线程安全隐患 5. 安全性 是否缺少权限校验 是否可能导致数据越权访问或敏感信息泄露 6. 代码质量 是否存在明显设计问题或代码异味 可读性、可维护性是否合理 是否存在重复逻辑或不合理抽象 【输出格式（必须严格遵守）】 【结论】 （可合并 / 不建议合并） 【风险等级】 （low / medium / high） 【阻塞问题（必须修复）】 xxx 【建议优化（可选）】 xxx 【说明】 如果存在可能影响生产稳定性的风险，必须判定为“不建议合并” 不要给泛泛建议，只输出关键问题 有时ai 会提问你，git仓库在哪
自行识别 xx 路径的git 仓库，并加入到全局规范 四、命令清单（参考用，全部可 /help 查看）
4.1 会话与状态管理
| 命令 | 作用说明 |
|---|---|
/help | 列出所有命令 |
/status ⭐ | 查看会话整体状态 |
/context | 上下文窗口、已用/剩余 tokens |
/usage | 查看 token 使用明细 |
/model | 查看当前模型 |
/model <name> | 切换模型 |
/clear | 清空对话上下文 |
/exit / /quit | 退出 CLI |
4.2 项目初始化与结构分析
| 命令 | 作用说明 |
|---|---|
/init ⭐ | 扫描目录建立项目上下文 |
/review ⭐ | 审查项目代码并给出建议 |
/review <path> | 审查指定目录/文件 |
/plan <需求> | 生成实现计划 |
/explain | 解释项目或代码结构 |
/diff | 分析 Git 变更 |
/fix | 尝试修复发现问题（部分版本支持） |
4.3 文件上下文控制
| 命令 | 作用说明 |
|---|---|
/files | 查看已加载文件 |
/add <file> | 加入文件 |
/add <dir> | 加入目录 |
/drop <file> | 移除文件 |
/drop all | 移除全部文件上下文 |
4.4 对话行为控制（高级）
| 命令 | 作用说明 |
|---|---|
/system <prompt> | 修改系统提示词 |
/temperature <0-1> | 调整回答发散度（部分版本支持） |
/save <file> | 保存当前会话到文件 |
/load <file> | 载入历史会话 |
4.5 实战常用九大命令
/help /status /context /usage /model /init /review /clear /diff 
