夜雨聆风学习资料网

ARTICLE · 1122233

Claude Code教程:从安装、配置模型到实战实例

Claude Code教程:从安装、配置模型到实战实例

   Claude Code 超详细教程:从安装、配置模型到实战实例(新手到进阶全路径) 

     本文整合了十篇高质量 Claude Code 教程的精华,按照「认知 → 安装 → 配置 → 权限与纪律 → 工作流 → 使用技巧 → 实战实例 → 进阶 → 成本 → 避坑 → 练习」的路径重新组织,所有步骤均可复现。文末附避坑清单与可复制的万能 Prompt 模板,建议收藏后对照操作。   

   如果你最近关注 AI 编程圈,一定绕不开一个名字:Claude Code(简称 CC)。它是 Anthropic 在 2025 年 2 月推出的、运行在终端中的智能体编程工具(Agentic Coding Tool)。 

   先厘清它和常见工具的区别,避免定位混淆: 

         工具       

         做的事       

         GitHub Copilot       

         补下一行 / 下一个函数       

         Cursor       

         编辑器内 AI 改写       

Claude Code

         进到项目里,读代码、改多文件、跑测试、修 Bug、提 commit       

   关键区别:Claude Code 不是只告诉你"应该怎么改",而是能真正进入你的项目动手改——它读 package.json、查入口文件、跑命令、分析错误,然后把结果交给你检查。这是它和网页版聊天机器人的本质不同。它还有一项最值得优先掌握的 8 项核心能力: 

         优先级       

         能力       

         一句话       

         ★★★★★       

         项目理解       

         让 CC 先"看懂"项目,是一切后续工作的基础       

         ★★★★★       

         Agent 自动改代码       

         "实现这个功能",它自动找文件、改代码、跑测试       

         ★★★★★       

         Debug       

         "为什么出错?找到原因并修复",像工程师一样先诊断       

         ★★★★★       

         测试       

         "运行测试,失败就修复",它还会分析失败原因       

         ★★★★★       

         Git       

         "检查修改并创建 commit",但你要看 diff       

         ★★★★★       

         CLAUDE.md       

         让 CC 长期记住项目规则,启动时自动加载       

         ★★★★       

         MCP       

         接入 GitHub、数据库、浏览器、API 等外部工具       

         ★★★★       

         自动化       

         把"分析→编码→测试→Git→PR"变成半/全自动流程       


   一、安装与环境搭建 

   1.1 环境要求 

  • Node.js 18+
    (官方硬性要求;建议装 LTS 长期支持版,别选 Current) 
  • Git
    (推荐装:项目改动感知、自动提交、跨会话进度回顾都依赖它。Claude Code 基础使用不强制 Git,但强烈建议装) 
  •    一个支持的 Claude 账户 / API 方式 

   1.2 安装 Claude Code(四种方式) 

方式 A:官方脚本(macOS / Linux / WSL,推荐,自带自动更新)

  curl -fsSL https://claude.ai/install.sh | bash   

方式 B:WinGet(Windows 国内用户首选)

   微软官方源,国内可直连,完美规避 claude.ai 地区访问限制: 

  winget install Anthropic.ClaudeCode   winget upgrade Anthropic.ClaudeCode   # 手动升级(WinGet 版无自动更新)   

方式 C:PowerShell / CMD 原生安装(需代理)

  # PowerShell   irm https://claude.ai/install.ps1 | iex   # CMD   curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd   

方式 D:npm 安装(已装 Node 18+ 可用)

  npm install -g @anthropic-ai/claude-code   

     ⚠️ 重要警告:官方明确提醒不要用 sudo npm install -g,后期权限会出问题。若 npm 下载慢,可临时切国内镜像:npm config set registry https://registry.npmmirror.com,装完再恢复 npm config set registry https://registry.npmjs.org。   

   Mac 用户也可用 Homebrew:brew install --cask claude-code(Homebrew 版无自动更新,需 brew upgrade claude-code)。 

让 AI 帮你装(最"AI 原生"):在 Cursor 等编辑器终端里说"帮我安装 node 并用 npm 安装好最新的 claude code",它会连依赖和网络问题一起处理。 

   1.3 Windows 路线:Git Bash(最轻量)或 WSL(类 Linux) 

   一个关键认知:Claude Code 在 Windows 上原生跑在 Git Bash 环境里,没装 Git 后面会各种报错;官方也推荐 Git Bash 而非 PowerShell(后者部分交互组件显示不正常)。 

路线一:Git Bash 路线(推荐新手,约 15 分钟跑通)

  1.    检查 Node:Win+R 输入 cmd 回车,敲 node -v。显示 v22+ 即可;显示 v16/以下或报错,去 nodejs.org 下载 LTS 的 .msi 一路 Next(务必勾选 Add to PATH)。 
  2.    装 Git for Windows(git-scm.com),全部默认即可;开始菜单打开「Git Bash」用它与 CC 交互。 
  3.    在 Git Bash 里 npm install -g @anthropic-ai/claude-code,claude --version 验证。 

路线二:WSL 路线(进阶,类 Linux 环境)\   Windows → WSL → Ubuntu → Claude Code。注意 WSL 与 Windows 是两个环境,Windows 里的 Node.js ≠ WSL 里的 Node.js,需在 Ubuntu 内单独装 Node。以管理员 PowerShell 执行 wsl --install 重启后设置用户名密码(输入密码不显示星号属正常)。 

多 Node 版本管理:若报 engine 版本错误(Node \< 18),用 nvm-windows 切换版本。\     Git Bash 路径配置:若 Git 装在非默认路径,在 ~/.claude/settings.json 加 {"env": {"CLAUDE_CODE_GIT_BASH_PATH": "C:\Program Files\Git\bin\bash.exe"}}。\     安装目录提醒:安装包所在文件夹名称不要含中文和空格。   

   1.4 验证与自检 

   安装后务必重新打开终端(刷新 PATH 环境变量),再验证: 

  claude --version    # 看到版本号即安装成功   claude doctor       # 内置全面诊断,自动排查依赖/PATH/版本问题(排错首选,强烈建议跑一次)   

   1.5 网络、地区限制与登录提示 

  • 地区限制
    :Anthropic 官方服务仅支持部分海外地区,国内直连官方脚本会提示 App unavailable——这是地区限制,并非操作问题。应对思路:用 WinGet 安装,或通过 cc-switch 接入国内厂商,无需强行挂代理。
  • 代理设置(Windows 高频痛点)
    :npm 下载卡住可 npm config set proxy <代理地址>;登录成功但请求超时,在 Git Bash 设 export HTTPS_PROXY=http://127.0.0.1:端口号 后同一窗口重跑 claude。 
  •    浏览器没自动弹授权页,复制终端里的 URL 手动打开即可;公司电脑默认浏览器被管控就换浏览器。 
  •    401 / 无额度多半是登录方式选混了:有订阅选"账号登录",用 API Key 选"Console",运行 claude 后在设置里退出重登。 
  •    不要把你真实的 API Key、密码、验证码复制到对话记录里。 

   1.6 Windows 高频报错速查 

         报错现象       

         原因与解法       

claude 不是内部或外部命令

         PATH 未刷新。先关掉所有终端重开;仍不行把 %USERPROFILE%\.local\bin(WinGet)或 npm config get prefix 的输出路径加入系统 PATH       

         官方安装脚本提示 App unavailable

         国内地区限制。改用 winget install Anthropic.ClaudeCode 或 cc-switch 接国内厂商       

         安装报 engine 版本错误       

         Node \< 18。升级 Node,或用 nvm-windows 切到 18+       

         npm 下载超时/卡死       

         默认源不通。挂代理 npm config set proxy,或临时 npm config set registry https://registry.npmmirror.com;运行时还要单独设 HTTPS_PROXY

         PowerShell 里报错/界面异常       

         非 bug,官方在 Windows 就推荐 Git Bash,直接换       

         登录时浏览器没弹授权页       

         复制终端里的 URL 手动打开;被管控就换浏览器       

         能登录但每次请求超时       

         网络到不了 Anthropic,设 export HTTPS_PROXY=http://127.0.0.1:端口号 后重跑 claude

         Windows 无法 Ctrl+V 粘贴图片       

         已知官方问题。用 Alt+V 粘贴,或把图片文件拖拽进终端       

         国内模型返回 404       

         模型名已变更,务必查阅厂商官方文档确认当天可用模型名       

   1.7 在 VS Code 里搭建 Claude Code(IDE 集成,推荐新手) 

   光在终端里用 Claude Code 也能干活,但把 Claude Code 装进 VS Code后,你能一边看它改代码、一边在编辑器里直接 review diff,体验好很多。这一节把"IDE 集成"的完整路径补齐(对应第 11 篇教程)。 

第一步:装 VS Code 本体

  •    官网:[https://code.visualstudio.com/](https://code.visualstudio.com/),下载对应系统安装包,双击安装即可。 
  •    它是后面所有图形化操作的工作台;没装 VS Code 之前,Claude Code 只能在纯终端里跑。 

第二步:安装 Claude Code 扩展

  1.    打开 VS Code,点击左侧活动栏的「扩展」图标(或 Ctrl+Shift+X)。 
  2.    搜索框输入 Claude Code,找到官方扩展后点击「安装」。 
  3.    扩展装好后,IDE 内会自带一个集成终端面板——也可以在 VS Code 里用 \Ctrl+\\\`(反引号)直接拉起终端。 

第三步:装中文语言包(可选但推荐)

  •    扩展市场再搜 Chinese(全称「Chinese (Simplified) Language Pack」),安装后重启 VS Code,界面即汉化。 
  •    顺带一提:之前讲的 /config 里把 Output Style 调成中文,是让Claude 的回复用中文;这里装语言包是让 VS Code 软件界面用中文,两件事不冲突。 

第四步:在 IDE 内启动 Claude Code

  •    在 VS Code 的终端面板里输入 claude 回车。如果提示"不是内部或外部命令",回到 1.6 的速查表处理 PATH 问题。 
  •    启动后按提示完成一次认证(桌面版需科学上网;走 npm / WinGet / 国内厂商路线则无需)。 
  •    启动成功会显示 Claude 信息横幅。此时左侧三个按钮分别对应文件树、搜索、以及 Claude Code 对话面板,终端栏可以上拉放大,方便长对话。 

桌面版 vs 终端版:Claude Code 还有独立桌面版,官网 [https://claude.com/product/claude-code](https://claude.com/product/claude-code),但国内访问常需科学上网。对新手而言,终端 / npm / VS Code 扩展路线更稳,优先走这条。   

权限模式的命名对照:VS Code 扩展的交互界面把权限分成四档,和命令行完全一致—— 

         VS Code 界面叫法       

         命令行等价       

         行为       

         计划模式       

Shift+Tab 切到 Plan       

         只做计划,完全不修改任何文件       

         默认模式       

         Default       

         每次动手前、改文件前都要征得你同意       

         半自动模式       

         Accept Edits       

         编辑文件等常见命令不再逐项询问,但中断命令和网络请求仍需你同意

         权限全开模式       

--dangerously-skip-permissions

         自动完成任务,效率最高、安全风险最大,仅限受信任的沙箱       


   二、配置模型:官方订阅 or 国内厂商接入 

   Claude Code 是通用 Agent 框架,不绑定特定模型。国内用户直连官方常受地区限制,优先选本土厂商接入——速度更快、成本更低、无需代理。 

   路线 A:官方订阅(海外 / 企业) 

   首次 claude 按提示登录,支持 Claude Pro / Max / Team / Enterprise、Anthropic Console API Key,以及 AWS Bedrock、Google Vertex AI(企业场景)。免费聊天账户无法使用 CC。 

   路线 B:国内厂商接入(国内用户最优解) 

   智谱 GLM、Kimi、DeepSeek 均原生兼容 Anthropic 协议,国内直连、无需代理、价格低于官方。配置方式二选一:写环境变量,或用 CC Switch 可视化热切换。 

① 智谱 GLM(国产编程模型首选)

  export ANTHROPIC_BASE_URL=https://open.bigmodel.cn/api/anthropic   export ANTHROPIC_AUTH_TOKEN=你的智谱APIKey   export ANTHROPIC_DEFAULT_OPUS_MODEL=glm-5.2   export ANTHROPIC_DEFAULT_SONNET_MODEL=glm-5.2   

② Kimi K2.7 Code(高性价比、低 token 消耗)

  export ANTHROPIC_BASE_URL=https://api.moonshot.cn/anthropic   export ANTHROPIC_API_KEY=你的Kimi_API_Key   export ANTHROPIC_MODEL=kimi-k2.7-code   

③ DeepSeek(超低预算首选,1 元起充)

  export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic   export ANTHROPIC_AUTH_TOKEN=你的DeepSeek_API_Key   export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro   export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-flash   

④ 硅基流动 SiliconFlow:官网 siliconflow.cn 登录 → 左侧「API 密钥」新建并复制 → 粘进 CC Switch 即可(可接多种模型)。 

     ⚠️ 关键提醒:模型名变动频繁,配置务必以厂商官方文档当天说法为准,切勿照抄老旧教程。   

CC Switch(国内用户必备):开源工具,支持一键切换 Claude Code / Codex 等多工具的模型供应商,无需手改配置;支持热切换、用量统计仪表盘、统一 MCP 面板、配置自动备份。Windows 下从官网 ccswitch.ai/zh 下载 .msi 安装包,Mac 下 brew install --cask cc-switch。 

     🔴 翻车坑:用 CC Switch 切换配置必须在启动 claude 之前完成,已进入会话再去切会切不动并引导登录。口诀:先切换,后启动。   


   三、权限模式与"先分析"纪律 

   3.1 三种权限模式 

   会话中按 Shift + Tab 循环切换: 

         模式       

         行为       

         适合场景       

Plan Mode(规划模式)

         只调查、给方案,不动手改文件       

         陌生项目、重大改动前审方案       

Default / Normal(默认模式)

         文件操作按规则询问,智能判断       

         新手日常使用       

Accept Edits(自动接受编辑)

         改文件不再问,跑命令仍会确认       

         方案明确后的快速迭代       

   另有启动时加 --dangerously-skip-permissions 的"一路绿灯"模式——官方明确提醒谨慎使用,新手请勿开启。 

   3.2 安全模型:每次操作你要拍板 

   CC 默认只有一条铁律:改文件 / 跑命令前,必须你同意。你会看到 diff 后选: 

  • Yes
    :改这次 
  • Yes, and don't ask again for edits
    :本次会话自动改文件 
  • No
    :拒绝并补充说明 

   看到 rm -rf ...、git reset --hard、format 这类危险命令,必须停下来。 

   3.3 铁律第一条:先分析,不要修改 

   进入 CC 后第一句话不要是"帮我修改项目",而是先让它完整理解项目。收到权限询问也别无脑 Yes。这是防止 Agent 失控最重要的习惯。 


   四、你与 Claude 的分工:工作流 

   不要"我要一个功能 → CC 马上改",而是遵循稳定流程。你负责需求、确认方案、验收;CC 负责分析、执行、测试、修复。 

完整 6 步开发工作流(日常够用): 

  新需求 → /init 初始化 → Explore(看项目)→ /plan 规划 → Code(改)         → Agents/Skills/MCP(扩展)→ Test → /simplify 优化 → Code Review         → /compact /clear /rewind(上下文管理)→ git diff → Commit   

你与 CC 的 8 阶段角色分工: 

         阶段       

         动作       

         执行者       

         1 需求       

         提出任务       

         你       

         2 分析       

         阅读项目代码       

         Claude       

         3 方案       

         制定修改计划       

         Claude       

         4 确认       

         审查方案       

         你       

         5 执行       

         修改文件       

         Claude       

         6 测试       

         运行测试       

         Claude       

         7 修复       

         修复失败       

         Claude       

         8 验收       

         检查 Diff + Commit       

         你       


   五、核心使用技巧 

   技巧 1:会提问——结构化 Prompt(角色+上下文+约束+验收) 

   差结果第一反应往往是"换个更聪明的模型",但瓶颈几乎总在输入。应用结构化标签让指令、约束、流程明确: 

  <目标>解决用户登录接口偶发 500 的问题。</目标>   <约束>1. 不重构架构 2. 不修改数据库结构 3. 不修改前端 4. 尽可能少改文件</约束>   <流程>1. 先定位问题 2. 不要立即修改 3. 告诉我根因 4. 给出方案 5. 等我确认 6. 再执行 7. 运行测试 8. 失败则继续修复</流程>   <最终输出>1. 根因 2. 修改文件 3. 修改内容 4. 测试结果</最终输出>   

   黄金句式 = 角色 + 上下文 + 约束 + 验收。例如:"你是有 8 年后端经验的工程师。项目:Next.js + Prisma + PostgreSQL。任务:加邮箱登录,用 JWT,密码 bcrypt 加密。要求:1. 不改现有 User 表结构之外的内容 2. 遵循项目现有错误处理风格 3. 写单测 4. 不提交,只改文件并告诉我 diff。" 这比"写个登录"质量高 10 倍。 

   四要素不可缺:目标单一、范围明确、验收标准、负面清单(告诉它不要做什么。Claude 有过度设计倾向,加一句"保持简单,不要添加我没要求的抽象层"能有效约束)。 

   技巧 2:会交互——@文件、贴图、Bash 模式 

  • @文件
    :把指定文件"递"给它,省去搜索、帮你省 token;长需求先写进文档再 @ 它。 
  • 贴图片
    :截图拖进对话框(或 Alt+V),用多模态能力还原设计稿、调配色。 
  • Bash 模式
    :! 前缀直接执行终端命令,如 ! ls、! npm run dev。 
  • 换行快捷键
    :命令行里 Shift+Enter 是直接发送(很多人把半截提示词发出去了)。通用换行用 Ctrl + J;Mac 上 Option+Enter、Windows 上 Ctrl+Enter。 
  • 实时插话
    :执行中随时插入新指令调整方向;按 Escape 立即中断。 

   技巧 3:会管理上下文——用久了"变笨"的解药 

   对话、读过的文件、执行结果都在挤占上下文,而模型性能在上下文占用 20%–40% 时就开始缓慢下降。 

  • /context
    :可视化查看占用(含各 MCP/Skill 占比) 
  • /compact
    :压缩历史、保留关键信息。上下文超过 60% 就主动压缩。记忆口诀:/clear=换任务了;/compact=还在做这个任务但太长了 
  • /clear
    :彻底清空重开;切到不相关任务时果断清场(项目规则在 CLAUDE.md 里,不怕丢) 
  • /resume
    :恢复历史会话 
  • 一个会话只做一个任务
    :混着做会让它"越聊越糊涂" 

   技巧 4:会用项目记忆——CLAUDE.md 

   CC 每次会话开头自动读取的项目说明书,三层:全局级~/.claude/CLAUDE.md、项目级(根目录,随仓库共享)、文件夹级。 

模板示例: 

  # NovelScope 项目规则   ## 项目目标   NovelScope 是一个小说潜力分析 AI Agent。   ## 技术栈   Node.js / Express / SQLite / 前端 Web / DeepSeek API   ## 开发原则   1. 不随意重构架构 2. 优先增量开发 3. 修改前先理解现有代码   4. 修改尽量小 5. 不删除已有功能 6. 修改后必须测试   7. API 修改后必须验证 8. 不修改 .env 中的 API Key   ## 输出要求   每次完成任务后说明:修改了什么/哪些文件/为什么修改/测试结果/是否还有风险   

写法三原则:简洁(控制在 200 行内,只放顶层稳定规则)、说原因、持续更新(同一错误纠正两次就写入;# 键可快速追加)。/init 可自动扫描项目生成初稿。 

   技巧 5:会后悔——回滚与 Git 安全网 

  • 双击 Escape / /rewind
    :回滚界面可选"只回滚对话 / 只回滚文件 / 两者都回滚"。局限:只能回滚它编辑过的文件,终端命令产生的变化撤不回。 
  • Git 才是安全气囊
    :重大任务前先 git add . && git commit -m "before claude task"。下载、安装、绑定、提交、回滚全可让 CC 用自然语言代劳。 

   技巧 6:会分配算力——模型与思考深度 

  • 模型选择
    :Opus 更聪明,适合架构规划与复杂推理;Sonnet 更快更省,适合路径清晰的日常开发;Haiku 最轻。推荐 Opus 规划 → Sonnet 实现(用 /model 切换)。 
  • 思考深度关键词
    :提示词末尾加 think → think hard → think harder → ultrathink,逐级加深。 

   技巧 7(进阶):会 Debug——先诊断,再治疗 

   遇到报错别自己乱改,直接让 CC 排查并要求"先不修改": 

     请排查:浏览器访问 http://localhost:3000/ 出现 ERR\_CONNECTION\_REFUSED。请:1. 检查服务器是否启动 2. 检查 3000 端口 3. 检查 package.json scripts 4. 检查 Express 入口 5. 检查最近修改 6. 检查 EADDRINUSE 7. 找到根因。先不要修改任何代码,找到原因后告诉我。   

   确认原因后,再用"最小修改,不要重构"的方式修复。这是 CC 最有价值的用法之一。 

   常用命令速查表 

         命令       

         用途       

claude

         启动交互模式       

claude "任务描述"

         带任务启动       

claude -c / --continue

         继续上次对话       

claude --resume

         恢复指定会话       

claude --help/

         查看当前环境可用命令(命令会随版本变化,以本机为准)       

claude doctor

         全面诊断环境、排错       

claude update

         更新版本       

claude -p "任务"

         非交互(无头)模式,适合脚本       

claude -p --max-turns 3 "任务"

         限制 Agent 回合,控制成本       

/init

         扫描项目生成 CLAUDE.md       

/plan

         只规划不改动       

/agents

         管理子代理(拆分复杂任务)       

/skills

         使用/管理 Skill(固定重复流程)       

/mcp

         管理 MCP 连接       

/simplify

         检查/简化代码(编码后 Review)       

/loop

         重复执行任务(周期性本地任务)       

/btw

         临时旁问(不污染主上下文)       

/model/config

         切换模型 / 打开设置       

/permissions

         查看/配置权限白名单(如禁止读 .env)       

/context/compact/clear/rewind

         上下文管理       

/resume/status

         恢复会话 / 查看用量       

git diff + 测试

         提交前检查改动、验证结果       


   六、实战实例:让你能复现的两个项目 

  实例 A(零基础友好):课堂随机点名器 

   目标:做一个单 HTML 文件的网页点名器——粘贴学生名单、点击按钮随机滚动抽取、被抽中高亮、记录最近 10 次结果。 

Step 1 进入项目并启动

  cd ~/my-tools   claude   

Step 2 切到 Plan 模式提需求:按 Shift+Tab 切 Plan Mode,发送"请帮我做一个课堂随机点名器:1. 单个 HTML 文件双击即可打开 2. 文本框粘贴名单(每行一个)3. '开始点名'按钮点击后名字快速滚动 2 秒后随机停并高亮 4. 记录最近 10 次 5. 界面简洁字体大适合投影。先给实现方案,不要写代码。" 

Step 3 确认方案,切 Accept Edits 执行:"方案可以,开始实现。只创建这一个 HTML 文件,不要引入外部依赖。" 

Step 4 运行验证:! open 点名器.html(Mac)/ ! start 点名器.html(Windows),自己点一遍。"它说做完了"不等于"真做对了"。 

Step 5 迭代:截一张图拖进对话框"参考这张截图配色优化界面,保持功能不变";不满意双击 Esc 回滚。Step 6/init 生成 CLAUDE.md。Step 7 让它"初始化 Git 仓库并提交当前所有文件"。 

   实例 B(工程实战):给 Express 项目加健康检查 API(含 Debug 训练) 

   完整训练"理解→找文件→方案→修改→测试→Debug→Git"。 

Step 1 先看懂项目(不修改):"我要给当前项目增加 GET /api/health。先不要修改代码。请分析:1. Express 后端入口在哪 2. API 路由在哪 3. 最适合放哪 4. 用什么方式启动 5. 如何测试。先给我修改计划。" 

Step 2 确认后执行:"方案可以,现在执行。要求:只改实现所需文件、不重构、不改数据库、不改前端、不改现有 API、改完运行测试、失败则分析原因修复、最后告诉我改了哪些文件。" 

   你会看到 Read server.js → Edit server.js → Run npm test 的完整流程,不要打断。 

Step 3 测试:curl http://localhost:3000/api/health 期望返回 {"status":"ok",...}。 

Step 4 训练 Debug——故意制造 404:"假设访问返回 404。先不要修改。分析:1. 为什么 404 2. 路由注册在哪 3. Express 怎么启动 4. 路由是否正确挂载。找到原因后告诉我。" 确认原因后再最小修改修复。 

Step 5 Git 存档:先 git status,再 git add <文件> && git commit -m "Add health API"。 


   七、进阶路线图:下一步学什么 

         能力       

         一句话       

         何时学       

         自定义命令       

         把常用提示词打包成 /命令,存 .claude/commands/

         同类任务做过 3 次以上       

         Skill(技能包)       

         领域的"操作手册",按需自动加载       

         想掌握特定领域最佳实践       

         SubAgent(子代理)       

         有独立上下文的分身,并行干活       

         主任务耗时且可拆分(如调研)       

         Hooks(钩子)       

         特定事件自动触发(如改完代码自动格式化)       

         有固定重复流程要自动化       

         MCP       

         连接 GitHub、数据库、浏览器、API       

         需稳定调用外部系统       

         无头模式 -p

         执行一次即退出,可写进脚本,--output-format json 输出结构化结果       

         把 AI 嵌入自动化工作流       


   八、成本控制:别被"软件免费"误导 

   Claude Code 软件本身不单独收费,模型调用计费取决于方案:Pro / Max 订阅按套餐,Console / API 按 token。 

  •    据实际使用经验,Pro 订阅约 \*\*$20/月**,重度使用(每天数小时)比 API 按量更划算;轻度尝鲜 API 按量更灵活,一个月可能仅几美元,修一个中等 Bug 实际约 $1。 
  •    据实战教程引用的 2026 年官方定价,Sonnet 标准 API 约每百万输入 token 2 美元、输出 10 美元,更强的 Opus 更贵。国内厂商(智谱/Kimi/DeepSeek)价格普遍更低。 
  •    关键认知:CC 不是"一次 Prompt = 固定几分钱"。一次复杂任务可能读 10 文件 → 执行命令 → 发现错误 → 再读 → 修改 → 测试 → 再修复,Agent 自主程度越高,token 消耗与风险也越高。用 -p --max-turns N 限制回合、--max-budget-usd 设费用上限。复杂任务用强模型,简单任务别浪费最贵模型。 

   九、新手避坑清单与 5 条铁律 

10 条血泪经验

  1.    先切换后启动:CC Switch 换模型必须在启动 claude 之前; 
  2.    上下文 30% 即开始劣化,60% 就该 /compact,不相关任务果断 /clear; 
  3.    一个会话一个任务,混着做模型会"糊涂"; 
  4.    CLAUDE.md 不是越长越好,控制在 200 行内,只放顶层稳定规则; 
  5.    指令太短反而更费 token,具体描述又准又省; 
  6.    Shift+Enter 是发送不是换行,通用换行 Ctrl+J;Windows 粘贴图片用 Alt+V; 
  7.    "测试通过"要亲眼看命令和输出,自己再走一遍; 
  8.    回滚有边界,终端命令产生的变化靠 Git 兜底; 
  9.    auto / 跳过权限 ≠ 可以离屏,目标与改动仍需人来把关; 
  10. 一次让它做 20 件事(改 UI+登录+数据库+部署…)它会失控
    ,一次一个目标。 

5 条铁律

  1.    永远先说"先分析,不要修改"——防止 Agent 失控; 
  2.    永远要求"告诉我涉及哪些文件"——掌控修改范围; 
  3.    永远强调"最小修改,不要重构"——降低风险; 
  4.    修改以后必须测试——验证正确性; 
  5.    完成以后 git status 检查修改——新手极易忽略的安全习惯。 

   十、与 IDE / Codex 如何分工 

   Claude Code 不必取代你的 IDE。二者可并存:Cursor / Qoder 负责你观察代码、手动开发;Claude Code 负责执行复杂任务与自动化(理解项目、跑命令、Debug、测试、Git)。Codex(OpenAI)桌面版对轻量开发、可视化调试更友好,可与 CC 互补,用 CC Switch 统一管理多模型切换。 


   十一、新手起步练习清单(照着做) 

  1.    让 CC 用 5 条讲清楚你当前项目 
  2.    让它找"没人调用的死代码" 
  3.    修一个真实 Bug(贴报错即可) 
  4.    给一个函数补单测 
  5.    生成 CHANGELOG / PR 描述 
  6.    用 /plan 设计"积分系统"再决定是否落地 
  7.    写 CLAUDE.md 并让下次会话遵守 
  8.    用 claude -p "..." 做一次性脚本任务(如"监控某文件夹,新文件按日期归档") 

   写在最后 + 万能 Prompt 模板 

   CC 是副驾驶,不是自动驾驶。它的价值不在于让 AI 写代码,而在于让你从"手动改代码"的开发者,变成"指挥 AI 改代码"的技术管理者。你值钱的不再是手速,而是:会不会拆任务、会不会写清楚约束、会不会审 diff、会不会验收。 

   把下面这版可直接复制的万能模板存好,开发任何项目填【当前任务】即可: 

  你现在是这个项目的高级软件工程师。请严格遵守以下开发规则。   <开发原则>   1. 不随意重构现有架构。   2. 优先采用增量开发。   3. 修改前先理解现有代码。   4. 尽量减少修改文件数量。   5. 不删除现有功能。   6. 不修改与当前任务无关的代码。   7. 不修改 .env 中已有的 API Key。   8. 不擅自改变数据库结构。   9. 不擅自改变现有 API 返回格式。   10. 修改完成后必须进行测试。   </开发原则>   <工作流程>   第一阶段:理解——先阅读与当前任务有关的文件。   第二阶段:分析——告诉我当前代码如何工作、问题在哪、涉及哪些文件、准备怎么修改。此阶段不要修改文件。   第三阶段:执行——得到确认后再修改。   第四阶段:测试——运行相关测试,检查语法、API、现有功能。   第五阶段:修复——如果测试失败,找到根因并修复,再测试。   第六阶段:汇报——告诉我完成了什么、修改了哪些文件、每个文件改了什么、测试结果、是否还有风险。   </工作流程>   <当前任务>   【在这里填写你的具体任务,务必包含:角色设定 + 项目上下文 + 具体约束 + 验收标准】   </当前任务>   

 参考资料(共 11 篇) 

  1.    会飞的鲑鱼.《Claude Code 完整入门进阶教程:安装、配置、使用,一篇搞定》 
  2.    秋芝2046.《全网最全!60分钟全面掌握Claude Code~【附完整文档】》 
  3.    codetopm.《claude code 完全入门指南(老外492万浏览1.3万赞)》 
  4.    某白123.《Claude Code 完全指南:从入门到精通的全面教程》 
  5.    (新增).《Claude Code系统实战教程——从安装到精通》 
  6.    (新增)AI代码圈.《Claude Code Windows安装教程(2026最新版)》 
  7.    (新增).《Claude Code 16个高频命令 + 1套完整工作流,新手直接照着用》 
  8.    (新增).《Claude code系列——下载、安装及AI配置》 
  9.    (新增).《零基础玩转AI编程:Claude Code与Codex安装部署全攻略(Windows/Mac)》 
  10.    (新增).《Claude Code 入门指南》 
  11.    (新增).《Claude code系列——VS code搭建Claude code及模式介绍》 

相关学习资料