claude-code教程

安装及配置安装npm install -g anthropic-ai/claude-code --allow-scriptsanthropic-ai/claude-code校验重新打开命令行输入 claude -- version启动使用claude命令启动首次进入会调用官网新手教程手动修改配置文件C:\Users\用户名\.claude.json 用户名根据自己名称变化添加属性hasCompletedOnboarding: true再次执行claude命令配置模型配置文件配置在C:\Users\cyz\.claude中创建settings.json文件然后把下面内容放进去模板如下{ env: { ANTHROPIC_BASE_URL: https://api.minimaxi.com/anthropic, // 大模型访问地址 ANTHROPIC_AUTH_TOKEN: 大模型的APIkey, // 在注册大模型的时候保存的还找到吗 API_TIMEOUT_MS: 3000000, // 单位毫秒超时时间 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1, // 是否禁用非必要的网络流量1为禁用 // Claude Code 在运行时可能会发送一些非必要的请求、 //例如检查更新、遥测数据、匿名使用统计等 //设为 1 后这些流量都会被禁止 ANTHROPIC_MODEL: MiniMax-M2.7, // 默认选择的模型 ANTHROPIC_DEFAULT_SONNET_MODEL: MiniMax-M2.7, // 推理任务选择的模型较为复杂的任务需要深度思考比如编码分析 ANTHROPIC_DEFAULT_OPUS_MODEL: MiniMax-M2.7, // 高端复杂任务选择的模型高端复杂任务比如架构设计 ANTHROPIC_DEFAULT_HAIKU_MODEL: MiniMax-M2.7, // 轻量级任务选择的模型延迟低比如自动补全简单编辑 CLAUDE_CODE_EFFORT_LEVEL: max // 不惜一切代价资源和时间追求最高质量的输出 } }根据自己的模型配置可能有的模型需要配置转发也有的模型不支持我配置的是阿里的模型{ env: { ANTHROPIC_AUTH_TOKEN: sk-xxx, ANTHROPIC_BASE_URL: https://dashscope.aliyuncs.com/apps/anthropic, ANTHROPIC_MODEL: auto, ANTHROPIC_DEFAULT_HAIKU_MODEL: qwen3.7-flash, ANTHROPIC_DEFAULT_SONNET_MODEL: qwen3.7-flash, ANTHROPIC_DEFAULT_OPUS_MODEL: qwen3.7-flash, CLAUDE_CODE_SUBAGENT_MODEL: auto, CLAUDE_CODE_MAX_CONTEXT_TOKENS: 983616 }, model: opus }测试使用cc switch转发模型下载地址 Releases · farion1231/cc-switch · GitHub有了这个之后可用不用手动配置上面的setting.json文件配置好了之后如下具体如何配置参考模型官网测试启动方式#默认启动 claude # 启动交互会话附带初始prompt claude 帮我重构这个项目的DTO # 一次性提问执行完直接退出非交互式适合脚本自动化 claude -p 解释这段代码 # 恢复当前目录最近一次对话 claude -c # 选择历史会话恢复 claude -rClaude Code 三种权限控制这是 Claude Code CLI 的操作执行权限 / 运行模式控制它能不能自动修改文件、执行 shell 命令不是 API 登录鉴权。方式一启动时绕过权限启动 claude 的时候通过启动参数 / 环境变量直接放开权限校验。作用启动就关闭交互确认不需要每次工具调用手动同意。方式二会话内切换模式快捷键Shift Tab呼出菜单在 claude 对话窗口按ShiftTab调出模式切换面板4 种模式表格命令名称说明plan mode on计划模式只输出方案、思路不会实际修改文件 / 执行命令先看方案再决定要不要执行适合架构设计、大改动manual mode on纯手动模式所有操作全部要你手动确认。读写文件、运行 shell每一步都要同意最安全默认模式accept edits on半自动模式✅自动接受文件编辑改代码、写文件不再弹窗确认❌ 但执行 shell 命令仍然需要你手动审批auto mode on全自动模式自动执行绝大多数操作自动改文件、自动跑 shell 命令极少弹窗确认。风险最高谨慎使用方式三配置文件定义权限在C:\Users\cyz\.claude中创建settings.json文件然后把下面内容放进去permissions: { allow: [ Read, Write, Bash(npm *), // npm命令 Bash(git *), // git命令 Bash(node *) // node命令 ], ask: [...], // 可以删除未配置默认ask deny: [ // 禁止的权限 Bash(rm -rf *) // 全局删除 ] }完整的如下{ env: { ANTHROPIC_BASE_URL: https://apihub.agnes-ai.com/v1, ANTHROPIC_API_KEY: sk-D0fk82222LNbmPMf3PIrXqQWu1URZSpK6teZa1Y5TAM, API_TIMEOUT_MS: 3000000, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1, ANTHROPIC_MODEL: agnes-2.5-flash, ANTHROPIC_DEFAULT_SONNET_MODEL: agnes-2.5-flash, ANTHROPIC_DEFAULT_OPUS_MODEL: agnes-2.5-flash, ANTHROPIC_DEFAULT_HAIKU_MODEL: agnes-2.5-flash, CLAUDE_CODE_EFFORT_LEVEL: max }, permissions: { allow: [ Read, Write, Bash(npm *), Bash(git *), Bash(node *) ], deny: [ Bash(rm -rf *) ] } }Claude Code CLI 全部斜杠命令分为【基础通用命令】【权限 / 模式控制命令】【会话管理】【模型 / 开销】【项目 / 文件】【调试 / 其他】一、基础通用命令命令作用备注/help展示全部可用命令列表查看帮助/model查看 / 切换当前模型⚠️【Agnes 高危】不要执行会改写 settings.json中转直接报错/clear清空当前对话上下文开启新任务项目配置 / CLAUDE.md 保留仅清空聊天记录/btw临时提问不写入主对话上下文主任务中问无关问题不污染当前任务二、权限 运行模式命令控制自动执行重点命令作用/manualmanual mode on纯手动模式。所有读写、shell 操作全部需要你确认默认安全模式/accept-editsaccept edits on半自动。自动接受文件修改shell 命令仍需要手动审批/autoauto mode on全自动模式自动执行大部分文件 / 命令操作风险高/planplan mode on计划模式。只输出方案思路不会修改任何文件、不执行命令三、会话管理命令命令作用/rewind回滚对话到历史检查点恢复之前的对话状态/resume选择并恢复历史会话/branch基于当前对话新建一个分支会话并行试不同方案互不干扰/compact压缩总结历史对话精简上下文释放 token 窗口/context查看当前上下文占用详情看哪些内容占用 token四、账号、状态、模型开销命令作用备注/status查看当前全部状态网关地址、当前模型、权限、目录、版本✅非常常用用来校验 Agnes 配置是否加载成功/login登录 Anthropic 官方账号⚠️【Agnes 绝对禁止】一旦执行自定义网关直接失效/logout退出 Anthropic 官方账号中转模式不需要/effort设置推理强度max/medium/low对应思考深度例/effort max/usage//stats查看 token 消耗统计五、项目 配置相关命令作用/init自动扫描项目生成 CLAUDE.md 项目说明文件/run运行项目技能启动应用验证改动效果/run-skill-generator生成项目构建 / 启动的 skill 脚本/sandbox切换沙箱模式平台支持才可用六、隐藏 / 调试命令普通开发基本不用命令作用/heapdump导出内存快照排查内存泄漏不要分享导出文件包含密钥【CLI 启动参数命令终端执行不是会话斜杠命令】在 CMD/PowerShell 直接敲claude xxx不是进入 claude 会话后输入# 直接启动交互会话 claude # 继续当前目录最近一次对话 claude -c # 恢复指定会话 claude -r 会话名 # 一次性提问执行完直接退出非交互式 claude -p 帮我写mybatis xml # 指定配置目录多环境隔离Agnes/官方Anthropic分开 claude --config-dirC:\claude-agnes # 给会话命名 claude --name mysql-docker开发CLAUDE开发宪法定义C:\Users\cyz\.claude\CLAUDE.mdCLAUDE.md# 核心行为准则 1. 所有回答都需要使用简体中文。 2. 上下文接近80%的时候提醒我。 3. 遇到配置文件中deny绝对禁止的操作立即停止并提醒我不要尝试其他方式执行。 4. 如果要修改settings.json的内容修改之前务必告诉我允许之后才能修改。 5. 每次回答要精准不绕弯子拿不准的提前问我不编造。 # 工作流程 1. 涉及 3 个以上文件改动时先输出中文实施方案等我确认后再编码。 2. 生成代码时文件名、变量名、函数名等命名要简洁明了见名知意。 3. 遇到报错时先用通俗的中文解释错误含义再给修复方案。作用说明CLAUDE.md放在项目根目录Claude Code 启动后会自动读取这个文件作为全局行为约束相当于给 AI 设定项目内固定规则。它和settings.json的区别settings.json配置类权限、环境变量、模型网关等底层参数CLAUDE.md行为规则规定 AI 怎么回答、怎么干活、编码规范使用方法在项目根目录新建文件CLAUDE.md粘贴上面全部内容保存启动 claude 会话AI 自动读取生效可扩展补充# 补充规则可选 - 优先使用Java后端技术栈写MyBatis、SpringBoot代码优先给出完整可复制SQL/XML - 输出代码尽量使用Markdown代码块注释清晰 - 不自动执行删除类高危操作ClaudeCode 规则文件位置文件位置分类文件路径作用使用场景用户全局位置C:\Users\你的用户名\.claude\CLAUDE.md全局规则本机所有项目生效统一控制你电脑全部项目的 AI 行为项目根目录团队项目文件夹\CLAUDE.md当前项目规则团队共享团队成员共用提交到 git 仓库项目根目录补充规则项目文件夹\.claude\rules\xxx.md补充规则文件拆分多条独立规则方便管理项目根目录个人私有项目文件夹\CLAUDE.local.md当前项目仅本地个人生效不会提交 git自己私人规则不影响团队其他人模块子目录项目文件夹\模块文件夹\CLAUDE.md子模块独立规则单独约束某个子模块的编码行为加载优先级由高到低后面覆盖前面子模块目录内的CLAUDE.md项目根目录CLAUDE.local.md个人本地私有项目根目录CLAUDE.md团队共享项目.claude/rules/下所有 md 规则文件用户全局C:\Users\用户名\.claude\CLAUDE.md✅ 重点CLAUDE.local.md不会被 git 提交适合写你自己私有的配置、个人偏好不污染团队仓库。和 settings.json 的位置对应全局 settings.jsonC:\Users\你的用户名\.claude\settings.json项目级 settings.json项目文件夹\.claude\settings.json同样项目目录的 settings.json 优先级 用户全局 settings.jsonClaudeCode 开发宪法小结CLAUDE.md 是用户编辑的绝对规则AI 必须遵守ClaudeCode 会从当前目录向上递归查找所有claude.md系列文件加载顺序由远到近拼接全部规则全局先加载项目本地后加载就近原则后面更近目录的规则会覆盖前面远处目录的冲突规则ClaudeCode不会主动修改 CLAUDE.md必须由用户明确要求才会改动一句话理解多层级的 CLAUDE.md 会全部合并生效离代码文件越近的规则优先级越高覆盖上层冲突规则AI 不会擅自改动这个文件。知识点的快速记忆全局C:\Users\用户名\.claude\CLAUDE.md最远优先级最低项目根CLAUDE.md团队共用 CLAUDE.local.md个人私有优先级更高子模块目录CLAUDE.md最近优先级最高就近原则示例 全局文件写 “使用英文输出”项目根 CLAUDE.md 写 “全部简体中文”则项目内执行时项目规则覆盖全局输出中文。对接skillskills下载地址anthropic官方仓库https://github.com/anthropics/skillsSkills社群网站Agent Skills Marketplace | Codex Claude Skills | SkillsMP优秀开源集合https://github.com/ComposioHQ/awesome-claude-skills视频制作 skillhttps://github.com/remotion-dev/skillsyoutube视频剪辑skillhttps://github.com/op7418/Youtube-clipper-skill大师帮你创建skill的skillhttps://github.com/GBSOSS/skill-from-mastersnotebookLM skillhttps://github.com/PleasePrompto/notebooklm-skillmarkdown发布到X skillhttps://github.com/wshuyi/x-article-publisher-skill使用skill在C:\Users\cyz\.claude文件夹下创建skills文件夹然后把查询天气的skill放进去