Claude Code 完全重装与接入 DeepSeek 指南-程序员充电站

从卸载清理到接入全新模型，一篇搞定

如果你在使用 Claude Code 时遇到了莫名其妙的 bug，或者想要尝试更强大的模型（比如 DeepSeek），彻底重装并接入新模型是一个不错的选择。本文将带你一步步完成：

完全卸载Claude Code 并清理所有残留配置
重新安装最新版
无缝接入DeepSeek API（兼容 Anthropic 协议）

为什么需要“完全”卸载？

普通的npm uninstall只会删除 npm 包本身，而 Claude Code 会在用户目录下生成大量配置文件、缓存和认证信息。残留的文件可能导致重装后依然出现相同的问题，或者干扰新模型的配置。

因此，我们不仅要卸载 npm 包，还要手动删除以下目录：

第一步：完全卸载 Claude Code

1. 卸载全局 npm 包

npmuninstall-g@anthropic-ai/claude-code

确认已卸载：

npmlist-g--depth=0# 应该不再看到 @anthropic-ai/claude-code

2. 清理所有残留文件

rm-rf~/.clauderm-f~/.claude.jsonrm-rf~/.cache/claude-coderm-rf~/.cache/clauderm-rf~/.cache/claude-cli-nodejsrm-rf~/.config/claude-coderm-rf~/.local/state/clauderm-rf~/.local/share/claude

3. 清理 npm 缓存（可选但推荐）

npmcache clean--force

至此，Claude Code 已经彻底从系统中移除。

第二步：重新安装 Claude Code

使用官方源直接安装即可：

npminstall-g@anthropic-ai/claude-code

安装完成后，不要立即运行claude，我们先配置 DeepSeek 作为后端。

第三步：接入 DeepSeek 模型（兼容 Anthropic API）

DeepSeek 提供了Anthropic API 兼容层，你可以直接将 Claude Code 指向 DeepSeek 的端点，而无需修改 Claude Code 本身。

你需要准备：

一个有效的DeepSeek API Key（获取地址）
熟悉要使用的模型名称：
- deepseek-v4-pro– 复杂任务（架构设计、逻辑推理）
- deepseek-v4-flash– 轻量任务（快速问答、文件操作）

Linux 永久配置方法

有两种方式可以将环境变量永久化。

方法一：写入 Shell 配置文件（`~/.bashrc`或`~/.zshrc`）

编辑文件：

nano~/.bashrc# 如果使用 zsh 则改为 ~/.zshrc

在文件末尾添加以下内容（替换your-deepseek-api-key为真实 key）：

exportANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"exportANTHROPIC_AUTH_TOKEN="your-deepseek-api-key"exportANTHROPIC_MODEL="deepseek-v4-pro"exportANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro"exportANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro"exportANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"exportCLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"exportCLAUDE_CODE_EFFORT_LEVEL="max"

保存后执行：

source~/.bashrc# 或 source ~/.zshrc

方法二：使用 Claude Code 的`settings.json`（官方推荐）

创建配置文件：

mkdir-p~/.claudenano~/.claude/settings.json

写入以下 JSON 内容（同样替换 API Key）：

{"env":{"ANTHROPIC_BASE_URL":"https://api.deepseek.com/anthropic","ANTHROPIC_AUTH_TOKEN":"your-deepseek-api-key","ANTHROPIC_MODEL":"deepseek-v4-pro","ANTHROPIC_DEFAULT_OPUS_MODEL":"deepseek-v4-pro","ANTHROPIC_DEFAULT_SONNET_MODEL":"deepseek-v4-pro","ANTHROPIC_DEFAULT_HAIKU_MODEL":"deepseek-v4-flash","CLAUDE_CODE_SUBAGENT_MODEL":"deepseek-v4-flash","CLAUDE_CODE_EFFORT_LEVEL":"max"},"model":"deepseek-v4-pro"}

保存文件即可，无需source。

第四步：验证配置是否生效

运行 Claude Code：

claude

你应该看到：

启动时不再提示需要登录 Anthropic 账号
显示的模型名称是deepseek-v4-pro或你配置的模型
可以正常执行/help或询问简单问题

如果遇到400 Bad Request错误，请检查ANTHROPIC_BASE_URL中是否包含了多余的反斜杠（如https://api.deepseek.com/anthropic\），务必删除末尾的\。

可选的模型切换

在对话中临时切换模型（适用于已配置的模型）：

/model deepseek-v4-flash

也可以为特定子代理指定模型（在settings.json中已包含相关配置）。

附录：常见问题

问题	解决方案
`claude: command not found`	检查 npm 全局 bin 路径是否在`$PATH`中，或重新安装
一直要求登录 Anthropic	环境变量未生效，检查`ANTHROPIC_BASE_URL`和`ANTHROPIC_AUTH_TOKEN`
请求被拒绝（403）	API Key 无效或已过期，重新生成
速度很慢	尝试使用`deepseek-v4-flash`模型