如果你已经跟着系列前两篇装好了 Claude Code甚至只是刚在终端敲过claude命令、看到了交互式界面那这篇就是为你准备的。今天不聊安装不聊那些花里胡哨的“一小时完成全栈项目”标题党就聊最基础、最日常的使用姿势怎么和它对话、怎么管理上下文、怎么配置权限、怎么接入第三方模型、怎么排查那些“明明装好了却卡住”的问题。Claude Code 本质上是一个跑在终端里的编程代理它不是一个“聊天框”而是一个能直接读写你的文件、执行命令、调用工具的半自主“结对程序员”。这个定位决定了它的使用方式和普通 Chat 完全不一样很多新手的困惑都来自这个认知偏差。这篇文章会按“启动方式 — 会话内指令 — 配置文件 — VSCode 集成 — 第三方模型接入 — 问题排查”这条线走一遍每部分都会给出我实际踩过坑之后总结的用法和习惯。内容会比较长建议先收藏跟着操作一遍。1. 理解 Claude Code 的使用形态别拿它当聊天框用1.1 它和普通聊天式 AI 助手的本质区别先说一个最常见的误区很多人把 Claude Code 当作网页版 Claude 的终端替代品输入“帮我写一个 Python 脚本”它输出一段代码然后你复制粘贴到文件里。这种用法不能说错但完全浪费了它的核心设计。Claude Code 的设计目标是“代理式编码”它会自己读取你的项目文件、搜索相关代码、修改文件、执行测试命令甚至根据报错自动修复。也就是说你给它的不是“问题”而是一个“任务目标”它会自己在你的项目里跑一圈把活干完。这一点的直接体现就是它在终端里的工作方式。启动后它不是简单等你输入一句、回答一句而是会持续输出“思考摘要 操作动作 执行结果”的循环比如“我准备修改 src/util.ts先读取一下当前内容”。这种节奏更像你在跟一个坐在你旁边、能操作你电脑的工程师协作而不是在跟一个只会动嘴的顾问聊天。所以基础使用指南的第一条建议是改变提问方式。不要问“这段代码有什么问题”而要说“帮我检查 src 目录下所有 TypeScript 文件里的内存泄漏风险”。前者是问答后者才是任务委派。Claude Code 的上下文感知能力和工具调用能力只有在任务式指令下才能真正发挥出来。1.2 三种最常用的启动方式Claude Code 的启动方式比很多人想的要灵活我平时会根据场景在三者之间切换。第一种也是默认的方式直接在终端输入claude进入交互模式。这种方式适合边聊边干你会实时看到它的思考过程和动作发现问题可以随时打断、纠偏。我日常的大部分工作都在这个模式下完成。进入交互模式后它会显示当前的工作目录和会话提示符你直接输入自然语言即可。第二种一次性非交互模式用claude -p 描述任务或者claude 描述任务。这个模式适合脚本化或批量调用比如你在 CI 里让它自动 review 代码或者在终端里通过别名快速发起一个任务而不进入长会话。-p全称是--print意思是“输出结果后立即退出”。我常用它来快速问一些不需要上下文的问题比如“Python 3.12 里datetime.UTC和timezone.utc的区别”不会产生会话残留。第三种会话恢复模式用claude --continue或claude --resume。前者继续最近一次会话后者可以列出历史会话然后选择恢复。这个能力在你跨天工作、或者上午分析到一半下午接着干时非常实用。终端里的会话是持久保存的不是关了窗口就没了这一点很多人不知道。此外标志性启动参数我也说一下。claude --permission-mode plan进入计划模式这个模式下它只读不改适合先做方案评审claude --permission-mode acceptEdits会自动接受文件编辑适合信任度较高的重构任务而--dangerously-skip-permissions会跳过所有权限确认非常危险只在完全隔离的容器环境里才建议碰。新手阶段不用管这些默认交互模式就挺好。2. 会话内高频指令与效率技巧2.1 指令面板/help 与常用斜杠命令进入交互模式后输入/help可以看到完整的命令列表。斜杠命令是 Claude Code 最核心的效率工具我挑选几个日常使用频率最高的说。/init是初始化项目记忆的命令。运行后 Claude Code 会扫描当前项目生成或更新CLAUDE.md文件这个文件相当于项目的“长期记忆”它会记录项目技术栈、目录结构、编码规范等信息。每次启动会话时它会自动读取这个文件作为上下文。我建议每接手一个新项目第一件事就是/init让它自己先摸一遍项目底细。/status可以查看当前会话状态包括使用的模型、上下文占用、工具调用统计等信息。/context显示当前对话占用的上下文窗口情况这个在新版本里尤其有用可以直观看到“哪些文件占了大量 token”。/memory用于编辑跨会话的持久记忆/review会对当前代码改动做一次检查/clear清空当前会话上下文但保留对话记录/compact则是把当前对话压缩成摘要来释放上下文空间。我用一个表格整理一下最常用命令的用途命令用途我的使用频率/help查看全部命令说明低入门后很少用/init初始化项目级 CLAUDE.md每个新项目必用/status查看会话状态与模型信息高排查问题时用/context查看上下文占用明细高长会话必看/compact压缩当前上下文高会话变慢时用/clear清空上下文但保留记录中切换任务时用/review审查当前改动中/model切换模型高按任务定价切换/model也值得单独说。Claude Code 支持在 Anthropic 的不同模型之间切换比如轻量快速的 Haiku 和更强但更贵的 Sonnet 系模型。我的习惯是简单问答、生成测试用例用轻量模型复杂重构、架构设计再切回主模型。很多人全程只用最强模型费用成本会莫名其妙翻好几倍。2.2 上下文管理把“聊天记忆”攥在自己手里上下文窗口是 Claude Code 的生命线也是新手最容易踩坑的地方。很多人发现“聊到一半它突然变笨、忘掉前面的要求”往往是因为上下文被撑满了早期的对话细节被自动丢弃了。Claude Code 在长会话中会自动做一件事当上下文接近上限时它会自动“浓缩”把早前的对话整理成摘要然后继续。这个机制本身没问题但你得知道一件事——摘要会丢细节。如果你前面详细描述过一个边界条件而它没有写进摘要后续工作就可能偏离你的意图。所以我养成了几个管理上下文的习惯。第一分段式沟通而不是长对话流。把一个大项目拆成多个小会话每个会话解决一个子任务用--continue在任务之间连接上下文。比如“先实现用户认证模块再开新会话处理购物车”就比“帮我实现一个完整电商网站”靠谱得多。第二善用CLAUDE.md承载长期指令。把项目的全局约定写到CLAUDE.md里而不是每次对话开头重复。比如“本项目使用 pnpm 管理依赖不要提交 lockfile 之外的 package.json 变更”这类约定放文件里每个会话都自动生效。第三上下文紧张时主动/compact而不是忍耐。当你感觉响应变慢、或者它开始重复读取文件时打开/context看看用量如果已经超过 70% 就执行/compact。注意 compact 之后要扫一眼摘要质量看它有没有漏掉关键要求如果有手动补充一句“请额外记住xxx”。2.3 输出控制与自动化节奏交互模式下的输出节奏是可以调的。Claude Code 在执行任务时会输出大量信息包括工具调用、命令执行输出、思考摘要。默认情况下它比较啰嗦适合首次使用时观察它在干什么但如果你对流程已经心里有数这个啰嗦程度就烦人了。会话内按 ShiftTab 可以在不同输出详细度之间切换这个隐藏操作很多教程没提过。它会循环切换“展示低层级工具调用信息 / 只展示高层级动作与结果摘要 / 极简模式”我调试阶段用详细模式观察行为稳定跑任务时切到摘要模式能省不少眼睛。另外claude -p非交互模式配合反斜杠续行和管道可以做出挺顺手的组合命令。比如git diff main...HEAD | claude -p 帮我审查这些变更找出潜在问题并按严重程度排序这会在不进入交互会话的情况下直接完成一次代码审查输出结果打印在标准输出里。配合 shell 别名我几乎把常用的审查、提交信息生成都脚本化。这种用法才是 CLI 工具的终极形态。3. 配置文件与个性化工作流3.1 设置、内存与 CLAUDE.md 的职责边界用了一段时间 Claude Code 之后你会发现有三类“记忆/配置”概念需要区分清楚全局设置文件、项目级CLAUDE.md、以及个人级~/.claude/CLAUDE.md。很多人混淆它们导致配置在某个项目里失效还找不到原因。全局设置由claude config命令管理它处理的是 CLI 运行时的底层参数比如 API key 的存储方式、默认模型、权限模式等。通过claude config set可以覆盖默认值例如claude config set --global model sonnet claude config set --global theme dark这里的model只影响默认启动时的模型会话内还是可以用/model覆盖。项目级CLAUDE.md放在你的项目根目录内容围绕“这个项目是什么、用什么技术栈、有哪些约定”来写。它是给 Claude Code 看的技术文档不是给人看的 README。/init能自动生成第一版但我会手动调整补充比如在这个文件里写清楚“测试命令是 npm test 而不是各子包分别 run test”“提交前必须生成 changelog”。个人级~/.claude/CLAUDE.md则是你的“个人工作习惯记忆”适合写那些跨项目恒定的偏好比如“回复使用中文”“代码风格偏好 TypeScript 严格模式”“涉及删除操作前必须列出影响清单”。优先级上项目级会覆盖个人级越具体的越优先。这个分层很合理你能把“我是谁、我喜欢怎么工作”放在个人级把“这个项目特殊在哪里”放在项目级。3.2 Skills 技能复用你的方法论Skills 是 Claude Code 新版本里一个很有想象力的特性通俗理解就是“把一系列提示词、脚本、规则打包成一个可复用的技能模块”然后通过名称唤起。比如你可以写一个 “code-review” 技能内含 review 必须要检查的清单、要用的命令、报告模板然后在任何项目里调用它。基础用法并不复杂。你需要在~/.claude/skills/或项目.claude/skills/目录下创建子文件夹每个技能文件夹内包含一个SKILL.md文件文件里用结构化格式描述技能的用途和触发条件目录里还可以放参考脚本或模板文件。我拿自己的一个技能做例子简化后的SKILL.md大概是--- name: strict-ts-check description: 对当前 TypeScript 项目执行严格检查并按规范输出报告。 --- 运行 npx tsc --noEmit --strict并执行以下检查 1. 是否所有函数返回值都有显式类型。 2. 是否有被 catch 吞掉的异常。 3. 是否使用了 any 类型如有则标注理由。 输出结果按“必须修复 / 建议修复 / 仅供讨论”三级分类。这样在会话里输入“执行 strict-ts-check”就能唤起整套检查逻辑不用重复描述要求。对于有自己工作方法论的团队把团队规范沉淀成技能文件比写一长篇文档然后让 AI 自己理解要可靠得多。这里我踩过一个坑技能目录建好后必须确保文件名是SKILL.md并且 YAML 头里的name是你要唤起的名字否则它不会出现在技能列表里。还要注意 Claude Code 的技能发现机制依赖于扫描目录改完文件后重开会话才生效热加载不总是即时。3.3 Hooks自动化守卫自己的操作边界Hooks 机制我想单独强调一下虽然它属于进阶功能但对基础使用的安全感提升帮助巨大。它的原理是在特定事件触发时执行外部程序用外部程序的标准输出来干预主流程。比如最常用的是PreToolUse钩子——在 Claude Code 打算执行某个工具之前拦截一次检查。我自己配过一个“危险命令拦截钩子”当它打算执行rm -rf或者git push --force时钩子脚本会弹出一个强提示甚至直接拒绝执行。这相当于是给代理式的 AI 加了一条安全带。Hooks 配置在工作目录的.claude/settings.json里下面是个简化例子{ hooks: { PreToolUse: [ { matcher: Bash(rm -rf|git push --force), hooks: [ { type: command, command: echo 危险操作被拦截 exit 2, timeout: 5 } ] } ] } }exit 2 表示拒绝继续exit 0 表示放行。刚开始用 hooks 时不要一下写太复杂先加一条哨兵型拦截跑熟了再扩展。4. VSCode 集成与桌面端协同4.1 为什么建议在 VSCode 里用 Claude Code很多时候终端里的纯文本界面让新人不适应看不到文件树、点不了按钮、心里没底。如果你用 VSCode官方提供了一个“Claude Code for VSCode”扩展安装后能把 Claude Code 以面板形式嵌入编辑器。这个扩展不是简单的套壳终端它会读取你当前打开的工作区在侧边栏单独打开一个 Claude Code 面板可以边看代码变改边对话。文件修改会实时在编辑器里体现git diff 可以直接预览整体体验比纯终端友好得多。基础接入方式是在 VSCode 扩展市场搜索“Claude Code for VSCode”安装后打开命令面板CtrlShiftP执行 “Claude Code: 打开面板”即可。它会复用 CLI 的登录状态和配置不需要重复设置 API key。我的实际体验是纯终端适合快速批处理和远程服务器操作VSCode 面板适合需要边看代码边改的交互式任务。两者可以同时跑互不冲突。有个小细节扩展面板里的指令和终端相同所有/命令都能用。快捷键方面CtrlEnter发送输入Escape中断正在执行的任务。如果你在纯终端里习惯了 CtrlC 中断面板里要重新适应一下。4.2 桌面版与终端版的定位差异Claude Code Desktop 是很多人搜的热点多说两句。它本质上是一个自带终端和界面壳的独立应用程序对操作系统的集成更深度比如可以读取系统通知、跨应用读取剪贴板、以图形界面管理多会话。桌面版和终端版共用同一套核心引擎和配置目录~/.claude这意味着你不需要重新登录或重复配置它会读取同一份凭据和CLAUDE.md。选择建议很简单桌面版适合把 Claude Code 当作工作台、喜欢图形界面管理的用户终端版适合习惯命令行、或者在服务器上使用的场景。性能上没有本质差别。5. 第三方模型接入与多模型切换5.1 接入 DeepSeek 等 OpenAI 兼容接口Claude Code 的热搜关键词里“deepseek 接入”出现频率非常高原因不难理解Claude 官方模型的额度成本和区域可用性问题让很多人想转用更便宜或更易获取的第三方模型。好在 Claude Code 提供了环境变量级别的模型接口覆盖机制。它的请求可以通过配置ANTHROPIC_BASE_URL指向任何兼容 Anthropic 消息格式的网关。很多第三方模型服务商包括 DeepSeek、智谱 GLM、通义千问等实现了 OpenAI 兼容格式但 Claude Code 原生要求 Anthropic 格式所以你需要一个“格式转换层”。实操上最主流的路线是使用开源转换工具比如 claude-code-router 这类项目它把 Anthropic 格式转成 OpenAI 格式转发到目标模型。配置方式一般是export ANTHROPIC_BASE_URLhttp://127.0.0.1:8080 export ANTHROPIC_AUTH_TOKEN你的第三方API密钥 export ANTHROPIC_MODELdeepseek-reasoner其中ANTHROPIC_AUTH_TOKEN会被作为 Bearer Token 发给你自己的本地转换服务由它再去请求 DeepSeek。用这个方式需要注意几个点第一模型能力差异。Claude Code 的工具调用格式依赖模型的 function calling 能力DeepSeek 的 reasoner 系列对工具调用的支持不如 Chat 系列稳定如果你发现它“开始动嘴但不动手”大概率是模型在工具调用上抽风可以临时切成对话模型验证。第二上下文管理失效。很多第三方模型的上下文窗口和 Anthropic 的计数方式不同Claude Code 的状态栏里显示的上下文占用是基于 Anthropic 假设的接入第三方模型后这个数字会失真。第三环境变量是否全局生效。如果只是在终端临时 export只对当前会话有效要永久生效得写入~/.bashrc或~/.zshrc。我建议用 direnv 之类的工具按项目目录设置环境变量避免所有项目都走同一个第三方模型。5.2 切换工具与多模型混合策略接入第三方模型后你可能会面临“不同任务用不同模型”的诉求。市面上有一个工具叫 ccswitch本质上是管理多套 Claude Code 配置环境的脚本。它会把不同模型的 API key、Base URL、模型名打包成多个 profile切换时改的是环境变量和配置文件。我的建议是不必第一时间上这种工具除非你确实在频繁切换不同供应商。先试两天默认的单一配置摸清自己项目的模型需求特点再决定要不要引入管理工具。更值得尝试的混合策略是用官方模型处理架构设计和代码审查这类任务对推理质量和长上下文要求高值回票价用第三方模型处理批量小任务生成单测、格式化重命名、补注释。但注意一个边界风险第三方模型服务商的数据处理条款各不相同如果项目代码敏感接第三方便要慎重不要因为贪便宜把核心业务代码发给来路不明的网关。6. 常见问题排查与体验调优速查6.1 连接失败、地区限制类问题的处理思路遇到Unable to connect to Anthropic或启动时提示地区支持问题首先别慌这类问题的排查路径通常很清晰。第一步是区分是网络问题还是认证问题。跑一下curl -I https://api.anthropic.com能返回 HTTP 状态码说明基本网络可达此时大概率是 API Key 无效或未登录执行claude /login或者检查ANTHROPIC_API_KEY环境变量是否生效。如果 curl 本身超时或者 TLS 握手失败那就说明是网络连通性的问题。第二步检查是否走错了接口地址。环境变量ANTHROPIC_BASE_URL一旦被设置所有请求会走该地址如果你之前接第三方模型时设置过这个变量后来忘改那么所有官方请求都会打到第三方网关上去报各种诡异错误。用env | grep ANTHROPIC看一眼全部相关环境变量是排查第一步的老规矩。第三步如果你所在地区的服务可用性受限应该自行评估网络方案是否符合当地规定。这不是技术问题是合规问题务必自行判断。我见过太多人为了绕过限制常年开着各种“加速工具”结果 API 地址频繁变动、请求超时率极高最终浪费的时间远超省下的成本。从工程效率和合规性角度我都建议优先考虑使用官方支持的合法渠道或者支持你所在地区的第三方服务商。6.2 费用失控的预防方案Claude Code 的费用失控是我见过最多人吐槽的问题。它的机制决定了它在一个任务里会调用成千上万次工具每个工具调用的输入输出都计费尤其是 read 类型工具会把整个文件内容作为输入 token 发送。省钱的第一原则是限制 Claude Code 的读取范围。在项目根目录的.claude/settings.json里可以配置permissions.deny规则禁止它读取特定目录比如node_modules、dist、大型数据文件从源头阻断 token 浪费。第二原则是理解模型成本梯度。一个简单的sonnet和旗舰大模型之间价格差距很大日常任务完全没必要用上限模型。我习惯用/model快速切换合并请求 review 用旗舰重命名变量、写注释这类事务性任务用轻量档位。第三原则是善用用量统计。在会话内输入/status可以查看当前会话累计用量定期看一眼能帮你建立直觉。另外给 claude 命令设置一个 alias提示当前处于哪个项目、什么模型也能降低误用的概率。6.3 长上下文、大仓库场景的体验优化很多人的项目是新版的单体仓库文件上万、依赖复杂Claude Code 在这种场景下如果你不加以约束它会陷入“疯狂读文件”的泥潭。表现就是上下文快速涨满、响应变慢、费用飙升。优化手段按优先级排序第一在CLAUDE.md里写清楚“信息地图”。明确告诉它哪些目录是核心业务代码哪些是生成代码不需要读。比如写一句“src/core 是核心逻辑不要花太多时间读 tests/fixtures 下的数据文件”。第二利用--add-dir限定工作目录。如果你只关心一个子模块就不要让它拥有整个仓库的视野。Claude Code 可以启动时只挂载子目录这既加快检索速度又省 token。第三对于非常大的仓库优先让它搜索而不是全读。要求它“先搜索所有引用这个函数的位置给出行号清单再逐个打开”而不是“阅读整个项目”。长会话中如果发现它的行为变得“健忘”优先/compact而不是/clear。compact 保留的是经摘要浓缩的关键信息clear 会把所有上下文归零容易丢掉之前明确的任务约束。我习惯在 compact 后手动补一句“以上是压缩摘要请保留所有关于接口兼容性的要求”避免摘要化过程中把重点漏了。6.4 几个容易忽略的小细节最后补几个我在实际使用中觉得特别容易踩的小坑。第一CLAUDE.md文件不要写得太像散文它是一份被 AI 读取的“任务说明”最好用清单式语言明确、无歧义。写“当遇到安全问题时请谨慎处理”是废话写“凡涉及 delete 操作必须先列出影响文件清单并获得确认”才是有效指令。第二如果你在团队里公用了同一台机器的 Claude Code注意个人记忆文件的隔离。~/.claude/CLAUDE.md是全局的包含的个人偏好可能会被队友的会话读到用之前扫一眼内容有没有不该共享的东西。第三不要忽视退出键。交互模式下CtrlC可以中断当次工具调用按两次可以完全退出当前会话。很多人遇到它跑偏时不知道能打断眼睁睁看着它继续执行错误操作这是最容易避免的损失。关于基础使用我能想到的干货暂时是这些。Claude Code 是一个上手门槛不高但上限很高的工具很多高阶玩法Agent 自建、MCP 接入、Hook 编写、团队规范沉淀都是在基础命令和数据流跑熟之后才自然延展出来的。最后再分享一个我自己坚持的习惯每次拿到新项目先把 CLAUDE.md 和权限配置调好再开工这个“前期十分钟”能让后续每个会话都省下大量重复说明的成本。工具是死的工作流是活的多花心思在设计工作流上回报会远超想象。
