Ubuntu 部署 Claude Code DeepSeek 配置完全指南适用环境Ubuntu 20.04/22.04/24.04x86_64测试环境PyTorch 2.2.2 CUDA 11.8 cuDNN 8 Ubuntu 22.04更新时间2026-06-22一、环境准备Claude Code 本身与 PyTorch/CUDA 无直接依赖它是一个终端 AI 助手运行在用户态。安装前确保Ubuntu 20.04x86_64 或 ARM64网络可访问 npm 镜像清华/淘宝4GB 内存1.1 安装 Node.js20 LTS由于claude.ai/install.sh官方脚本在部分地区受限推荐使用npm 全局安装方式。通过清华大学镜像安装 Node.js# 下载清华镜像预编译的 Node.js 二进制包cd/usr/localcurl-Ohttps://mirrors.tuna.tsinghua.edu.cn/nodejs-release/v20.15.0/node-v20.15.0-linux-x64.tar.xztar-xvfnode-v20.15.0-linux-x64.tar.xz# 创建软链接到系统 PATHln-sf/usr/local/node-v20.15.0-linux-x64/bin/node /usr/local/bin/nodeln-sf/usr/local/node-v20.15.0-linux-x64/bin/npm /usr/local/bin/npm# 验证node--version# v20.15.0npm--version# 10.7.01.2 配置 npm 国内镜像加速npmconfigsetregistry https://registry.npmmirror.com二、安装 Claude Codenpminstall-ganthropic-ai/claude-code验证安装claude--versionclaude doctor注意官方推荐的curl -fsSL https://claude.ai/install.sh | bash方式在部分地区会返回App unavailable in region错误因此本文采用 npm 安装作为可靠替代方案。三、配置 DeepSeek API3.1 获取 DeepSeek API Key访问 platform.deepseek.com注册/登录 →API Keys→ 创建新密钥复制密钥格式为sk-...只显示一次请妥善保存3.2 一键配置脚本创建启动脚本将 DeepSeek Key 硬编码其中适合个人服务器/容器使用catstart-claude-deepseek.shEOF #!/bin/bash # 配置区 # 替换为你的真实 DeepSeek API Key DEEPSEEK_KEYsk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx # set -e echo echo Claude Code DeepSeek 启动脚本 echo echo # 检查 Key 是否已修改 if [[ $DEEPSEEK_KEY sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ]]; then echo ❌ 错误你还没有配置 DeepSeek API Key echo 请编辑本脚本将 DEEPSEEK_KEY 的值替换为你的真实 Key exit 1 fi # 检查 Claude Code if ! command -v claude /dev/null; then echo ❌ 错误未找到 claude 命令 exit 1 fi echo ✅ Claude Code 已安装 # 写入 ~/.bashrc首次运行时写入避免重复 if ! grep -q CLAUDE_CODE_DEEPSEEK_CONFIGURED ~/.bashrc 2/dev/null; then echo 首次运行写入环境变量到 ~/.bashrc ... cat ~/.bashrc ENVEOF # Claude Code DeepSeek Config [CLAUDE_CODE_DEEPSEEK_CONFIGURED] export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN$DEEPSEEK_KEY export ANTHROPIC_API_KEY$DEEPSEEK_KEY export ANTHROPIC_MODELdeepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flash export CLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flash export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1 export CLAUDE_CODE_EFFORT_LEVELmax # End Claude Code Config ENVEOF echo ✅ ~/.bashrc 已更新 else echo ✅ ~/.bashrc 已配置过跳过 fi # 写入 ~/.claude/settings.json持久化配置双重保险 echo 写入 ~/.claude/settings.json ... mkdir -p ~/.claude cat ~/.claude/settings.json JSONEOF { env: { ANTHROPIC_BASE_URL: https://api.deepseek.com/anthropic, ANTHROPIC_AUTH_TOKEN: $DEEPSEEK_KEY, ANTHROPIC_API_KEY: $DEEPSEEK_KEY, ANTHROPIC_MODEL: deepseek-v4-pro[1m], ANTHROPIC_DEFAULT_OPUS_MODEL: deepseek-v4-pro[1m], ANTHROPIC_DEFAULT_SONNET_MODEL: deepseek-v4-pro[1m], ANTHROPIC_DEFAULT_HAIKU_MODEL: deepseek-v4-flash, CLAUDE_CODE_SUBAGENT_MODEL: deepseek-v4-flash, CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC: 1, CLAUDE_CODE_EFFORT_LEVEL: max } } JSONEOF echo ✅ settings.json 已更新 # 当前会话立即生效 export ANTHROPIC_BASE_URLhttps://api.deepseek.com/anthropic export ANTHROPIC_AUTH_TOKEN$DEEPSEEK_KEY export ANTHROPIC_API_KEY$DEEPSEEK_KEY export ANTHROPIC_MODELdeepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_OPUS_MODELdeepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_SONNET_MODELdeepseek-v4-pro[1m] export ANTHROPIC_DEFAULT_HAIKU_MODELdeepseek-v4-flash export CLAUDE_CODE_SUBAGENT_MODELdeepseek-v4-flash export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC1 export CLAUDE_CODE_EFFORT_LEVELmax # 测试 DeepSeek 连接 echo echo 测试 DeepSeek 连接 ... TEST$(curl -s -w \n%{http_code} \ -H Authorization: Bearer $DEEPSEEK_KEY \ -H Content-Type: application/json \ -d {model:deepseek-v4-pro[1m],messages:[{role:user,content:Hi}],max_tokens:5} \ https://api.deepseek.com/v1/chat/completions 2/dev/null || echo CURL_FAILED) CODE$(echo $TEST | tail -n1) if [[ $TEST CURL_FAILED ]]; then echo ⚠️ 网络测试失败但配置已保存 elif [[ $CODE 200 ]]; then echo ✅ DeepSeek API 连接正常 elif [[ $CODE 401 ]]; then echo ⚠️ API Key 无效 (401)请检查 Key else echo ℹ️ DeepSeek 返回 HTTP $CODE fi # 启动 Claude Code echo echo echo 启动 Claude Code ... echo echo echo 提示输入 /status 查看当前模型配置 echo 输入 hi 测试 DeepSeek 是否正常回复 echo claude EOFchmodx start-claude-deepseek.sh3.3 修改脚本填入你的 Keynanostart-claude-deepseek.sh找到这一行DEEPSEEK_KEYsk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx将sk-xxxxxxxx...替换为你的真实 DeepSeek API Key保存退出CtrlO→CtrlX。3.4 运行脚本bashstart-claude-deepseek.sh首次运行会自动完成所有配置并启动 Claude Code。后续直接运行同一命令即可。四、日常使用命令4.1 标准交互模式推荐# 进入项目目录后启动cd/path/to/your-projectbashstart-claude-deepseek.sh4.2 全权自动模式非 root 用户如果你创建了普通用户可以使用--dangerously-skip-permissions跳过所有确认提示claude --dangerously-skip-permissions⚠️安全警告此模式下 Claude Code 会自动执行文件编辑和命令运行不会询问确认。请确保在正确的项目目录且代码已备份。4.3 在 Claude Code 内部常用命令命令作用/status查看当前模型、权限和连接状态/auto-accept开启自动接受所有编辑建议root 用户推荐/init生成CLAUDE.md让 Claude 深度理解项目结构/clear清空对话历史/cost查看本次会话的 API 消耗五、root 用户特殊处理Claude Code 出于安全考虑禁止 root 用户使用--dangerously-skip-permissions。方案 A创建普通用户推荐# 创建用户useradd-m-s/bin/bash dev# 切换用户su- dev# 确保 node 和 claude 在 PATHexportPATH/usr/local/node-v20.15.0-linux-x64/bin:$HOME/.local/bin:$PATH# 复制配置如需要mkdir-p~/.claudecp/root/.claude/settings.json ~/.claude/settings.json2/dev/null||true# 现在可以全权运行claude --dangerously-skip-permissions方案 Broot 下使用 /auto-acceptclaude进入后输入/auto-accept六、模型配置说明环境变量说明推荐值ANTHROPIC_BASE_URLDeepSeek 兼容接口地址https://api.deepseek.com/anthropic不要加尾部斜杠或/v1ANTHROPIC_MODEL主模型deepseek-v4-pro[1m]ANTHROPIC_DEFAULT_SONNET_MODEL中等复杂度任务deepseek-v4-pro[1m]ANTHROPIC_DEFAULT_HAIKU_MODEL简单/子代理任务deepseek-v4-flashCLAUDE_CODE_SUBAGENT_MODEL子代理模型deepseek-v4-flashCLAUDE_CODE_EFFORT_LEVEL推理努力程度max[1m]后缀显式请求 1M 上下文窗口处理大代码库时建议带上。七、常见问题排查问题原因解决方案bash: line 1: syntax error near unexpected token 官方安装脚本受地区限制改用本文的 npm 安装方式GnuTLS recv error (-110)GitHub 访问受限用清华镜像安装 Node.js--dangerously-skip-permissions cannot be used with root安全限制创建普通用户或进入后用/auto-acceptAPI Error: streaming failed流式传输失败添加export CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK1401 UnauthorizedAPI Key 无效同时设置ANTHROPIC_AUTH_TOKEN和ANTHROPIC_API_KEY为同一 Key404 model not found模型名称错误使用deepseek-v4-pro[1m]而非旧版deepseek-chat八、安全建议文件权限脚本包含 API Key建议设置chmod 600 start-claude-deepseek.sh不要上传切勿将含 Key 的脚本提交到 GitHub 或共享给他人定期轮换在 DeepSeek 平台定期更换 API Key成本监控使用/cost命令查看消耗避免意外高额账单九、快速检查清单部署完成后逐项确认Node.js 20 已安装 (node --version)Claude Code 已安装 (claude --version)DeepSeek API Key 已填入脚本脚本已运行并测试连接成功~/.bashrc已包含环境变量配置~/.claude/settings.json已写入进入 Claude Code 后/status显示 DeepSeek 模型输入hi能正常收到 DeepSeek 回复本文基于 Claude Code 官方文档及 DeepSeek API 兼容接口实践整理。