@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