使用 Claude Code
Last updated on
安装完成后,先学会在项目目录里启动 Claude Code,并完成第一次真实对话。先跑通最基础的使用动作,再继续深入。
这一页的目标,不是教你高级玩法
到这一页为止,你已经完成了:
- 准备本地依赖和 API Key
- 用 CC Switch 切好可用供应商
- 把 Claude Code 安装到电脑里
所以这一页只做一件事:让你真的把 Claude Code 启动起来,并完成第一次正常使用。
先理解“使用 Claude Code”到底是在做什么
Claude Code 不是一个网页,也不是一个普通桌面聊天软件。
它更像是一个在终端里运行的 AI 编程助手。
你真正使用它时,通常会是这样的流程:
- 先打开终端
- 进入某个项目目录
- 运行
claude - 再用自然语言告诉它你要做什么
为什么这里一定要强调“进入项目目录”?
因为 Claude Code 会结合你当前所在目录的文件来理解任务。
你站在什么目录里启动它,决定了它看到的是哪个项目。
先打开终端,并进入你要处理的项目目录
2. 进入你要操作的项目文件夹
假设你要处理的是某个代码项目,就要先进入那个项目所在目录。
最常见的命令是:
cd 你的项目路径比如:
cd D:/my-project如果你的项目路径里有空格,可以写成:
cd "D:/my project"不要在一个你不认识的目录里直接启动 Claude Code
对新手来说,最容易犯的错误之一,就是终端打开后什么都不看,直接输入 claude。
这样做很容易让你自己都搞不清:当前到底是在操作哪个项目。
3. 先确认你已经进对目录了
进入目录后,可以先运行:
pwd如果你看到的路径就是你要处理的项目路径,说明你站对地方了。
如果你用的是 Windows PowerShell,也可能更习惯直接看提示符当前路径。核心判断标准只有一个:你要知道自己现在在哪个目录里。
启动 Claude Code
2. 看懂什么状态算“启动成功”
启动成功后,你通常会看到 Claude Code 进入交互状态,也就是:
- 终端界面明显切换到 Claude Code 的工作界面
- 你可以继续输入自然语言任务
- 它不是直接报错退出
你不用追求界面和别人截图一模一样
版本不同、系统不同、终端不同,显示细节可能会不完全一样。
只要 Claude Code 能正常进入可交互状态,就说明这一步已经跑通了。
完成第一次真实对话
第一次使用,不要一上来就给太复杂的任务
你现在的目标不是立刻让它重构一个大项目。
先让它完成一次简单、明确、容易判断成败的对话,最重要。
1. 先给一个很简单的项目理解任务
Claude Code 启动后,你可以先输入这种最基础的问题:
- 解释这个项目的目录结构
- 这个项目的入口文件在哪里
- 先帮我看看这个项目主要是做什么的
这类问题的好处是:
- 足够简单
- 不容易误操作
- 你可以很快判断它是不是真的读到了项目文件
2. 再试一个很小的执行任务
如果第一步已经正常,你可以继续试一个轻量任务,比如:
- 帮我找出这个项目里处理路由的文件
- 解释
src目录下最重要的几个文件 - 帮我看看这个函数是做什么的
第一次使用时,建议先避免这种任务:
- 直接删改很多文件
- 一上来就做大型重构
- 让它执行你自己都还没看懂的高风险操作
先从“理解”和“小动作”开始,会稳很多
尤其是你还在熟悉 Claude Code 的时候,先观察它怎么读项目、怎么回应、怎么确认操作,比急着让它大改代码更重要。
如果启动后报错,先优先检查什么
如果你运行:
claude之后没有正常进入可交互状态,而是直接报错,优先检查下面几类问题。
2. 再确认供应商链路已经切好
如果安装没问题,但启动时出现认证、接入、配置相关报错,就优先回头检查:
- 你有没有在 CC Switch 里给 Claude Code 启用一个可用供应商
- 当前启用状态是不是你刚刚配置的那个供应商
这一步没做好,Claude Code 就算装好了,也可能还是用不了。
3. 再确认你是不是站在正确的项目目录里
如果 Claude Code 启动了,但行为看起来很奇怪,比如:
- 读不到你以为它应该看到的文件
- 回答内容和当前项目完全对不上
那就先检查你是不是在正确目录里启动了它。
很多“它怎么表现怪怪的”的问题,最后不是模型问题,而是你站错目录了。
这一步做完,什么状态算合格
满足下面这 3 条,就说明你已经完成了第一次真实使用
- 你已经在正确的项目目录里运行过
claude - Claude Code 已经正常进入可交互状态
- 你已经成功完成至少一次简单对话,比如让它解释项目结构或查看某个文件
做到这里,这一组 Claude Code 教程的主路径就已经跑通了。
如果你还想继续补一些额外说明、小技巧或更贴近中国用户环境的补充内容,再看 网络与补充。