装上 Claude Code，用 DeepSeek 的 key 跑

写于 2026-09-03。这一页里的安装命令、设置文件的写法、模型名，都是当前工具的做法，会变。哪些是长期的道理、哪些是今天的写法，每节分开说。

Claude Code 是 Anthropic 做的一个在终端里运行的 AI 助手。你打一句话，它替你看文件、改文件、运行命令。它和网页版聊天最大的区别：它在你的电脑上，看得到你的文件夹。

它默认连 Anthropic 的服务器，要 Claude 的付费账户。DeepSeek 提供了一个兼容 Anthropic 接口的入口，把 Claude Code 指过去，它就用 DeepSeek 的模型干活，按用量付费。这一页记我自己的做法。已经有 Claude 订阅的人，装完直接登录就行，跳过中间两节。

The tool runs on your machine. The brain runs on someone else's server. The key lets the tool speak for you.La herramienta está en tu ordenador. El cerebro está en el servidor de otro. La clave permite que la herramienta hable por ti.

手在你这里，脑在别人那里，钥匙写在设置文件里

先弄清三样东西在哪

知道即可

• Claude Code：装在你的 Mac 上。它是手：读文件、改文件、跑命令都是它做。
• 模型：在 DeepSeek 的服务器上。它是脑。你打的话，加上 Claude Code 读到的文件内容，都会发过去。
• settings.json：你个人文件夹里的一个小文件。它告诉 Claude Code 去哪找脑，凭什么证明是你。API key 就写在这里。

这个结构是长期的：换成别的工具、别的模型，还是手、脑、钥匙三样。变的只是钥匙写在哪、脑的地址是什么。

你什么时候会用到

知道即可

你想让 AI 处理一个文件夹里的东西：几十个文件改名、把一堆纯文本整理成一张表、给一个小脚本改错。在网页里聊天要一个一个复制粘贴，Claude Code 直接在文件夹里干。

它会动你的文件，所以先读让 AI 动手前的权限边界。那一章的规矩这里全部适用：先看计划再放行，看不懂的不批，做完自己检查。

装 Claude Code

必须掌握

你什么时候会遇到这个问题：还没装过，或者换了一台 Mac。

最简单可靠的做法：打开终端（不熟悉终端先读终端一章），粘贴这一行，Enter：

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

终端一章说过，curl ... | bash 这种「从网上下载一段脚本直接执行」的命令，只有来源是官网、而且你知道它干什么的时候才运行。这一条就是那个例外：地址是 claude.ai，是官网；它做的事是把 Claude Code 下载到你个人文件夹里，再往 zsh 的启动文件里加一行路径，不碰系统的其他地方。按 Enter 之前看清地址。这条命令不需要先装 Homebrew，也不需要 Node；网上有些教程让你先装那些，是老方法，不用。

装完关掉终端窗口，重新打开一个，让新命令生效。然后：

claude --version

打出一个版本号，就装好了。出现 zsh: command not found: claude，按顺序试：

1. 关掉终端窗口，重新开一个，再试。 装完的那个窗口不认识新命令，这是最常见的原因。

2. 还不行，看程序在不在。 运行 ls ~/.local/bin/claude。打出这个路径，说明装好了，只是终端不知道去那里找（PATH 没设上）。运行下面这一行，然后再试 claude --version：

   echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc && source ~/.zshrc

   前半句在 zsh 的启动文件末尾加一行，告诉它以后也去 ~/.local/bin 找命令；&& 后面那半句让当前这个窗口立刻重读启动文件，不用关掉重开。安装脚本本来会替你加这一行，有时候没加上。

3. ls 说 No such file or directory，安装没成功。把安装时的输出整段贴给网页版的 AI。

先别急着运行 claude。没有下一节的设置，它会让你登录 Anthropic 的账户。已经按了也不要紧，⌃ + C 退出。

Windows 提示

在 PowerShell 里运行 irm https://claude.ai/install.ps1 | iex。DeepSeek 的文档建议先装 Git for Windows。设置文件在 C:\Users\你的名字\.claude\settings.json，写法和下面一样。

拿一个 DeepSeek 的 API key

必须掌握

你什么时候会遇到这个问题：设置文件要填一个 key，你还没有。

最简单可靠的做法：

1. 打开 DeepSeek 开放平台（platform.deepseek.com），注册，充一点钱。它是先充值后使用，余额用完就报错，不会欠费。
2. 到「API keys」页面新建一个。名字写用途，比如 claude-code。
3. key 只显示这一次。 立刻存进「密码」（Passwords）应用，条目名写「DeepSeek API key」。不存备忘录，不发微信给自己。

它为什么是密码：谁拿到这串字，谁就能用你的钱调用模型。API 一章讲过。泄露了就在平台上把这一个删掉，再建一个，别的用途不受影响。所以一个用途一个 key。

把 key 写进 settings.json

必须掌握

你什么时候会遇到这个问题：Claude Code 装好了，要告诉它去 DeepSeek，而不是去 Anthropic。

最简单可靠的做法：

1. 终端里依次运行三行：

   mkdir -p ~/.claude
   touch ~/.claude/settings.json
   open -a CotEditor ~/.claude/settings.json

   ~/.claude 是 Claude Code 在你个人文件夹里的设置文件夹，名字前面有个点，访达（Finder）默认不显示。第一行建文件夹，已经有也不报错；第二行建一个空文件，已经有也不会覆盖；第三行用 CotEditor 打开它。没装 CotEditor 看 Python 一章。别用「文本编辑」，它会把引号换成弯引号，这个文件就坏了。

2. 文件是空的，就把下面整段粘贴进去，把 sk-•••••• 换成你的 key：

   {
     "env": {
       "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
       "ANTHROPIC_AUTH_TOKEN": "sk-••••••",
       "ANTHROPIC_MODEL": "deepseek-flash[1m]",
       "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-flash[1m]",
       "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-flash[1m]",
       "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-flash",
       "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-flash",
       "CLAUDE_CODE_EFFORT_LEVEL": "max",
       "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "786432"
     }
   }

3. 文件里已经有内容（比如你以前用过 Claude Code），就只把 "env" 这一块加进去，不要整个覆盖。不确定怎么合并，把文件内容里的 key 换成 ••••••，贴到网页版的 AI 里（ChatGPT、DeepSeek 的网页都行，这一步还用不上 Claude Code），让它合并，再把结果贴回文件。

4. 保存。⌘ + S。

每一行是什么意思：

行	意思
ANTHROPIC_BASE_URL	去哪：DeepSeek 兼容 Anthropic 接口的地址
ANTHROPIC_AUTH_TOKEN	凭什么：你的 key
五行带 MODEL 的	用哪个脑。这里统一设为 deepseek-flash；前三行的 [1m] 表示使用 1M 上下文
最后两行	DeepSeek 文档给的推荐值，照抄

这个文件是 JSON，规矩很死：引号全是英文直引号，最后一项后面没有逗号，不能写注释。少一个逗号 Claude Code 就启动不了。它报 Settings Error，就回来对着上面的样子逐行看。

做到什么算会：先别在这里直接运行 claude，终端此刻站在你的个人文件夹，它会看到你所有东西。到下一节建好练习文件夹再启动。启动后它不让你登录 Anthropic 账户，界面里显示的模型名以 deepseek 开头，就通了；想再确认，输入 /status 看 API 地址。如果它让你登录，说明设置文件没被读到：路径、文件名、逗号，三处各看一遍。

操作前

这个文件只有你一个人用，改坏了删掉重来就行。如果文件里原来有内容，改之前先复制一份到桌面。

上面这一段的写法来自 DeepSeek 文档的「Integrate with Claude Code」页，核对于 2026-09-03。模型名会变，以后以 api-docs.deepseek.com 为准；Claude Code 的安装命令以 code.claude.com 的 Setup 页为准。

第一次用：Word、Excel、PPT 各一个示例

必须掌握

先拿到练习文件，放到对的地方。 下载这三个文件，内容全部虚构：合同草稿.docx、案件清单.xlsx、提纲.md。点了以后它们落在「下载」（Downloads）文件夹里。然后：

1. 给它们一个自己的文件夹。 访达里打开「下载」，⇧ + ⌘ + N 新建文件夹，叫 cc练习，把三个文件拖进去。不直接在「下载」里做，因为 Claude Code 看得到启动它的整个文件夹，而「下载」里什么都有。一个任务一个文件夹，这是长期习惯，不只是练习。
2. 终端进到这个文件夹。 ⌘ + 空格，输入「终端」，Enter。终端打开时站在你的个人文件夹，提示符里的 ~ 就是它。输入 cd 加一个空格，把 cc练习 文件夹从访达拖进终端窗口，Enter。然后 pwd 看一眼，应该是 /Users/你/Downloads/cc练习；ls 应该列出三个文件。
3. 启动。 输入 claude，Enter。第一次它会问你信不信这个文件夹，选信任。
4. 在里面怎么打字。 Enter 是发送，换行用 ⌃ + J；它跑偏了 Esc 打断；退出输入 /exit。

真文件也是这个流程：复制一份到专门的文件夹再开始，原件留在原处。练习文件随便折腾，练完把整个文件夹拖进废纸篓。

三个示例是同一套节奏：交代，它列计划，你放行，打开文件用眼睛检查，再改一轮。 每一轮只提一个要求。处理 Office 文件它通常要装几个 Python 库（python-docx、openpyxl、python-pptx 之类），会先问你，看清名字再批。第一次用到 python3 时 Mac 可能弹窗要装「命令行开发者工具」，点安装就行，终端一章有说明。

交代任务的写法和交代给 AI 那一章一样：说清要什么，材料给原件，让它先列计划。一条铁律：让它另存为新文件，原件不动。 正本一份，改出来的都是副本。开始前用 Word 打开合同草稿看一眼，一会儿要用眼睛比对。

示例一，Word：改合同，先看计划。

第一轮，只读：

读「合同草稿.docx」，把所有涉及期限的条款列出来：条款号、原文、天数。只列，不改。

对着 Word 逐条核对。漏了、多了，都告诉它。

第二轮，改：

把付款期限从 30 天改成 45 天，涉及的每一处都改。另存为「合同草稿-v2.docx」，原文件不动。动手之前先列出你要改哪几处。

它列出位置，你先看：合同里写着 30 日的不止付款一处，续展通知和报销也是 30 日。计划里把那两处也改了，就是它没分清，这正是先看计划的原因。你点头，它才动手。做完在 Word 里打开 v2，用「审阅」里的「比较」对比两份文件：看到的改动和它说的一样吗。

第三轮，加东西：

在文末加一张表：条款、期限、起算日。

它加的表不好看，直接说：「三列等宽，表头加粗。」一次一个要求，改到满意。

AI 注意

Claude Code 改 Word 是用程序改，不留修订（tracked changes）痕迹。要发给对方的版本，改动得在 Word 里用修订重做，或者用「比较」生成一份带修订的版本。Word 一章讲过为什么。

示例二，Excel：把乱表整理成能用的表。

第一轮，只报告：

看「案件清单.xlsx」，告诉我哪些地方不规范：日期格式、多余空格、合并单元格、一格里写了两件事。只报告，不改。

它报的和你打开看到的对不对得上。

第二轮，整理：

把到期日统一成 2026-09-03 这种格式，按到期日从近到远排序，另存为「案件清单-整理.xlsx」，原表不动。

打开新表看两件事：点一格到期日，它是日期还是文字（Excel 一章讲过，两者不一样）；排序对不对。

第三轮，加列：

加一列「剩余天数」，用公式算，不要写死数字。再加一个工作表「30 天内到期」，只放到期日在 30 天以内的行。

用公式而不是写死的数字，明天打开数字才会变。一行一条记录，一列一种属性，让它加列可以，别让它合并单元格。

第四轮，把它当同事校对：

检查一遍：有没有哪一行的到期日你没看懂、自己猜了一个？列出来。

这一问经常有收获。

示例三，PPT：从提纲到八页。

第一轮，先要标题清单：

根据「提纲.md」做一份 PPT，另存为「审查要点.pptx」。一页只说一件事，标题写成结论句，不写话题。先给我每页标题的清单，我确认了再生成。

把标题连起来读一遍，像不像一个完整的论证。不像，改标题，不动页。

第二轮，生成：

生成。16:9，正文字号不小于 24，每页不超过五行。

打开看。多半有几页字太多。

第三轮，调整：

第 3 页拆成两页。第 6 页的三点合并成一句。最后加一页「下一步」。

第四轮不交给它：打开 PowerPoint，自己导出 PDF。发给别人的是 PDF，PPT 一章说过为什么；交付这一下自己按。

三个示例做完，你学会的是同一件事：它列计划你放行，它改完你打开文件看，每轮只提一个要求，原件永远不动。真文件上也是这套节奏，只是要先复制一份到专门的文件夹再开始。

AI 注意

Claude Code 看得到你启动它的那个文件夹里的所有东西，看到的都会发到 DeepSeek 的服务器上。不要在放着客户资料、合同原件、卷宗的文件夹里运行它。保密义务不因对方是 AI 而豁免。给它一个只放这次任务文件的文件夹。

常见失误

知道即可

• 在个人文件夹根目录运行 claude。 它能看到你所有东西。先 cd 进具体的文件夹再运行，pwd 确认。
• 设置文件多了一个逗号、用了中文引号。 启动报错。终端里运行 claude doctor，它会报设置文件哪里读不了。
• key 贴进了聊天窗口。 让 AI 帮你看设置文件之前，先把 key 换成 ••••••。已经贴出去了，去平台删掉重建。
• 余额用完。 它会报错，去平台看用量和余额。费用按用量算，一次处理一个大文件夹可能比想象的多。
• 想换回 Claude 订阅。 把 "env" 这一块删掉，保存，重新运行 claude 登录。

什么时候这一页要重看

知道即可

• 安装命令变了：以 code.claude.com 为准。
• DeepSeek 的模型名变了：以 api-docs.deepseek.com 为准，/status 能看到当前用的是哪个。
• Claude Code 自己会在后台更新，不用管。claude --version 看版本。

不要这样做

• 不把 settings.json 截图或复制给任何人，包括 AI 聊天窗口。里面有 key。
• 不把 .claude 文件夹放进 Git、网盘或共享文件夹。
• 不在放着客户资料的文件夹里运行它。

The key is a password with your money behind it.

练习

装好、写好设置以后，下载练习文件，做示例一的第一轮。然后打开「密码」应用，确认 key 已经在里面。最后回到终端，运行 cat ~/.claude/settings.json，指着屏幕说出哪一行是「去哪」、哪一行是「凭什么」。