用 ZCode 一键安装 Codex、Claude Code、OpenCode，并接入按量付费 DeepSeek 实战教程

关键词：ZCode 3.0、Codex 安装、Claude Code 安装、OpenCode 安装、DeepSeek V4 按量付费、Coding Agent、CLI 编程工具、GLM-5.2

---

目录

• 一、为什么用 ZCode 装这些工具
• 二、准备工作
• 三、安装 ZCode 3.0
• 四、用 ZCode 一键安装 Codex
• 五、用 ZCode 一键安装 Claude Code
• 六、用 ZCode 一键安装 OpenCode
• 七、配置按量付费的 DeepSeek V4
• 八、三个工具的实测对比
• 九、常见问题 FAQ
• 十、总结

---

一、为什么用 ZCode 装这些工具

如果你和我一样，想把 Codex（OpenAI 出品）、Claude Code（Anthropic 出品）、OpenCode 这几个主流 CLI 编程 Agent 都在本地装好用来对比用，传统的做法是：

• 自己去装 Node.js（版本还要对）
• 自己处理 Python 虚拟环境
• 一个一个工具去 GitHub 克隆仓库
• 处理各种 PATH、API Key 配置、依赖冲突
• 装完一个，再装下一个，重复劳动

这一套下来，没个半天搞不定，而且经常会遇到各种报错。ZCode 3.0 是智谱 AI 在 2026 年 6 月 13 日与 GLM-5.2 同日发布的编程 Agent 工具，它自带 “AI 工具链一键安装” 功能，可以把上面三个工具一次性装好，整个过程我实测下来不到 30 分钟。

这篇教程就把整个过程完整记录下来，包括最后如何把三个工具统一接入 DeepSeek V4，实现"一套 API Key 跑遍三个 CLI 工具"。

---

二、准备工作

在开始之前，确认你的环境满足以下条件：

项目	要求	说明
操作系统	Windows 10/11、macOS 12+、Ubuntu 20.04+	三平台都支持
网络	可访问智谱 BigModel 平台	安装时需要下载模型工具链
硬盘空间	至少 5GB 可用	三个工具 + 依赖
内存	建议 8GB 以上	同时跑多个 Agent 时更流畅
账号	DeepSeek 开放平台账号	用于申请 API Key（按量付费）

---

三、安装 ZCode 3.0

3.1 下载客户端

前往 ZCode 官网下载对应系统的安装包：

系统	安装包
Windows	ZCode-Setup-x64.exe
macOS（Apple Silicon）	ZCode-x.x.x-arm64.dmg
macOS（Intel）	ZCode-x.x.x-x64.dmg
Linux	ZCode-x.x.x.AppImage 或 .deb

3.2 安装并登录

按提示完成安装，启动后使用手机号或邮箱注册登录。新用户可享受连续 4 天免费 GLM-5.2 token（每天 150W），正好够你把下面这套安装流程跑一遍。

[截图位置 1：ZCode 主界面，建议截完整的左侧栏 + 对话框界面]

---

四、用 ZCode 一键安装 Codex

Codex 是 OpenAI 推出的命令行编程 Agent，适合处理代码生成、Bug 修复、重构等任务。

4.1 在 ZCode 中发起安装

在 ZCode 对话框中直接输入：

帮我安装 Codex CLI

4.2 ZCode 自动执行的过程

ZCode 会自动：

1. 检测本机 Node.js 环境（如果版本不够会自动升级）
2. 从 OpenAI 官方源拉取 Codex CLI
3. 配置全局 PATH
4. 验证安装结果

整个过程不需要你手动干预，类似下面的执行流：

> 检查 Node.js 环境... ✓ v20.11.0
> 下载 Codex CLI... ✓
> 安装到全局路径... ✓ /usr/local/bin/codex
> 验证安装... ✓ codex 1.2.3
> 安装完成！

[截图位置 2：ZCode 安装 Codex 的执行过程]

4.3 验证安装

打开终端，输入：

codex --version

如果返回类似 codex 1.2.3 的版本号，说明安装成功。

---

五、用 ZCode 一键安装 Claude Code

Claude Code 是 Anthropic 推出的命令行编程 Agent，基于 Claude 系列模型，在代码理解和长任务上表现稳定。

5.1 在 ZCode 中发起安装

继续在 ZCode 对话框里说：

帮我安装 Claude Code

5.2 ZCode 自动执行的过程

> 检查依赖环境... ✓
> 拉取 Claude Code 安装包... ✓
> 配置 API 端点... ✓
> 创建快捷命令... ✓ claude
> 安装完成！

[截图位置 3：ZCode 安装 Claude Code 的执行过程]

5.3 验证安装

claude --version

如果返回版本号，说明安装成功。

💡 提示：ZCode 安装 Claude Code 时，会自动生成一个 ~/.claude/ 配置目录，里面已经预留好 API Key 的占位符，等会儿接入 DeepSeek 时直接填进去即可。

---

六、用 ZCode 一键安装 OpenCode

OpenCode 是开源社区维护的 CLI 编程 Agent，支持多种模型后端，灵活度很高。

6.1 在 ZCode 中发起安装

帮我安装 OpenCode

6.2 ZCode 自动执行的过程

> 检测 Go 环境... ✓
> 克隆 OpenCode 仓库... ✓
> 编译二进制... ✓
> 安装到全局路径... ✓
> 安装完成！

[截图位置 4：ZCode 安装 OpenCode 的执行过程]

6.3 验证安装

opencode --version

---

七、配置 DeepSeek V4

三个工具装好了，现在统一接入 DeepSeek V4（按量付费）。这样做的最大好处是：

• 一个 API Key 跑三个工具
• 按 Token 用量付费，不用包月
• DeepSeek V4 在代码能力上已经非常接近 Claude 系列，性价比很高

7.1 申请 DeepSeek V4 API Key

第一步：注册 DeepSeek 开放平台账号

打开 https://platform.deepseek.com/，使用手机号或邮箱注册。

第二步：充值（按量付费先充值后使用）

进入「账户中心」→「充值」，建议先充个 10-50 元试用。DeepSeek V4 的价格：

模型	输入价格	输出价格
DeepSeek V4	$0.27/M tokens	$1.10/M tokens
DeepSeek V4 Pro	$0.44/M tokens（已含 75% 折扣）	$0.87/M tokens（已含 75% 折扣）

📅 注意：DeepSeek V4 正式版将于 2026 年 7 月 15 日 全量上线，届时价格和性能都会有进一步调整。

第三步：创建 API Key

进入「API Keys」页面，点击「创建新 Key」，命名后保存：

名称：ZCode-Agent
权限：全部

复制生成的 Key（只会显示一次，请妥善保存），类似这样：

sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

[截图位置 5：DeepSeek 平台 API Key 创建成功页面]

7.2 接入 Codex

编辑 Codex 配置文件 ~/.codex/config.yaml：

api_base: https://api.deepseek.com/v1
api_key: sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
model: deepseek-v4

[截图位置 6：Codex 的 config.yaml 配置]

7.3 接入 Claude Code

编辑 ~/.claude/settings.json：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/v1",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "deepseek-v4"
  }
}

[截图位置 7：Claude Code 的 settings.json 配置]

7.4 接入 OpenCode

编辑 ~/.opencode/config.json：

{
  "provider": {
    "name": "deepseek",
    "apiBase": "https://api.deepseek.com/v1",
    "apiKey": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "models": {
      "default": "deepseek-v4"
    }
  }
}

[截图位置 8：OpenCode 的 config.json 配置]

7.5 三个工具的连通性测试

分别运行以下命令，确认三个工具都能正常调用 DeepSeek V4：

# Codex
codex "用 Python 写一个快速排序"

# Claude Code
claude "用 Python 写一个归并排序"

# OpenCode
opencode "用 Python 写一个堆排序"

如果三个工具都能正常返回代码，说明配置全部成功。

[截图位置 9：三个工具同时调用 DeepSeek V4 的对比截图]

---

八、三个工具的实测对比

装好之后，我用同一个任务（“用 Python 实现一个 LRU 缓存”）在三个工具上做了对比，结果如下：

维度	Codex	Claude Code	OpenCode
首次响应速度	快	中	中
代码正确率	高	高	中（需要二次确认）
注释完整度	中	详细	简洁
异常处理	一般	完善	基础
Token 消耗	较少	较多	较少
适合场景	快速生成代码片段	复杂逻辑、长任务	自定义工作流

个人结论：日常写小工具用 Codex，需要深度推理的复杂任务用 Claude Code，喜欢折腾自定义流程的用 OpenCode。接 DeepSeek V4 后，三者的性价比都拉满了。

[截图位置 10：三个工具完成同一任务的结果对比]

---

九、常见问题 FAQ

Q1：ZCode 安装工具链失败怎么办？

A：检查网络是否能访问外网，部分地区需要配置代理。如果持续失败，可以手动安装：

# Codex
npm install -g @openai/codex

# Claude Code
npm install -g @anthropic-ai/claude-code

# OpenCode
go install github.com/opencode-ai/opencode@latest

Q2：DeepSeek V4 报 401 错误？

A：检查 API Key 是否正确复制（注意没有多余空格），账户余额是否充足。

Q3：Claude Code 接 DeepSeek 后报错？

A：因为 DeepSeek API 兼容 OpenAI 格式，而 Claude Code 默认走 Anthropic 协议，所以必须通过环境变量 ANTHROPIC_BASE_URL 重定向到 DeepSeek 的端点，否则会调到 Anthropic 官方接口导致鉴权失败。

Q4：OpenCode 找不到命令？

A：检查 GOPATH/bin 是否在 PATH 里：

echo $PATH | grep -i go

如果没有，把 export PATH=$PATH:$(go env GOPATH)/bin 加到 ~/.bashrc 或 ~/.zshrc。

Q5：能同时跑多个工具吗？

A：可以，但不建议超过 3 个 Agent 同时跑长任务，否则 Token 消耗会非常快。

---

十、总结

用 ZCode 3.0 一键安装 Codex、Claude Code、OpenCode，再统一接入 按量付费的 DeepSeek V4，整套流程下来：

• ✅ 安装时间：不到 10 分钟
• ✅ 配置工作量：每个工具 5 行配置
• ✅ 成本：DeepSeek V4 按量付费，1 块钱能跑很多任务
• ✅ 灵活性：三个工具随时切换，对比测试非常方便

ZCode 的价值不在于它本身是个多强的编程 Agent，而在于它把"装环境、配依赖、跑工具"这些最脏最累的活全包了，让我们可以专注在真正重要的事情上——用 AI 写好代码。

一句话总结：ZCode 是程序员的"工具链管家"——装得快、接得顺、用得省心。

---

本文基于 2026 年 7 月实操撰写，所有步骤在 Windows 11 + macOS Sonoma 双平台验证通过。如有更新以官方文档为准。