ARTICLE · 1122233
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 分钟跑通)
检查 Node: Win+R输入cmd回车,敲node -v。显示 v22+ 即可;显示 v16/以下或报错,去 nodejs.org 下载 LTS 的 .msi 一路 Next(务必勾选 Add to PATH)。装 Git for Windows(git-scm.com),全部默认即可;开始菜单打开「Git Bash」用它与 CC 交互。 在 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 高频报错速查
报错现象 | 原因与解法 |
|---|---|
| PATH 未刷新。先关掉所有终端重开;仍不行把 |
官方安装脚本提示 | 国内地区限制。改用 |
安装报 engine 版本错误 | Node \< 18。升级 Node,或用 nvm-windows 切到 18+ |
npm 下载超时/卡死 | 默认源不通。挂代理 |
PowerShell 里报错/界面异常 | 非 bug,官方在 Windows 就推荐 Git Bash,直接换 |
登录时浏览器没弹授权页 | 复制终端里的 URL 手动打开;被管控就换浏览器 |
能登录但每次请求超时 | 网络到不了 Anthropic,设 |
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 扩展
打开 VS Code,点击左侧活动栏的「扩展」图标(或 Ctrl+Shift+X)。搜索框输入 Claude Code,找到官方扩展后点击「安装」。 扩展装好后,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 界面叫法 | 命令行等价 | 行为 |
|---|---|---|
计划模式 |
| 只做计划,完全不修改任何文件 |
默认模式 | Default | 每次动手前、改文件前都要征得你同意 |
半自动模式 | Accept Edits | 编辑文件等常见命令不再逐项询问,但中断命令和网络请求仍需你同意 |
权限全开模式 |
| 自动完成任务,效率最高、安全风险最大,仅限受信任的沙箱 |
二、配置模型:官方订阅 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 最有价值的用法之一。
常用命令速查表
命令 | 用途 |
|---|---|
| 启动交互模式 |
| 带任务启动 |
| 继续上次对话 |
| 恢复指定会话 |
| 查看当前环境可用命令(命令会随版本变化,以本机为准) |
| 全面诊断环境、排错 |
| 更新版本 |
| 非交互(无头)模式,适合脚本 |
| 限制 Agent 回合,控制成本 |
| 扫描项目生成 CLAUDE.md |
| 只规划不改动 |
| 管理子代理(拆分复杂任务) |
| 使用/管理 Skill(固定重复流程) |
| 管理 MCP 连接 |
| 检查/简化代码(编码后 Review) |
| 重复执行任务(周期性本地任务) |
| 临时旁问(不污染主上下文) |
| 切换模型 / 打开设置 |
| 查看/配置权限白名单(如禁止读 .env) |
| 上下文管理 |
| 恢复会话 / 查看用量 |
| 提交前检查改动、验证结果 |
六、实战实例:让你能复现的两个项目
实例 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"。
七、进阶路线图:下一步学什么
能力 | 一句话 | 何时学 |
|---|---|---|
自定义命令 | 把常用提示词打包成 | 同类任务做过 3 次以上 |
Skill(技能包) | 领域的"操作手册",按需自动加载 | 想掌握特定领域最佳实践 |
SubAgent(子代理) | 有独立上下文的分身,并行干活 | 主任务耗时且可拆分(如调研) |
Hooks(钩子) | 特定事件自动触发(如改完代码自动格式化) | 有固定重复流程要自动化 |
MCP | 连接 GitHub、数据库、浏览器、API | 需稳定调用外部系统 |
无头模式 | 执行一次即退出,可写进脚本, | 把 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 条血泪经验
先切换后启动:CC Switch 换模型必须在启动 claude之前;上下文 30% 即开始劣化,60% 就该 /compact,不相关任务果断/clear;一个会话一个任务,混着做模型会"糊涂"; CLAUDE.md 不是越长越好,控制在 200 行内,只放顶层稳定规则; 指令太短反而更费 token,具体描述又准又省; Shift+Enter 是发送不是换行,通用换行 Ctrl+J;Windows 粘贴图片用 Alt+V; "测试通过"要亲眼看命令和输出,自己再走一遍; 回滚有边界,终端命令产生的变化靠 Git 兜底; auto / 跳过权限 ≠ 可以离屏,目标与改动仍需人来把关; - 一次让它做 20 件事(改 UI+登录+数据库+部署…)它会失控
,一次一个目标。
5 条铁律
永远先说"先分析,不要修改"——防止 Agent 失控; 永远要求"告诉我涉及哪些文件"——掌控修改范围; 永远强调"最小修改,不要重构"——降低风险; 修改以后必须测试——验证正确性; 完成以后 git status检查修改——新手极易忽略的安全习惯。
十、与 IDE / Codex 如何分工
Claude Code 不必取代你的 IDE。二者可并存:Cursor / Qoder 负责你观察代码、手动开发;Claude Code 负责执行复杂任务与自动化(理解项目、跑命令、Debug、测试、Git)。Codex(OpenAI)桌面版对轻量开发、可视化调试更友好,可与 CC 互补,用 CC Switch 统一管理多模型切换。
十一、新手起步练习清单(照着做)
让 CC 用 5 条讲清楚你当前项目 让它找"没人调用的死代码" 修一个真实 Bug(贴报错即可) 给一个函数补单测 生成 CHANGELOG / PR 描述 用 /plan设计"积分系统"再决定是否落地写 CLAUDE.md 并让下次会话遵守 用 claude -p "..."做一次性脚本任务(如"监控某文件夹,新文件按日期归档")
写在最后 + 万能 Prompt 模板
CC 是副驾驶,不是自动驾驶。它的价值不在于让 AI 写代码,而在于让你从"手动改代码"的开发者,变成"指挥 AI 改代码"的技术管理者。你值钱的不再是手速,而是:会不会拆任务、会不会写清楚约束、会不会审 diff、会不会验收。
把下面这版可直接复制的万能模板存好,开发任何项目填【当前任务】即可:
你现在是这个项目的高级软件工程师。请严格遵守以下开发规则。 <开发原则> 1. 不随意重构现有架构。 2. 优先采用增量开发。 3. 修改前先理解现有代码。 4. 尽量减少修改文件数量。 5. 不删除现有功能。 6. 不修改与当前任务无关的代码。 7. 不修改 .env 中已有的 API Key。 8. 不擅自改变数据库结构。 9. 不擅自改变现有 API 返回格式。 10. 修改完成后必须进行测试。 </开发原则> <工作流程> 第一阶段:理解——先阅读与当前任务有关的文件。 第二阶段:分析——告诉我当前代码如何工作、问题在哪、涉及哪些文件、准备怎么修改。此阶段不要修改文件。 第三阶段:执行——得到确认后再修改。 第四阶段:测试——运行相关测试,检查语法、API、现有功能。 第五阶段:修复——如果测试失败,找到根因并修复,再测试。 第六阶段:汇报——告诉我完成了什么、修改了哪些文件、每个文件改了什么、测试结果、是否还有风险。 </工作流程> <当前任务> 【在这里填写你的具体任务,务必包含:角色设定 + 项目上下文 + 具体约束 + 验收标准】 </当前任务> 参考资料(共 11 篇)
会飞的鲑鱼.《Claude Code 完整入门进阶教程:安装、配置、使用,一篇搞定》 秋芝2046.《全网最全!60分钟全面掌握Claude Code~【附完整文档】》 codetopm.《claude code 完全入门指南(老外492万浏览1.3万赞)》 某白123.《Claude Code 完全指南:从入门到精通的全面教程》 (新增).《Claude Code系统实战教程——从安装到精通》 (新增)AI代码圈.《Claude Code Windows安装教程(2026最新版)》 (新增).《Claude Code 16个高频命令 + 1套完整工作流,新手直接照着用》 (新增).《Claude code系列——下载、安装及AI配置》 (新增).《零基础玩转AI编程:Claude Code与Codex安装部署全攻略(Windows/Mac)》 (新增).《Claude Code 入门指南》 (新增).《Claude code系列——VS code搭建Claude code及模式介绍》