夜雨聆风面向零基础小白的完全手册 | 不需要科学上网 | 不需要 Claude 付费账号
Claude Code 是什么。它本来是 Anthropic 适配自家 Claude 模型的编程工具，跟 GitHub Copilot 有点像。但发展到现在，它已经变成了一个全能智能体——不止能写代码，还能读文件、跑命令、分析项目结构、做 Git 提交、做代码审查，甚至帮你从头搭一个项目骨架。你告诉它你想干什么，它会自动规划、执行、检查，全程在终端里操作。
最关键的是，Claude Code 早就支持接入第三方模型了。国内的模型——DeepSeek、通义千问、智谱 GLM、MiniMax——理论上都能接。但我推荐 DeepSeek ？原因是 DeepSeek 的 API 价格实在便宜，`deepseek-v4-flash` 量大管饱，入门充十块钱能用很久。本文就以 deepseek-v4-flash 为例。
这篇指南不讲黑话，每一步尽量都写到一个电脑小白都能看懂。
装之前先搞清几件事
系统要求
•Mac：macOS 13.0（Ventura）及以上
•Windows：Windows 10 1809 及以上
•Linux：Ubuntu 20.04、Debian 10 及以上
你电脑是最近两三年买的，基本都满足。
最重要的条件：一个 DeepSeek 的 API Key
去 DeepSeek 开放平台（platform.deepseek.com）注册账号，然后在"API Keys"页面创建一个 Key。创建的时候只会显示一次，马上复制保存好。如果忘了，删掉重新建一个就行。
第一步：找到终端
Mac 用户：
1. 按键盘上的 `Command + 空格`，弹出搜索框
2. 输入"终端"或"Terminal"
3. 回车打开
Windows 用户：
1. 按键盘上的 `Win + R`
2. 输入 `powershell`，回车
你会看到一个黑底（或白底）的窗口，里面有个光标在闪。这就是终端。
终端是什么？可以理解成一个只有文字的窗口，没有按钮，没有图标，只有光标在一闪一闪等你打字。这篇指南你只需要复制粘贴命令、按回车就行。
如果上面这张图加载不出来，没关系。你的终端打开之后大致就是那个样子：黑底白字，光标闪烁，等着你输入命令。
第二步：安装 Claude Code
用一键安装脚本。在终端里粘贴一行命令：
Mac / Linux 用户：
curl -fsSL https://claude.ai/install.sh | bashWindows PowerShell 用户：
irm https://claude.ai/install.ps1 | iex安装过程会跑一些文字，大约 10-30 秒。结束后验证一下是否装好：
claude --version如果输出了类似 `2.1.81 (Claude Code)` 的版本号，装好了。
如果提示 `command not found`，说明安装路径没加到系统路径里。关了终端再开，重新输入 `claude --version`。
提示：安装脚本需要从 claude.ai 下载文件。如果下载慢，可以试试用代理，或者多试几次。官方也支持 Homebrew 安装：`brew install --cask claude-code`。
安装过程大概是这样的：终端里会快速滚动很多文字，最后显示一句安装成功的信息。你不需要做任何操作，等着它跑完就行。
第三步：跳过 Claude 登录
这一步最关键。Claude Code 默认会让你登录 Anthropic 账号，但我们用的是 DeepSeek 的 API，不需要它那个账号。
找到你用户目录下的 `.claude.json` 文件：
•Mac / Linux：`~/.claude.json`
•Windows：`C:\Users\你的用户名\.claude.json`
用记事本打开它，把里面的内容全部替换成：
{"hasCompletedOnboarding": true}保存文件。这样 Claude Code 就不会再弹出登录窗口了。
第四步：配置 DeepSeek 连接
打开你的 Shell 配置文件：
•Mac 默认（zsh）：`~/.zshrc`
•Linux 默认（bash）：`~/.bashrc`
•Windows PowerShell：在系统环境变量里设置
在文件末尾加上以下几行：
export ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
export ANTHROPIC_AUTH_TOKEN="sk-你的deepseek-api-key"
export ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
export ANTHROPIC_SMALL_FAST_MODEL="deepseek-v4-flash"把 `sk-你的deepseek-api-key` 换成你在 DeepSeek 平台创建的那个 Key。
保存后，在终端执行让配置生效：
source ~/.zshrc或者关掉终端再开。
第五步：验证配置是否成功
在终端输入：
claude如果一切正常，你不会看到 Anthropic 的登录页面。Claude Code 会直接加载界面，并在终端里打印类似这样的信息：
Small fast model: deepseek-v4-flash看到这个就说明配置成功了。Claude Code 现在跑在 DeepSeek 的模型上。
底部光标出现后，按 `Ctrl+C` 退出（第一次先不急着用，看完后面的再说）。
第六步：开始你的第一次对话
进入你的项目目录，启动 Claude Code：
cd /路径/你的项目文件夹
claude先来个最简单的：
这个文件夹里有什么？Claude Code 会自动读取你当前目录下的文件，告诉你项目的结构和内容。
再来几个试试：
解释一下这个项目的技术栈帮我看看这个文件里有没有 bug给所有 Python 文件加上类型注解你每说一句话，Claude Code 就会先理解你的意图，然后读文件、改代码、运行命令。每一步都会先问你是否同意，确认后才执行。
一些很实用的操作
直接执行一次性任务：
claude "帮我分析这个项目有哪些可以优化的地方"做完就退出，不占终端。
做一次 Git 提交：
claude commit自动分析你改了哪些文件，生成提交信息。
继续之前没做完的对话：
claude -c继续你最近一次对话，不用重头开始。
模型怎么选？
DeepSeek 提供两个模型，Claude Code 会把它们用在不同地方：
| 用途 | 模型 | 场景 |
|---|---|---|
| 主力模型 | `deepseek-v4-pro[1m]` | 复杂架构设计、代码审查、疑难调试 |
| 快速模型 | `deepseek-v4-flash` | 简单修改、文档编写、子任务 |
新手不需要纠结。按上面的配置直接用就行，Claude Code 会自己决定什么时候用哪个模型。
常用命令速查
| 模式 | 命令 | 适合场景 |
|---|---|---|
| 交互模式 | `claude` | 长期对话，反复修改代码 |
| 一次性任务 | `claude "任务描述"` | 快速处理一件事就走 |
| 单次查询 | `claude -p "查询"` | 问一个问题要答案 |
| 继续对话 | `claude -c` | 接着上次没聊完的 |
| Git 提交 | `claude commit` | 自动生成提交信息 |
常见问题
Q：装到一半说权限不够？
在 Mac/Linux 上，如果提示 `Permission denied`，可以在命令前面加上 `sudo`：
curl -fsSL https://claude.ai/install.sh | sudo bash但别其他时候乱用 `sudo`，不确定的时候先多查查。
Q：DeepSeek API Key 怎么充值？
去 DeepSeek 平台（platform.deepseek.com），在 API Keys 页面找到充值入口。充 10 块钱能用很久，按 token 计费，写代码用得不多。
Q：Claude Code 会乱改我的文件吗？
每次改文件前，它都会展示修改内容并问你是否确认。确认后才执行。
Q：配置了环境变量但 claude 还是提示登录？
检查两件事：
1. `.claude.json` 文件是否改成了 `{"hasCompletedOnboarding": true}`
2. 环境变量有没有生效：在终端输入 `echo $ANTHROPIC_BASE_URL`，应该显示 `https://api.deepseek.com/anthropic`
Q：不想用了怎么卸载？
rm -f ~/.local/bin/claude && rm -rf ~/.local/share/claude你能让 Claude Code 干什么？
装好之后第一件事做什么？给它一个简单的任务试试。
claude "帮我写一个酷炫的交互式网页，一个粒子星空特效，鼠标移动时粒子跟随"等几十秒，一个 `index.html` 就出现在你文件夹里了。双击打开，浏览器里就是一个动态的粒子星空在旋转——你一行代码都没写。
当然，写网页只是最基础的功能。因为 Claude Code 的核心是一个全能智能体，它能做的事情远不止写代码：
•写作——让它写文章、改文案、翻译文档、润色邮件，它能读你的文件然后直接改
•作图——配合 ImageMagick 等工具，描述你要的图，它帮你调参数生成
•搞数据——扔给它一个 CSV，说"分析一下趋势做个图表"，它写 Python 脚本跑完出图
•做视频——配合 FFmpeg，说"把这段视频剪成 30 秒、加字幕、调色"，它帮你敲命令
这些能力不是 Claude Code 内置的，而是通过 Skill（技能）实现的。Skill 是别人写好的工作流程模板——你想处理 PDF、做竞品分析、爬取网页、自动发推文，都有现成的 Skill 可以直接用。装上 Skill 之后，你只需要说一句话，Claude Code 就会调用一堆工具自动完成整个流程。几乎可以说是无所不能。
至于 Skill 具体怎么装、去哪儿找、怎么用——这涉及到 Skill 生态的整个玩法，内容不少，下篇文章再讲。先把你这台电脑上的 Claude Code 跑通再说。
