Claude Code / Codex 使用 CC-Switch 配置 API Key 和 base_url 教程

01 背景

现在很多 AI 编程工具都可以直接在终端里使用，例如 Claude Code 和 Codex。

这类工具好用的前提是模型连接稳定。实际配置时，经常会遇到这些问题：

不同模型服务商的 API Key 不一样
不同服务商的 base_url 不一样
模型名 model 不一样
终端环境变量没有刷新
Claude Code 能用，但 Codex 不能用
切换模型时需要改多个配置文件

CC-Switch 解决的就是这类问题：把模型供应商、API Key、base_url、model 集中管理，再让终端工具读取当前生效的配置。

02 工具说明

本文用到三个工具：

工具	作用
CC-Switch	统一管理模型供应商配置
Claude Code	Anthropic 方向的终端 AI 编程工具
Codex	OpenAI 方向的终端 AI 编程工具

为什么选择 Claude Code 和 Codex？

因为它们分别代表两类常见终端 AI 编程入口：一个偏 Anthropic 生态，一个偏 OpenAI 生态。只要这两个工具能跑通，后面再接入其他终端 AI 工具，配置思路基本一致。

03 安装 CC-Switch

项目地址：

github.com/farion1231/...

打开 GitHub Releases 页面，根据自己的系统下载对应安装包：

Windows：优先找 .exe 或 Windows 对应压缩包
macOS：优先找 .dmg
Linux：按发行版选择 .AppImage、.deb 或 .rpm

安装完成后，先打开一次 CC-Switch，确认能看到配置界面。

04 安装 Claude Code 和 Codex

Claude Code 和 Codex 都建议优先参考官方文档。

macOS / Linux / WSL 可以使用官方安装脚本：

bash 复制代码

curl -fsSL https://claude.ai/install.sh | bash
claude --version
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

Windows 用户需要额外注意：

Claude Code 可以使用 PowerShell 安装脚本
Codex 建议查看 OpenAI Windows setup 文档
PowerShell、CMD、Git Bash、WSL2 的环境变量可能不互通
在哪个终端里启动工具，就在哪个终端里验证配置

05 配置 API Key、base_url 和 model

在 CC-Switch 中新增模型配置时，重点填写以下字段：

配置项	说明	示例
profile name	配置名称，给自己识别用	`deepseek-code`
provider	模型服务商类型	OpenAI Compatible
API Key	服务商控制台生成的密钥	`sk-xxxx`
base_url	API 接口地址	`https://api.example.com/v1`
model	默认模型名	`deepseek-chat`

配置名称建议写清楚，不要使用 test、new、api1 这类无法识别用途的名字。

推荐命名：

deepseek-code

openai-main

company-proxy-claude

qwen-work

注意：截图时不要暴露完整 API Key。如果要展示真实配置，建议只保留前 4 位和后 4 位。

06 切换配置并重新打开终端

保存配置之后，还需要把它切换成当前生效的 profile。

这里有一个常见坑：配置已经在 CC-Switch 中切换了，但当前终端仍然读取旧环境变量。

建议按这个顺序验证：

在 CC-Switch 中切换当前 profile
关闭当前终端
重新打开终端
启动 Claude Code 或 Codex
用一个最小问题测试模型是否可用

不要在旧终端里反复测试，否则很容易误判为 API Key 或 base_url 配错。

07 验证 Claude Code

进入项目目录，启动 Claude Code：

bash 复制代码

claude

建议先问一个最小问题：

总结当前项目目录结构。

如果能正常返回，说明至少以下链路是通的：

Claude Code 启动正常
API Key 可用
base_url 可访问
model 名称可用

如果失败，优先检查：

ANTHROPIC_API_KEY
ANTHROPIC_BASE_URL
ANTHROPIC_MODEL
当前终端是否重新打开

08 验证 Codex

进入项目目录，启动 Codex：

bash 复制代码

codex

建议先问：

读取当前目录，告诉我这个项目主要模块是什么。

如果 Claude Code 能用，但 Codex 不能用，不要直接改 API Key。先检查 Codex 自己的配置优先级，尤其是：

命令行参数
用户配置
项目配置
~/.codex/config.toml
当前终端环境变量

09 常见问题

现象	优先检查
API Key invalid	Key 是否复制完整、是否过期
model not found	模型名是否和服务商文档一致
connection failed	base_url 是否正确、网络是否可达
切换后没变化	是否重新打开终端
Claude Code 能用，Codex 不能用	检查 Codex 配置优先级

10 总结

使用 Claude Code 和 Codex 这类终端 AI 编程工具时，最容易出问题的不是工具本身，而是模型连接配置。

CC-Switch 的价值在于把 API Key、base_url、model 统一管理起来。配置清楚之后，后续切换模型、排查错误、接入其他终端工具都会简单很多。

参考资料：

CC-Switch：github.com/farion1231/...
Claude Code Setup：docs.anthropic.com/en/docs/cla...
Claude Code Settings：docs.anthropic.com/en/docs/cla...
Codex Documentation：developers.openai.com/codex/
Codex Windows Setup：developers.openai.com/codex/windo...