1. 为什么要在 Ubuntu 终端里折腾这套组合在 Ubuntu 上写代码的人大概都经历过这样一个阶段一开始用 IDE 自带的补全觉得够用后来接触到终端里的 AI 编程助手发现回不去了。原因很简单——终端是 Linux 开发者的主战场编译、调试、部署、看日志全在终端里完成。如果 AI 助手只能在图形界面的编辑器里用那每次切换窗口都是一次注意力损耗。Claude Code 是 Anthropic 推出的一款终端 AI 编程助手它的定位很明确不抢 IDE 的活而是作为一个命令行工具在你最熟悉的终端环境里提供代码理解、生成、重构、调试建议等能力。它的交互方式很直接——你在项目目录下敲一个命令它读取当前项目的上下文然后你用自然语言描述需求它给出代码或操作建议。但这里有个现实问题Claude Code 默认走的是 Anthropic 自家的模型服务对国内用户来说网络延迟和费用都是门槛。而 DeepSeek 作为国产开源模型里的第一梯队API 价格极低代码能力在多个基准测试上表现亮眼尤其是 DeepSeek-Coder 系列在代码补全和生成任务上的表现已经能满足日常开发需求。所以把 Claude Code 的后端模型换成 DeepSeek就成了一件很有性价比的事情。这套方案适合谁如果你是 Ubuntu 用户日常在终端里工作想用 AI 辅助编程但不想承担高昂的 API 费用或者你已经在用 DeepSeek 的 API 做其他事情想把它接入到编程助手的工作流里那这篇内容就是为你准备的。即使你之前没接触过 Claude Code只要你会用终端、会编辑配置文件跟着走一遍就能跑起来。我自己的环境是 Ubuntu 22.04 LTS终端用的是系统自带的 GNOME TerminalShell 是 Bash。这套配置在 Ubuntu 20.04 和 24.04 上同样适用差异很小。下面我会从环境准备开始一步步拆解整个配置过程包括我踩过的坑和最终稳定的方案。2. 环境准备与前置依赖梳理2.1 系统版本与基础工具确认在开始之前先确认你的 Ubuntu 版本和基础工具是否齐全。打开终端执行lsb_release -a输出会显示你的发行版版本号。Claude Code 对系统版本没有特别严格的要求但建议 Ubuntu 20.04 及以上因为 Node.js 的版本支持会更好。如果你还在用 18.04建议先升级系统否则后面装 Node.js 20 的时候会遇到依赖问题。接下来确认几个基础工具node -v npm -v git --version curl --version这四个工具是后续步骤的基础。Node.js 是 Claude Code 的运行环境npm 用来安装包git 用于版本管理和某些依赖的拉取curl 用于测试 API 连通性。如果哪个命令提示“command not found”就需要先安装。注意不要用apt install nodejs直接装 Ubuntu 仓库里的 Node.js版本太老Claude Code 要求 Node.js 18 以上建议直接上 Node.js 20 LTS。2.2 Node.js 20 的安装方式选择在 Ubuntu 上装 Node.js 有几种常见方式我对比一下各自的优劣安装方式优点缺点推荐场景NodeSource 仓库版本新apt 管理方便需要添加第三方源大多数用户nvm多版本切换灵活需要配置 Shell 环境需要多版本共存官方二进制包可控性强手动管理路径特殊需求Snap安装简单版本更新滞后权限问题多不推荐我推荐用 NodeSource 仓库的方式命令如下curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs执行完之后验证node -v # 应该输出 v20.x.x npm -v # 应该输出 10.x.x如果你之前装过其他版本的 Node.js建议先清理干净再装避免路径冲突。清理命令sudo apt remove --purge nodejs npm sudo apt autoremove然后用上面的 NodeSource 方式重新安装。2.3 DeepSeek API Key 的获取与验证Claude Code 接入 DeepSeek 的核心是把 DeepSeek 的 API 作为后端。所以你需要一个 DeepSeek 的 API Key。获取流程大致是注册 DeepSeek 开放平台账号进入 API 管理页面创建一个新的 API Key复制保存。拿到 Key 之后先别急着配置 Claude Code用 curl 验证一下 Key 是否可用curl -X POST https://api.deepseek.com/v1/chat/completions \ -H Content-Type: application/json \ -H Authorization: Bearer 你的API_KEY \ -d { model: deepseek-chat, messages: [{role: user, content: 说一句你好}], max_tokens: 50 }如果返回的 JSON 里有正常的回复内容说明 Key 和网络都没问题。如果返回 401检查 Key 是否复制完整如果返回 402说明账户余额不足如果超时检查网络连通性。提示DeepSeek 的 API 端点地址是https://api.deepseek.com兼容 OpenAI 的接口格式。这一点很关键因为 Claude Code 支持自定义 API 端点只要目标服务兼容 OpenAI 的接口规范就能对接。我实测下来DeepSeek 的 API 响应速度在国内网络环境下很稳定代码生成任务的延迟通常在 2-5 秒之间取决于输出长度。这个延迟在终端交互场景下是可以接受的。3. Claude Code 的安装与基础配置3.1 安装 Claude CodeClaude Code 的安装方式有几种最直接的是通过 npm 全局安装npm install -g anthropic-ai/claude-code安装完成后验证是否成功claude --version如果输出了版本号说明安装成功。如果提示命令找不到检查 npm 的全局 bin 目录是否在 PATH 里npm config get prefix # 通常输出 /usr/local 或 /usr echo $PATH # 确认上面的路径在 PATH 中如果不在手动添加export PATH$PATH:/usr/local/bin然后把这行加到~/.bashrc里执行source ~/.bashrc生效。注意有些教程会建议用sudo npm install -g我不推荐这样做。用 sudo 安装会导致后续配置文件权限混乱而且 Claude Code 的配置是写在用户目录下的用 sudo 装反而容易出问题。如果遇到权限错误正确做法是配置 npm 的全局目录到用户目录下而不是用 sudo。3.2 首次运行与初始化安装完成后在任意项目目录下执行claude首次运行会进入一个初始化流程它会引导你完成一些基础设置包括选择主题、确认配置目录等。这个流程走完之后会在你的用户目录下生成一个配置文件夹通常是~/.claude/。这个目录里会有几个关键文件settings.json主配置文件模型、API 端点等都在这里设置credentials.json凭证文件存储 API Keyprojects/项目级别的配置和缓存你可以先看一下settings.json的默认内容cat ~/.claude/settings.json默认情况下它可能是一个空对象或者包含少量默认配置。接下来我们要做的就是修改这个文件把后端模型指向 DeepSeek。3.3 理解 Claude Code 的配置层级Claude Code 的配置有三个层级优先级从高到低项目级配置项目根目录下的.claude/settings.json只对当前项目生效用户级配置~/.claude/settings.json对当前用户的所有项目生效系统级配置/etc/claude/settings.json对所有用户生效很少用我建议把 DeepSeek 的配置写在用户级配置里这样所有项目都能用。如果你有多个项目需要用不同的模型可以在项目级配置里覆盖。配置文件的格式是 JSON支持环境变量引用。这一点很实用因为 API Key 不应该明文写在配置文件里而是通过环境变量传入。4. 接入 DeepSeek 模型的核心配置4.1 配置文件的完整写法这是整个方案的核心部分。打开~/.claude/settings.json写入以下内容{ env: { ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_AUTH_TOKEN: 你的DeepSeek_API_Key, ANTHROPIC_MODEL: deepseek-chat, ANTHROPIC_SMALL_FAST_MODEL: deepseek-chat } }这里有几个关键点需要解释ANTHROPIC_BASE_URL是 API 的基础地址。DeepSeek 提供了一个兼容 Anthropic 接口格式的端点路径是/anthropic。这个端点的作用是让 Claude Code 以为自己在跟 Anthropic 的服务器通信实际上请求被转发到了 DeepSeek 的模型上。ANTHROPIC_AUTH_TOKEN就是你的 DeepSeek API Key。注意这里用的是AUTH_TOKEN而不是API_KEY因为 Claude Code 的认证机制用的是 Bearer Token 方式。ANTHROPIC_MODEL指定主模型这里填deepseek-chat。如果你需要用 DeepSeek 的推理模型可以填deepseek-reasoner但要注意推理模型的响应速度会慢一些适合复杂任务。ANTHROPIC_SMALL_FAST_MODEL是用于轻量任务的快速模型比如生成标题、简单补全等。填deepseek-chat就行DeepSeek 目前没有单独的轻量模型。注意API Key 直接写在配置文件里有安全风险。更稳妥的做法是用环境变量。在~/.bashrc里添加export DEEPSEEK_API_KEY你的Key然后在配置文件里写ANTHROPIC_AUTH_TOKEN: ${DEEPSEEK_API_KEY}。Claude Code 支持这种环境变量引用语法。4.2 验证配置是否生效配置写完之后重新打开一个终端或者执行source ~/.bashrc然后进入一个项目目录运行claude进入交互界面后输入一个简单的问题比如“这个项目用的是什么语言”看它是否能正常回复。如果回复正常说明配置生效了。如果报错常见的错误信息有401 UnauthorizedAPI Key 不对检查 Key 是否复制完整有没有多余空格404 Not FoundBASE_URL 写错了确认是https://api.deepseek.com/anthropicConnection timeout网络问题检查是否能访问 DeepSeek 的 APIModel not found模型名称写错了确认是deepseek-chat或deepseek-reasoner我实测下来最容易出错的是 BASE_URL 的路径。很多人只写了https://api.deepseek.com漏掉了/anthropic后缀结果一直报 404。这个后缀是必须的因为 DeepSeek 的 Anthropic 兼容端点和 OpenAI 兼容端点是两个不同的路径。4.3 模型选择与参数调优DeepSeek 目前提供两个主要模型模型名称适用场景响应速度代码能力费用deepseek-chat日常对话、代码生成、重构快强低deepseek-reasoner复杂逻辑推理、算法设计慢很强中等对于大多数编程辅助场景deepseek-chat已经足够。它的代码生成质量在同类模型中属于第一梯队尤其是 Python、JavaScript、Go 这些主流语言。如果你遇到复杂的算法问题或者需要深度推理的任务可以临时切换到deepseek-reasoner。切换方式有两种一是直接改配置文件里的ANTHROPIC_MODEL二是用命令行参数覆盖claude --model deepseek-reasoner另外Claude Code 支持通过MAX_THINKING_TOKENS环境变量控制推理模型的思考长度。对于deepseek-reasoner可以设置{ env: { MAX_THINKING_TOKENS: 4000 } }这个值越大模型在推理阶段花的时间越多输出质量可能更高但响应也更慢。我一般设 2000-4000 之间平衡速度和质量。5. 实操流程与关键环节拆解5.1 从零开始的完整操作序列假设你是一台全新的 Ubuntu 机器下面是完整的操作序列按顺序执行即可第一步更新系统并安装基础工具sudo apt update sudo apt upgrade -y sudo apt install -y curl git build-essential第二步安装 Node.js 20curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - sudo apt install -y nodejs node -v # 验证第三步安装 Claude Codenpm install -g anthropic-ai/claude-code claude --version # 验证第四步配置 DeepSeek API Keyecho export DEEPSEEK_API_KEY你的Key ~/.bashrc source ~/.bashrc第五步写入 Claude Code 配置mkdir -p ~/.claude cat ~/.claude/settings.json EOF { env: { ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_AUTH_TOKEN: ${DEEPSEEK_API_KEY}, ANTHROPIC_MODEL: deepseek-chat, ANTHROPIC_SMALL_FAST_MODEL: deepseek-chat } } EOF第六步验证cd ~/你的项目目录 claude在交互界面里输入测试问题确认能正常回复。这套流程我重复过多次在新机器上大概 5 分钟就能跑通。关键是要按顺序来尤其是 Node.js 的安装不要跳过。5.2 项目级配置的覆盖技巧如果你有多个项目有的用 DeepSeek有的用其他模型可以在项目根目录下创建.claude/settings.json来覆盖用户级配置。比如某个项目需要用deepseek-reasoner{ env: { ANTHROPIC_MODEL: deepseek-reasoner } }这个文件只需要写要覆盖的字段其他字段会继承用户级配置。这样你就不用每次手动切换模型了。提示项目级配置建议加到.gitignore里避免把 API Key 相关的配置提交到仓库。虽然我们用了环境变量引用但模型选择这类配置因人而异不适合团队共享。5.3 终端环境下的高效使用技巧Claude Code 在终端里的交互方式跟图形界面工具不太一样有几个技巧能显著提升效率利用管道传入上下文。你可以把命令的输出直接传给 Claude Codecat error.log | claude 分析这个错误日志找出根本原因这种方式特别适合调试场景。比如编译报错了直接把错误输出管道传给 Claude Code让它分析。在项目根目录启动。Claude Code 会读取当前目录的文件结构作为上下文。在项目根目录启动它能看到的上下文最完整。如果你在子目录里启动它可能看不到项目的全貌。用/命令。Claude Code 的交互界面支持斜杠命令比如/help查看帮助/clear清空对话历史/compact压缩上下文。这些命令能帮你更好地管理对话。控制上下文长度。DeepSeek 的 API 有 token 限制虽然比早期模型宽松很多但如果你在一个超大项目里让 Claude Code 读取所有文件可能会超出限制。这时候可以用.claudeignore文件排除不需要的目录比如node_modules、dist、.git等。# .claudeignore 示例 node_modules/ dist/ build/ .git/ *.log这个文件放在项目根目录Claude Code 会自动忽略里面列出的路径。我实测下来加上这个配置后大项目的响应速度明显提升。6. 常见问题与排查技巧实录6.1 配置类问题速查表问题现象可能原因解决方法command not found: claudenpm 全局路径不在 PATH检查npm config get prefix添加到 PATH401 UnauthorizedAPI Key 错误或过期重新生成 Key确认无多余空格404 Not FoundBASE_URL 缺少/anthropic改为https://api.deepseek.com/anthropicModel not found模型名称拼写错误确认是deepseek-chat或deepseek-reasoner响应超时网络问题或 API 限流检查网络降低并发请求频率配置文件不生效JSON 格式错误用python -m json.tool验证 JSON环境变量未读取Shell 未重新加载执行source ~/.bashrc或重开终端6.2 我踩过的三个坑第一个坑用 sudo 安装 Claude Code。一开始我图省事直接sudo npm install -g结果 Claude Code 的配置文件写到了 root 用户目录下普通用户运行时读不到配置一直报认证失败。后来卸载重装用普通用户权限安装才解决。这个坑的本质是 npm 全局目录的权限问题正确做法是配置 npm 的 prefix 到用户目录mkdir -p ~/.npm-global npm config set prefix ~/.npm-global echo export PATH~/.npm-global/bin:$PATH ~/.bashrc source ~/.bashrc然后再安装就不需要 sudo 了。第二个坑API Key 里的隐藏字符。从网页复制 API Key 的时候有时候会带上不可见的空格或换行符。这种问题很隐蔽因为肉眼看不出来。我的排查方法是echo -n $DEEPSEEK_API_KEY | wc -c对比一下 Key 的实际长度和预期长度如果多了几个字符就是有隐藏字符。解决方法是重新复制或者用tr -d [:space:]清理export DEEPSEEK_API_KEY$(echo -n 你的Key | tr -d [:space:])第三个坑JSON 配置文件里的尾逗号。JSON 标准不允许最后一个元素后面有逗号但很多人写配置的时候习惯性加上。Claude Code 读取配置时如果遇到尾逗号会直接报解析错误而且错误信息不明确只提示“配置加载失败”。排查方法是python3 -m json.tool ~/.claude/settings.json如果 JSON 有问题这个命令会指出具体的行号和错误类型。6.3 性能优化的几个实用技巧减少不必要的上下文读取。Claude Code 默认会读取项目里的文件作为上下文如果项目很大这会消耗大量 token。除了用.claudeignore排除目录还可以在提问时明确指定文件范围比如“只看 src/main.py 这个文件”。合理使用快速模型。ANTHROPIC_SMALL_FAST_MODEL用于轻量任务比如生成对话标题、简单的代码补全。把它设成deepseek-chat就行不需要用deepseek-reasoner否则每次轻量任务都要等很久。批量操作代替逐条提问。如果你有多个相关的修改需求一次性描述清楚比分开多次提问效率高。因为每次提问都会重新发送上下文批量操作能减少重复的 token 消耗。监控 API 用量。DeepSeek 的开放平台有用量统计页面定期看一下消耗情况。如果发现某个项目的消耗异常高检查是不是上下文读取范围太大了。7. 进阶玩法与扩展思路7.1 结合其他终端工具提升效率Claude Code 本身是一个命令行工具但它可以和其他终端工具组合使用形成更高效的工作流。比如配合tmux使用你可以在一个窗格里跑 Claude Code另一个窗格里跑测试互不干扰。tmux new -s claude # 在 tmux 会话里运行 claude配合fzf做模糊查找快速定位文件fzf --preview cat {} | xargs -I {} claude 解释这个文件的作用{}这种组合方式适合在大型项目里快速理解代码结构。7.2 多模型切换的配置方案如果你同时有 DeepSeek 和其他模型的 API可以配置多个 profile通过环境变量切换。在~/.bashrc里定义不同的配置alias claude-deepseekANTHROPIC_MODELdeepseek-chat claude alias claude-reasonerANTHROPIC_MODELdeepseek-reasoner claude这样你就可以根据任务类型快速切换模型不用每次改配置文件。7.3 在远程服务器上的部署注意事项如果你是在远程 Ubuntu 服务器上配置这套方案有几点需要注意终端复用。用tmux或screen保持会话避免 SSH 断开后 Claude Code 进程被终止。API Key 的安全存储。远程服务器上的环境变量文件权限要控制好chmod 600 ~/.bashrc网络延迟。远程服务器的网络环境可能和本地不同如果 API 响应慢可以考虑在本地做代理转发但要注意合规性。我一般直接测试服务器的网络连通性curl -o /dev/null -s -w %{time_total}\n https://api.deepseek.com如果延迟超过 2 秒体验会明显下降。7.4 后续可以扩展的方向这套配置跑通之后还有一些可以继续折腾的方向。比如把 Claude Code 集成到 CI/CD 流程里用来自动审查代码或者写一些自定义的 prompt 模板针对特定类型的任务优化输出质量。另外DeepSeek 的模型在持续迭代新版本可能会带来更好的代码能力。定期关注开放平台的更新公告及时调整模型名称和参数能让你始终用上最新的能力。我个人在实际操作中的体会是这套方案最大的价值不在于省了多少钱而在于它把 AI 编程助手变成了终端工作流的一部分。你不需要切换窗口不需要复制粘贴代码所有的交互都在终端里完成。这种流畅感一旦习惯了就很难回到过去的方式。踩过几次坑之后我把配置整理成了一个脚本在新机器上一条命令就能部署好省去了重复劳动。如果你也经常在新环境里工作建议把配置脚本化会省很多时间。