折腾 AI 的开始

今年 3 月，“小龙虾”突然火了起来。手上刚好有一台淘来的 Mac，我便产生了用它做 AI 助手的想法。

一开始，我安装了 OpenClaw，配置了 Kimi 的 API，又接入飞书机器人，实现了远程截图并发送到手机等简单功能。东西确实跑起来了，但实际用了一段时间后，总觉得不太符合自己的使用习惯，于是这台 Mac 又闲置了下来。

直到后来 Claude Code 越来越火，而我也确实需要一个能帮我操作电脑、处理实际任务的 AI，才重新开始认真折腾这些工具。

Claude Code 和 Codex 是我使用得比较多的两个 AI 编程工具。后来因为 Codex 提供了更方便的桌面端，我逐渐把使用重心转到了 Codex 上。

Claude Code 是什么

Claude Code 是 Anthropic 推出的一款代理式 AI 编码工具。它可以在终端中运行，也能集成到 VS Code、JetBrains 等开发环境中。

与普通聊天机器人不同，Claude Code 可以在获得许可后读取项目文件、修改代码、运行命令，并根据执行结果继续完成任务。简单来说，它不只是告诉你代码应该怎么写，而是可以直接参与到整个项目中。

Claude Code 默认面向 Claude 模型和 Anthropic 官方服务。考虑到访问、价格和使用习惯，我选择保留 Claude Code 的操作方式，再通过第三方配置工具接入 其他模型。

这里接入的是第三方模型服务，实际能力、价格、上下文长度和稳定性由模型提供商决定，并不等同于使用 Anthropic 官方 Claude 服务。

安装 Claude Code CLI

1. 准备 Node.js 和 Git

首先需要安装 Node.js。

打开 Node.js 官网，根据自己的系统下载安装包，建议选择长期支持版，也就是 LTS 版本。

安装结束后，打开终端或命令提示符，依次输入：

node -v
npm -v

如果两条命令都能显示版本号，说明 Node.js 和 npm 已经可以正常使用。

接下来安装 Git。打开 Git 官网，下载对应系统的安装包。

安装完成后输入：

git --version

如果能够正常显示 Git 的版本号，就说明安装成功了。

Windows 用户安装 Git 时，通常保持默认选项一路继续即可。macOS 用户可以使用系统已有的 Git，也可以通过 Homebrew 安装。

2. 可选：切换 npm 国内镜像

如果使用 npm 下载软件包时速度比较慢，可以切换国内镜像：

npm config set registry https://registry.npmmirror.com/

如果官方 npm 源能够正常访问，这一步也可以直接跳过。

3. 安装 Claude Code

准备工作完成后，通过 npm 全局安装 Claude Code：

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

安装结束后输入：

claude --version

如果终端能够显示 Claude Code 的版本号，说明安装已经完成。

如果提示找不到 claude 命令，可以先关闭并重新打开终端。如果还是无法识别，再检查 npm 的全局安装目录是否已经加入系统的 PATH 环境变量。

4. 完成首次启动设置

在终端中输入以下命令启动 Claude Code：

claude

如果无法连接 Anthropic 官方服务，首次启动可能会停在登录或引导步骤。

在用户目录中找到 .claude.json 文件，并在原有配置中加入以下字段：

"hasCompletedOnboarding": true

不同系统中的文件位置通常如下：

• Windows：C:/Users/你的用户名/.claude.json
• macOS 和 Linux：~/.claude.json

Windows 用户如果找不到这个文件，需要先在资源管理器中开启“显示隐藏的项目”。

不要直接覆盖 .claude.json 中原来的内容。添加新字段时，要检查前一个字段末尾是否有英文逗号，否则可能会因为 JSON 格式错误导致 Claude Code 无法启动。

使用 CC Switch 接入 DeepSeek

1. 安装 CC Switch

CC Switch 是一个第三方配置管理工具，可以集中管理 Claude Code、Codex 等客户端使用的模型服务商，并在不同配置之间快速切换。

它的主要作用是帮助我们跳过登录验证，管理模型接口和客户端配置

打开 CC Switch Releases 页面，根据自己的操作系统下载对应的安装包并安装。

下载前建议确认 GitHub 仓库地址和发布者，尽量不要从不明网站获取安装包。

2. 创建 DeepSeek API Key

登录 DeepSeek 开放平台，进入 API Keys 页面，新建一个密钥。

名称可以填写 Claude Code，方便以后区分这个密钥的用途。

密钥通常只会完整显示一次，创建之后要立即复制并妥善保存。同时，还要确认 DeepSeek 账户中有可用余额。

API Key 相当于账户密码。不要把它放进截图、博客文章、公开仓库或聊天记录中。如果怀疑密钥已经泄露，应立即删除旧密钥并重新生成。

3. 在 CC Switch 中添加 DeepSeek

打开 CC Switch，进入 Claude Code 的服务商管理页面，点击添加服务商，然后选择 DeepSeek 预设。

填写以下内容：

1. 服务商名称：DeepSeek
2. API Key：粘贴刚刚创建的密钥
3. API 端点：https://api.deepseek.com/anthropic
4. API 格式：Anthropic Messages
5. 认证字段：ANTHROPIC_AUTH_TOKEN

DeepSeek 预设一般会自动填入接口地址和部分基础配置，但仍然建议逐项检查。

其中最重要的是确认使用了 Anthropic 兼容端点，而不是普通的 OpenAI 兼容端点。

4. 设置模型映射

Claude Code 会区分主模型，以及 Haiku、Sonnet、Opus 等模型槽。

将这些位置全部映射成下面这个模型：

deepseek-v4-pro[1m]

也就是说，主模型、Haiku 默认模型、Sonnet 默认模型和 Opus 默认模型都填写相同的 DeepSeek 模型名称，然后写入通用配置并保存。

模型名称、套餐和上下文规格可能会随着平台更新而发生变化。这里记录的是视频发布时的配置。如果 DeepSeek 控制台或 CC Switch 已经显示了新的模型 ID，应以当前平台实际提供的名称为准。

5. 启用配置并进行验证

保存服务商后，在 CC Switch 中启用 DeepSeek 配置。

重新打开终端，然后启动 Claude Code：

claude

进入 Claude Code 后，可以输入下面的命令查看或者切换当前模型：

/model

如果模型列表中能够看到刚刚配置的 DeepSeek 模型，说明 CC Switch 的配置已经被 Claude Code 读取。

第一次测试时，建议先创建一个单独的测试文件夹，再让 Claude Code 执行一个只读任务。例如：

请检查当前目录，并只告诉我你能看到哪些文件，不要修改任何内容。

确认文件读取、模型对话和 API 计费都正常后，再逐步尝试创建文件、修改代码或者运行命令。

不要一开始就在个人主目录、系统目录，或者存放重要文件的文件夹中进行测试。

视频参考

这一部分主要参考了 Yin_Code 发布的 Bilibili 视频《5分钟安装ClaudeCode并接入DeepSeek》。

Codex 是什么

Codex 是 OpenAI 推出的编程智能体，可以帮助用户理解代码、修改文件、审查问题、运行命令，并在项目中持续完成多步骤任务。

它和 Claude Code 的定位比较接近，但产品形态有所不同。除了命令行和开发环境中的使用方式，Codex 还提供了独立桌面端。对我来说，桌面端更容易管理任务和查看进度，也更符合日常使用习惯，这也是我后来逐渐把重心移到 Codex 的主要原因。

Codex 可以通过 ChatGPT 账号使用，并属于 OpenAI 的产品体系，但它本身仍然是面向软件开发工作的编程智能体。

安装 Codex 桌面端

打开 OpenAI Codex 官方页面，根据自己的操作系统下载 Codex 桌面端安装包。

下载完成后打开安装程序，按照提示完成安装即可。不同系统的安装界面可能略有区别，应以官方下载页面当时提供的版本为准。

第一次打开 Codex 时，界面会提供 ChatGPT 账号和 API 等登录方式。如果能够正常使用 OpenAI 官方服务，可以直接按照官方流程登录；这篇文章记录的则是通过 CC Switch 接入 DeepSeek 的方法。

通过 CC Switch 为 Codex 接入 DeepSeek

CC Switch 的安装方法、DeepSeek API Key 的创建和密钥安全注意事项，上文已经写过，这里不再重复。已经完成 Claude Code 配置的读者，可以直接复用现有的 CC Switch 和 DeepSeek 账户。

1. 添加 DeepSeek 服务商

打开 CC Switch，切换到 Codex 的服务商管理页面，点击添加服务商并选择 DeepSeek。粘贴上文创建的 API Key，并检查 API 地址：

https://api.deepseek.com

如果界面字段或预设内容出现不同，应以当前版本的 CC Switch 和 DeepSeek 平台为准。

2. 开启请求转换

Codex 默认使用 OpenAI 的 Responses 请求格式，而 DeepSeek 等第三方模型通常提供的是另一套兼容接口。两边直接连接时，可能出现请求格式不一致的问题。

在 CC Switch 的 DeepSeek 服务商设置中开启请求转换功能后，CC Switch 会在本地帮助转换请求，让 Codex 可以通过当前配置调用 DeepSeek。

这是 Codex 配置与上文 Claude Code 配置最明显的不同。只填写 API Key 和接口地址还不够，请求转换没有开启时，Codex 可能无法正常获得回复。

3. 开启本地路由

进入 CC Switch 设置，找到本地路由相关选项：

1. 开启在主界面显示本地路由开关。
2. 开启本地路由功能。
3. 在需要接入的客户端中选择 Codex。
4. 返回服务商列表，启用刚刚添加的 DeepSeek 配置。

设置完成后，主界面会显示本地路由已经启动。由于客户端需要重新读取配置，接下来要完全退出并重新打开 Codex。

4. 重启 Codex 并验证

重新打开 Codex 后，新建一个测试任务。第一次可以使用不修改文件的简单问题，例如：

请告诉我当前文件夹中有哪些文件，不要修改任何内容。

如果 Codex 能够正常回复，并且 DeepSeek 控制台中出现相应的 API 调用记录，就说明本地路由和模型配置已经生效。

第一次测试仍然建议使用单独的空文件夹。确认读取、对话和计费都正常后，再让它操作真实项目。

Codex 视频参考

Codex 这一部分主要参考了林粒粒呀发布的 Bilibili 视频《小白速通 Codex 安装 + 国产大模型接入，无需 ChatGPT 订阅，国内直连 DeepSeek》。

软件更新后，按钮位置和选项名称可能发生变化，但整体思路是不变的

从尝试工具，到真正用起来

回头来看，我最初只是想利用那台闲置的 Mac，做一个能远程执行简单任务的 AI 助手。后来从 OpenClaw 到 Claude Code，再到现在更常用的 Codex，工具和模型一直在变化，我的需求也一直在变化：从与 AI 的简单聊天，到真的能够参与电脑上的工作，再到帮我实现一些奇思妙想。

这一路的配置过程并不总是顺利，中间也遇到过登录、接口、模型和请求格式等问题。但把这些问题一个个解决之后，我对 AI 助手能做什么、不能做什么，也有了更实际的认识。

这篇文章记录的是我目前使用过的方案。以后如果工具、模型或者配置方式发生变化，我也会继续尝试，并把新的过程记录下来。