AI编程CLI两种配置方案（macOS专用）

文章目录

- 方案一：CC-Switch自动配置（推荐，一键切换多模型）
- - [1. 前置确认](#1. 前置确认)
  - [2. 接入DeepSeek完整配置步骤](#2. 接入DeepSeek完整配置步骤)
  - [3. 切换&验证生效](#3. 切换&验证生效)
  - [4. 托盘快捷切换](#4. 托盘快捷切换)
- 方案二：手动原生配置（不使用CC-Switch，仅单模型固定）
- - [一、Claude Code 手动配置（macOS）](#一、Claude Code 手动配置（macOS）)
  - 二、Codex（OpenAI协议工具）手动配置
  - [三、Gemini CLI 手动配置](#三、Gemini CLI 手动配置)
- 三、两种配置方式对比
- 四、常见报错排查

方案一：CC-Switch自动配置（推荐，一键切换多模型）

CC-Switch会自动读写各CLI的配置文件，不用手动改JSON，适配DeepSeek、Claude、Kimi、GLM等所有模型。

1. 前置确认

已装好 Node.js + claude-code / codex / gemini-cli
装好CC-Switch，拿到DeepSeek API Key（platform.deepseek.com）

2. 接入DeepSeek完整配置步骤

打开CC-Switch，顶部切换标签（以Claude Code为例）
右上角 + 添加供应商 ，预设列表直接选 DeepSeek
填入你的DeepSeek API Key，模型下拉选 deepseek-v4-flash
底部点「添加」保存配置
顶部齿轮「设置」→ 打开路由总开关、Claude路由开关（必须开，否则调用失败）
返回列表，点击DeepSeek条目右侧启用，软件自动写入 ~/.claude/settings.json

3. 切换&验证生效

彻底关闭所有终端、VS Code，重新打开
校验命令：

bash 复制代码

claude status

输出出现 api.deepseek.com、deepseek-v4-flash 即配置成功。

4. 托盘快捷切换

窗口最小化后，mac顶部菜单栏右键CC-Switch图标，可直接切换所有已保存模型。

方案二：手动原生配置（不使用CC-Switch，仅单模型固定）

一、Claude Code 手动配置（macOS）

配置文件路径：~/.claude/settings.json

bash 复制代码

mkdir -p ~/.claude

编辑配置文件

bash 复制代码

nano ~/.claude/settings.json

粘贴DeepSeek标准配置（替换你的Key）：

json 复制代码

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

保存：Ctrl+O → 回车 → Ctrl+X

重启终端，执行 claude chat 测试

二、Codex（OpenAI协议工具）手动配置

路径：~/.openai/settings.json

json 复制代码

{
  "apiKey": "sk-xxx",
  "baseUrl": "https://api.deepseek.com/v1",
  "model": "deepseek-v4-flash"
}

三、Gemini CLI 手动配置

bash 复制代码

# 终端临时配置（重启失效）
export GOOGLE_API_KEY="xxx"
# 永久写入zsh配置
echo 'export GOOGLE_API_KEY="xxx"' >> ~/.zshrc
source ~/.zshrc

三、两种配置方式对比

对比项	CC-Switch自动配置	手动JSON/环境变量
多模型切换	一键切换，保存多套密钥	手动改文件，只能存一套
配置文件	软件自动读写，无语法错误风险	容易JSON格式报错
国内模型适配	内置DeepSeek/GLM/Kimi预设	全部参数手动填写
路由代理	自带本地路由，兼容OpenAI/Anthropic双协议	需自己配代理
多工具统一管理	Claude/Codex/Gemini一套面板管理	每个工具单独配置

四、常见报错排查

切换后模型不变
关闭全部终端窗口，清空缓存；CC-Switch内重新启用供应商
鉴权401报错
API Key不要带空格；DeepSeek预设不要手动修改BaseURL
路由调用失败
CC-Switch设置页打开对应工具路由开关；不要同时手动写环境变量（环境变量优先级高于配置文件）
macOS权限不足
安装npm全局工具时执行修复权限命令：

bash 复制代码

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