尧图网站建设 免费方案咨询
ARTICLE DETAIL

资讯详情

深耕网站建设、视觉设计与SEO优化的一线实战洞察。

首页/资讯中心/资讯详情

claude-code教程

发布时间：2026/10/31 1:56:08 尧图网站建设
claude-code教程

安装及配置

安装

npm install -g @anthropic-ai/claude-code --allow-scripts=@anthropic-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 -r

Claude Code 三种权限控制

这是 Claude Code CLI 的操作执行权限 / 运行模式，控制它能不能自动修改文件、执行 shell 命令，不是 API 登录鉴权。

方式一：启动时绕过权限

启动 claude 的时候，通过启动参数 / 环境变量，直接放开权限校验。

作用：启动就关闭交互确认，不需要每次工具调用手动同意。

方式二：会话内切换模式（快捷键Shift + Tab呼出菜单）

在 claude 对话窗口，按Shift+Tab调出模式切换面板，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-dir="C:\claude-agnes" # 给会话命名 claude --name "mysql-docker开发"

CLAUDE开发宪法

定义

C:\Users\cyz\.claude\CLAUDE.md

CLAUDE.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 怎么回答、怎么干活、编码规范

使用方法

  1. 在项目根目录新建文件CLAUDE.md
  2. 粘贴上面全部内容保存
  3. 启动 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子模块独立规则单独约束某个子模块的编码行为

加载优先级（由高到低，后面覆盖前面）

  1. 子模块目录内的CLAUDE.md
  2. 项目根目录CLAUDE.local.md（个人本地私有）
  3. 项目根目录CLAUDE.md（团队共享）
  4. 项目.claude/rules/下所有 md 规则文件
  5. 用户全局C:\Users\用户名\.claude\CLAUDE.md

✅ 重点：CLAUDE.local.md不会被 git 提交，适合写你自己私有的配置、个人偏好，不污染团队仓库。

和 settings.json 的位置对应

  • 全局 settings.json：C:\Users\你的用户名\.claude\settings.json
  • 项目级 settings.json：项目文件夹\.claude\settings.json

同样：项目目录的 settings.json 优先级 > 用户全局 settings.json

ClaudeCode 开发宪法小结

  1. CLAUDE.md 是用户编辑的绝对规则，AI 必须遵守
  2. ClaudeCode 会从当前目录向上递归查找所有claude.md系列文件
  3. 加载顺序：由远到近拼接全部规则（全局先加载，项目本地后加载）
  4. 就近原则：后面更近目录的规则，会覆盖前面远处目录的冲突规则
  5. ClaudeCode不会主动修改 CLAUDE.md，必须由用户明确要求才会改动

一句话理解

多层级的 CLAUDE.md 会全部合并生效，离代码文件越近的规则优先级越高，覆盖上层冲突规则；AI 不会擅自改动这个文件。

知识点的快速记忆

  • 全局：C:\Users\用户名\.claude\CLAUDE.md（最远，优先级最低）
  • 项目根：CLAUDE.md（团队共用） +CLAUDE.local.md（个人私有，优先级更高）
  • 子模块目录：CLAUDE.md（最近，优先级最高）

就近原则示例： 全局文件写 “使用英文输出”，项目根 CLAUDE.md 写 “全部简体中文”，则项目内执行时，项目规则覆盖全局，输出中文。

对接skill

skills下载地址


anthropic官方仓库
https://github.com/anthropics/skills

Skills社群网站
Agent Skills Marketplace | Codex & Claude Skills | SkillsMP

优秀开源集合
https://github.com/ComposioHQ/awesome-claude-skills

视频制作 skill
https://github.com/remotion-dev/skills

youtube视频剪辑skill
https://github.com/op7418/Youtube-clipper-skill

大师帮你创建skill的skill
https://github.com/GBSOSS/skill-from-masters

notebookLM skill
https://github.com/PleasePrompto/notebooklm-skill

markdown发布到X skill
https://github.com/wshuyi/x-article-publisher-skill

使用skill

在C:\Users\cyz\.claude文件夹下创建skills文件夹

然后把查询天气的skill放进去

网站建设 视觉设计 SEO优化
返回列表