本地 AI 工具矩阵：分工、配置与踩坑实录

本机工具盘点

截至 2026-08-17，Mac 上常驻的 AI 工具如下。版本号是当时实测的值，分工见下一节。

工具	版本 / 模型	状态	备注
Cursor CLI	3.16.17	主力	官方账号积分制；复杂工程、多文件协作首选
Codex CLI	0.147.0 · deepseek-v4-pro	✅ 2026-08-17 修好	走 DeepSeek 官方 API（responses 协议）
Claude Code	2.1.144 · glm-5.1	✅ 2026-08-17 修好	智谱 Anthropic 兼容端点
Qwen CLI	—	未登录	备用，尚未接入日常流
Ollama	qwen2.5:7b · qwen2.5vl:3b	本地可用	断网 / 私密场景；视觉模型 qwen2.5vl:3b
Hermes	v0.20.0 · deepseek-v4-flash	日常编排	轻量问答、会话调度、与 Agent 联研
Trae CN / WorkBuddy	桌面 GUI	辅助	图形界面入口，非 CLI 主力

分工矩阵

不是「哪个最强」，而是「什么场景用哪个」——省积分、保上下文、能断网，各取所长。

场景	选用工具	理由
复杂工程、多仓库、IDE 深度集成	Cursor	Agent 能力强、上下文管理好；积分贵，留给硬仗
单仓库轻量编码、脚本修补、省积分	Codex CLI	终端内快速改代码；DeepSeek 按量计费，成本低
长文档分析、方案推演、知识体系梳理	Claude Code	长上下文 + tool_use 稳；glm-5.1 经实测可用
本地私密、断网、敏感草稿	Ollama	数据不出本机；7B 级模型够用做草稿
日常问答、会话编排、轻量调度	Hermes	CLI 会话管理成熟；flash 模型响应快

一句话：Cursor 打硬仗，Codex 省着干，Claude Code 啃长文，Ollama 保私密，Hermes 管日常。

Codex CLI 配置实录（3 个坑）

目标：让 Codex 0.147.0 连上可用模型，在终端里写代码并跑通测试。下面三个坑按遇到顺序排列。

坑 1：新版只认 responses 协议，智谱走不通

Codex 新版本移除了 wire_api = "chat"，只支持 responses 协议。我最初想继续用智谱官方 API，实测其端点没有 /responses 路径——请求直接 404。

结论智谱官方 API 与新版 Codex 不兼容。不要在这条路子上浪费时间。

坑 2：改走 DeepSeek，models.json 要手动补 metadata

DeepSeek 官方 API 支持 /responses 端点，实测连通。模型选用 deepseek-v4-pro（专业推理编程向）。配置自定义 provider 后，若 ~/.codex/models.json 里缺少该模型的 metadata，启动时会报警告——需要手动补上条目，警告才消失。

# ~/.codex/config.toml 核心片段（示意） [model_providers.deepseek] name = "DeepSeek" base_url = "https://api.deepseek.com" env_key = "DEEPSEEK_API_KEY" [profiles.deepseek] model_provider = "deepseek" model = "deepseek-v4-pro"

注意：config.toml 里 http_headers 内嵌 API Key 不生效。Codex 自定义 provider 只认 env_key 指向的环境变量。

坑 3：.zshrc 只在交互式 shell 生效

把 DEEPSEEK_API_KEY 写在 ~/.zshrc 后，在普通终端里 codex 能用，但从脚本、TUI 或非交互环境启动时读不到 Key——表现像「没配密钥」。

解法：把 export 写到 ~/.zshenv。.zshenv 在所有 zsh 模式（交互 / 非交互）都会加载；.zshrc 仅交互式。

# ~/.zshenv export DEEPSEEK_API_KEY="sk-..."

Codex 修通标志 codex doctor 通过；端到端实跑：让 Codex 写归并排序并带单测，编译运行全绿。

Claude Code 修复实录（2 个坑）

目标：Claude Code 2.1.144 走国内可访问的 Anthropic 兼容端点，支持 messages + tool_use（后者是 Claude Code 能正常干活的硬条件）。

坑 1：端点选对、模型选对

智谱提供 Anthropic 兼容端点：https://open.bigmodel.cn/api/anthropic。实测支持 messages 接口和 tool_use——这是 Claude Code 能用的关键。

模型方面：glm-5.3 强制开启思考链，与 Claude Code 的工具调用流程冲突；改用 glm-5.1 后正常。

# 环境变量（写在 ~/.zshenv，与 Codex 同理） export ANTHROPIC_BASE_URL="https://open.bigmodel.cn/api/anthropic" export ANTHROPIC_AUTH_TOKEN="your-zhipu-api-key" export ANTHROPIC_MODEL="glm-5.1"

坑 2：settings.json 里的空 env 块覆盖一切（最大坑）

症状：请求返回 403 Request not allowed。开 debug 日志看到 has Authorization header: false——说明根本没带上认证头，不是 Key 错了，是 Key 根本没发出去。

根因：~/.claude/settings.json 里残留了一段 env 块，把 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 设成了空字符串。Claude Code 会优先读 settings 里的 env，空值覆盖掉 shell 环境变量。

修法删掉 settings.json 里的整个 env 块（或至少删掉那两个空字段），让程序回退到 ~/.zshenv 里的 export。删完立刻恢复，无需重启机器。

# 问题配置示例（不要留这种空值） { "env": { "ANTHROPIC_AUTH_TOKEN": "", "ANTHROPIC_BASE_URL": "" } }

Claude Code 修通标志 claude auth status 显示已认证；端到端实跑：写回文数函数并执行通过。

验证方法

配置改完不要凭感觉——用官方自检 + 端到端实跑两道关。

工具	自检命令	端到端实测
Codex CLI	`codex doctor`	写归并排序 + 单测，编译运行通过
Claude Code	`claude auth status`	写回文数函数，执行通过

额外建议：出 403 / 401 时先开 debug 看请求头有没有 Authorization，比反复换 Key 省时间。

一句收束工具矩阵靠分工，分工靠配置；配置靠可复核的命令和日志，不靠记忆。

以上均为 2026-08-17 本机实测记录。API 端点与模型可用性可能随厂商更新变化，以当日 doctor / auth status 为准。

Ivan · AI实践 · 返回 AI实践 · Ivan