摘要

在现代开发流中,频繁的上下文切换是阻碍生产力的核心瓶颈之一。Web 端聊天界面虽然直观,但对于已经习惯 Shell 的 Linux 开发者来说,把 LLM 拉进终端、让它直接读写工作区文件、执行命令,往往是更顺手的协作方式。

本文以 Ubuntu 22.04/24.04 为环境,分别介绍 Claude Code(Anthropic 官方)和 DeepSeek-TUI(社区第三方)这两款终端 Agent 的安装、登录与使用要点,并附上国内网络环境下的避坑提示。

关于本文的两个工具定位 Claude Code 是 Anthropic 官方发布的终端 Agent;DeepSeek-TUI 是社区项目(作者 Hunter Bown,GitHub: Hmbown),并非 DeepSeek 官方产品,但目前是把 DeepSeek API 用成 Agent 的较成熟方案之一。两者在能力上是同类竞品(都支持文件读写、Shell 执行、Git、MCP),不存在"轻量 vs 工程级"的层级关系——选哪个主要看预算、网络环境和模型偏好。

终端方案的几个实际优势

  • 资源占用低:相比 Chromium 类客户端,CLI 工具的常驻内存通常在几十 MB 量级,给编译和重型任务留出空间。
  • 原生 I/O 衔接:可以直接通过管道、重定向把上下游命令串起来,例如 cat error.log | claude -p "解释这段报错"
  • 工作区感知:两款工具默认都以当前目录为上下文,省去手动复制粘贴的环节。

1. 环境预检:Node.js

Claude Code 的 npm 安装方式和 DeepSeek-TUI 的 npm 包装器都依赖 Node.js(要求 v18 及以上)。如果你打算只用 Claude Code 的 native installer,则可以跳过这一步。

检查版本:

node --version

安装 / 升级(推荐 nvm 方式,避免后续权限问题):

# 安装 nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

# 重新载入 shell 配置
source ~/.bashrc

# 安装 Node.js 22 LTS
nvm install --lts

如果偏好 NodeSource 的二进制分发:

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

解决 npm 全局安装的权限问题

在 Linux 下 npm install -g 经常报 EACCES不要用 sudo npm——它会把 root 拥有的文件写到全局目录,后面更难清理。推荐改成用户目录下的全局路径:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

如果用 nvm 安装的 Node,这一步可以跳过——nvm 默认就把全局包装在用户目录下。


2. Claude Code 的安装与登录

Claude Code 是 Anthropic 官方推出的终端 Agent,具备文件系统读写、Shell 执行、Git 操作和 MCP 集成能力。

使用前提:Claude Code 需要 Claude Pro / Max / Team / Enterprise 订阅,或一个带 API credits 的 Anthropic Console 账号。免费版 Claude.ai 不能用 Claude Code

安装方式一:Native Installer(官方推荐)

这是目前 Anthropic 推荐的安装方式,不需要 Node.js,自带后台自动更新:

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

二进制会被放到 ~/.local/bin,确保这个路径在 PATH 里。

安装方式二:npm(仍受支持,需要 Node.js 18+)

npm install -g @anthropic-ai/claude-code

如果之前用 npm 装过,想迁移到 native:

curl -fsSL https://claude.ai/install.sh | bash
npm uninstall -g @anthropic-ai/claude-code

验证与登录

claude --version
claude doctor   # 检查 PATH、认证、MCP 状态

第一次运行 claude,会自动打开浏览器走 OAuth 流程,登录你的 Anthropic 账号、点击授权后,终端会自动同步登录状态。

如果浏览器回调被防火墙或远程 SSH 阻塞,终端会提示按 c 复制登录 URL,你在另一台机器的浏览器里完成登录后,把页面返回的 authorization code 粘贴回终端即可。

对于无法跳浏览器的服务器或容器,也可以用 API key 方式:

export ANTHROPIC_API_KEY=sk-ant-...
claude

⚠️ 中国大陆网络提示

Anthropic 服务在中国大陆需要科学上网才能访问,OAuth 回调和 API 流量都受影响。如果在大陆裸连,登录这一步基本会卡住。这是基础设施层面的限制,没有官方解法。


3. DeepSeek-TUI 的安装与配置

DeepSeek-TUI 是一个由 Rust 编写的开源终端 Agent,通过 OpenAI 兼容协议接入 DeepSeek 的 V4 系列模型。它的能力面跟 Claude Code 高度重合:文件读写、Shell 执行、Git、Web 搜索、MCP 服务、sub-agent,三种工作模式(Plan / Agent / YOLO)。

再次强调:这是社区第三方项目,并非 DeepSeek 官方出品。请自行评估对第三方工具的信任成本。

安装

通过 npm 安装(npm 包只是一个下载器,会拉取对应平台的预编译 Rust 二进制):

npm install -g deepseek-tui

如果在国内 npm/GitHub 下载慢,可以用淘宝镜像:

npm install -g deepseek-tui --registry=https://registry.npmmirror.com

或者跳过 npm,直接用 Cargo(需要 Rust 1.85+):

cargo install deepseek-tui-cli --locked
cargo install deepseek-tui --locked

国内 Cargo 用户可以配 TUNA 镜像,编辑 ~/.cargo/config.toml

[source.crates-io]
replace-with = "tuna"
[source.tuna]
registry = "sparse+https://mirrors.tuna.tsinghua.edu.cn/crates.io-index/"

验证安装

deepseek --version
deepseek doctor   # 检查 API key、provider、PATH

配置 API Key

前往 DeepSeek 开放平台 创建一个 API Key,然后:

deepseek auth set --provider deepseek --api-key "你的_API_KEY"

或者用环境变量:

export DEEPSEEK_API_KEY="你的_API_KEY"

key 会被保存到 ~/.deepseek/config.toml

启动

deepseek                                  # 进入交互式 TUI
deepseek "解释这个函数"                    # 单次 prompt
deepseek --model deepseek-v4-flash "总结"  # 指定模型

4. 实战:一个项目里两种工具能怎么用

进入项目根目录后,两种工具的使用方式几乎一致——直接在 shell 里输入 claudedeepseek,然后用自然语言下指令:

"分析当前项目的 Dockerfile 是否有安全风险,并提出修改建议。"

"我刚改了 src/auth/login.ts,帮我跑一下相关的单元测试,失败的话尝试修复。"

工具会自动读取文件树、Git 状态,在征得你同意后执行修改和命令。Plan 模式(只读探索)和 Agent 模式(每个工具调用都需要确认)是日常推荐,YOLO 模式(全自动)只建议在隔离环境用。

怎么选

  • 预算敏感、希望走国内 API、可以接受第三方工具 → DeepSeek-TUI + DeepSeek V4 系列。DeepSeek 的 token 价格和缓存命中折扣对长会话很友好。
  • 追求模型能力上限、可接受订阅费、网络可达 → Claude Code + Claude 订阅。在 SWE-bench 这类工程基准上目前仍是头部。
  • 两者都装也完全 OK ——配置文件不冲突,可以按任务切换。

结语

把 LLM 从浏览器搬进终端,本质上是让 AI 从"外部咨询师"变成"在同一台机器上和你协作的搭档"。Claude Code 和 DeepSeek-TUI 代表了"官方付费"和"社区开源"两条路径,但它们的设计思路是趋同的:让模型直接读你的文件、跑你的命令、提交你的 commit,而不是让你不停地复制粘贴。

无论选哪个,都建议从 Plan 模式起手,养成"先看 diff 再批准"的习惯。Agent 越强,工程师的 review 反而越重要。

Logo

有“AI”的1024 = 2048,欢迎大家加入2048 AI社区

更多推荐