介绍

我意识到距离上次发文已经很久了——最近生活忙碌，几乎没有时间折腾有趣的项目。最近我发现了 Claude Code，这是 Anthropic 的官方 CLI 工具，可以将 Claude 的能力直接带到终端，我决定探索如何在 Termux 上运行它。作为一个在日常开发工作流中经常使用 Cursor + Claude Code 的人，我已经很熟悉这个配套了😂。

是时候在 Termux 中运行 Claude Code 了！在我的 Android 手机上原生运行一个功能齐全的 AI 编程助手的想法实在太有趣了，让我无法抗拒（对那些运行第三方 ROM 的旧手机来说很棒，哈哈）。当然，这可能不是日常开发工作的最实用设置，但在移动设备上突破可能性边界确实令人兴奋。

实际上，老实说——一旦我找到了正确的方法，整个设置只花了大约 15 分钟。我成功让 Claude Code 在 Termux 上运行，甚至还设置了 Claude Code Router 来无缝切换不同的 AI 模型。一旦你知道怎么做，这出人意料地简单，基本上和你在电脑上用 npm 做的事情一样。

在这个指南中，我将带你走完整个过程——从安装必要的依赖项到配置 Claude Code Router 以获得最大的灵活性。无论你是喜欢尝试非传统设置的人，偶尔需要移动 AI 助手的开发者，还是只是对现代移动计算的可能性感到好奇，这个设置可能会激发你的兴趣。

这篇文章是用 Claude Code 写的——没错，就是用我刚才描述的完全相同的 Termux 设置。很酷吧？

感觉这是运行 ollama 的更好方式。让我想起了 open interpreter。是的，过了很长时间了。

Claude Code running in Termux

如你在上面的截图中所见，整个工作流程在 Termux 中运行得很流畅——从左侧的初始安装过程，到中间的权限确认，再到右侧 Claude Code Router 积极帮助处理诸如行程规划等实际任务。

准备工作

在深入 Claude Code 安装之前，让我带你了解一下需要准备的东西。好消息是，如果你之前用过 Termux，这些大部分都是标准操作。

你需要的东西：

  • 安装了 Termux 的 Android 设备
  • 稳定的网络连接
  • 大约 200MB 的可用存储空间

首先——确保你安装的 Termux 来自 F-Droid，而不是 Google Play Store。Play Store 版本已经过时，会给你带来麻烦。如果你已经安装了 Play Store 版本，卸载它并从 F-Droid 获取正确版本：https://f-droid.org/en/packages/com.termux/

一旦你让 Termux 运行起来，我们需要设置基本环境：

1
2
3
4
5
6
7
8
#更改源（你可能需要这个）
termux-change-repo

# 更新包列表
pkg update && pkg upgrade

# 安装 Node.js（Claude Code 基于 Node.js 构建）
pkg install nodejs

注意 npm 与 Node.js 绑定在一起，所以你不需要单独安装它。我应该提到 Claude Code 需要 Node.js 18 或更高版本。Termux 包管理器自带的版本应该可以正常工作，但如果遇到任何问题，这是首先要检查的。

安装 Claude Code

现在下载 Claude Code

1
2
3
4
5
# 全局安装 Claude Code
npm install -g @anthropic-ai/claude-code

# 验证安装是否正确
claude -v

就这样。说真的，如果你之前用过 npm，这完全符合你的期望。根据你的网络连接情况，安装可能需要几分钟时间，但没有什么复杂的。

安装完成后，你可以立即启动 Claude Code：

1
2
# 启动 Claude Code - 这应该可以立即工作
claude

如果你不想使用 Claude 自己的服务，可以使用 router 代替。否则，Claude Code 会通过 Anthropic 的控制台自动处理身份验证，并以交互方式指导你完成任何必要的设置步骤。个人感觉 这个价格 还可以。

设置 Claude Code Router

这里开始变得有趣了。Claude Code Router 是一个社区项目，为 Claude Code 添加了强大的模型切换功能。它允许你将不同类型的请求路由到不同的 AI 模型——例如，对简单任务使用快速的本地模型，对复杂推理使用强大的云端模型。

首先，让我们安装 Claude Code Router：

1
2
# 安装 Claude Code Router
npm install -g @musistudio/claude-code-router

魔法发生在配置文件中。创建目录和配置文件：

1
2
3
4
5
# 创建配置目录
mkdir -p ~/.claude-code-router

# 创建你的配置文件
nano ~/.claude-code-router/config.json

根据 GitHub 文档 (https://github.com/musistudio/claude-code-router)，这里是一个将不同类型任务路由到不同模型的基本配置：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
{
  "LOG": true,
  "API_TIMEOUT_MS": 600000,
  "Providers": [
    {
      "name": "openrouter", 
      "api_base_url": "https://openrouter.ai/api/v1/chat/completions",
      "api_key": "sk-your-openrouter-key",
      "models": [
        "anthropic/claude-4-sonnet",
        "google/gemini-2.5-pro-preview"
      ],
      "transformer": {
        "use": ["openrouter"]
      }
    },
    {
      "name": "deepseek",
      "api_base_url": "https://api.deepseek.com/chat/completions", 
      "api_key": "sk-your-deepseek-key",
      "models": ["deepseek-chat", "deepseek-reasoner"],
      "transformer": {
        "use": ["deepseek"]
      }
    }
  ],
  "Router": {
    "default": "deepseek,deepseek-chat",
    "background": "deepseek,deepseek-chat", 
    "think": "deepseek,deepseek-reasoner",
    "longContext": "openrouter,google/gemini-2.5-pro-preview"
  }
}

这个配置做了几件聪明的事情：

  • 对一般任务使用 DeepSeek 的经济实惠模型
  • 将推理密集型任务路由到 DeepSeek 的推理模型
  • 对长上下文任务使用 Gemini Pro（如分析大型代码库）
  • 记录所有内容，这样你可以看到发生了什么

现在使用 router 启动 Claude Code：

1
2
# 使用 router 启动 Claude Code（如果没启动八成是因为json有问题）
ccr code

你也可以使用斜杠命令动态切换模型：

1
2
# 在会话期间切换到特定模型
/model openrouter,anthropic/claude-3.5-sonnet

实际使用示例

一旦所有设置完成，在 Termux 中使用 Claude Code 感觉出人意料地自然。以下是我如何使用它的一些实际示例：

基础代码协助：

1
2
3
4
5
6
# 请求 Claude 帮助解决编程问题
claude
> 帮我优化这个 Python 函数以获得更好的性能

# 或者直接分析文件
> /read my_script.py and suggest improvements

针对不同任务的模型切换：

1
2
3
4
5
6
7
# 对复杂问题使用推理模型
/model deepseek,deepseek-reasoner
> 规划分布式系统的架构

# 对简单编辑切换到快速模型
/model deepseek,deepseek-chat  
> 修复这段代码中的语法错误

长上下文分析：

1
2
# router 会自动对大文件使用 Gemini Pro
> /read large_codebase/ and create a summary

这个设置的美妙之处在于 Claude Code Router 在幕后处理复杂性。当你处理简单任务时，它使用经济实惠的模型。当你需要强大的推理能力或需要处理大量代码时，它会自动路由到更强大的模型。

提示和故障排除

性能：在我的手机上，即使对于较大的代码库，Claude Code 也运行得很流畅。响应时间更多取决于你的网络连接和使用的模型，而不是 Termux 本身。

存储：注意存储使用情况。Node.js 模块和日志会随时间累积。你可以这样清理：

1
2
3
4
5
# 如需要可清理 npm 缓存
npm cache clean --force

# 查看 router 日志
tail ~/.claude-code-router.log

重启 router：如果你修改了配置，记得重启：

1
ccr restart

最后的想法

在 Termux 中设置 Claude Code 与 Claude Code Router 比我预期的要简单得多。拥有一个可以在不同模型之间智能路由的 AI 编程助手——全部在我的手机上运行——感觉像是窥见了移动开发的未来。

虽然它不会取代完整的开发设置，但对于许多编程任务来说出人意料地强大。老实说，在 Android 上原生运行如此级别的 AI 助手确实令人满足。