CC Switch 目录配置详解:如何自定义 Claude、Codex、Gemini 配置目录

SEO关键词

CC Switch目录配置、CC Switch教程、Codex配置目录、Claude Code配置目录、Gemini CLI配置、CC Switch使用教程、Codex客户端下载、CC Switch下载、AI编程工具配置、CC Switch个性化设置


在这里插入图片描述

下载地址

软件 下载地址
Codex客户端 https://codexdown.cn/
CC Switch https://pan.quark.cn/s/f7bdbc4d3619

大家好 这里是「代码简单说」,欢迎大家关注同名公众号,不定时更新更多实用有趣的教程 也欢迎大家在评论区一起讨论交流!~

在使用 CC Switch 管理多个 AI 编程工具时,很多用户都会遇到一个问题:

  • 配置文件存放在哪里?
  • 如何修改 Codex 配置目录?
  • Claude Code 和 Gemini CLI 能否放到其他磁盘?
  • 多个开发环境如何隔离配置?

实际上,CC Switch 已经提供了完整的目录自定义功能,可以根据自己的开发环境灵活调整各类 AI CLI 工具的配置路径。

本文带大家详细了解 CC Switch 的目录配置功能。


什么是目录配置

CC Switch 会统一管理多个 AI CLI 工具的配置文件、认证信息以及相关数据。

默认情况下,这些数据都会保存在用户目录下。

例如:

~/.codex/
~/.claude/
~/.gemini/

如果你有以下需求:

  • 系统盘空间不足
  • 多套开发环境隔离
  • 公司项目与个人项目分离
  • 配置同步到云盘

那么就可以通过目录配置功能进行自定义。


应用配置目录

CC Switch 本身的数据默认保存在:

~/.cc-switch/

该目录主要包含:

  • 供应商配置
  • 模型映射
  • 本地路由配置
  • 会话数据
  • 应用设置

默认位置:

Windows
C:\Users\用户名\.cc-switch\

macOS
~/.cc-switch/

Linux
~/.cc-switch/

一般情况下不建议频繁修改。


CLI 工具目录配置

CC Switch 支持为不同 AI CLI 工具指定独立配置目录。

支持如下工具:

配置项 默认目录 说明
Claude目录 ~/.claude/ Claude Code配置目录
Codex目录 ~/.codex/ Codex配置目录
Gemini目录 ~/.gemini/ Gemini CLI配置目录
OpenCode目录 ~/.opencode/ OpenCode配置目录
OpenClaw目录 ~/.openclaw/ OpenClaw配置目录

为什么要修改配置目录

场景一:系统盘空间不足

很多用户的配置文件、缓存和日志会持续增长。

例如:

C盘:
└── Users
    └── xxx
        └── .codex

可以迁移到:

D:\AI\Codex

减轻系统盘压力。


场景二:多账号隔离

例如:

D:\Work\Codex
D:\Personal\Codex

不同项目使用不同配置。

避免:

  • API Key 混用
  • 会话记录混用
  • MCP 配置冲突

场景三:开发环境统一管理

很多开发者会创建:

D:\AI-Workspace\

统一存放:

Claude
Codex
Gemini
OpenCode
OpenClaw

目录结构:

D:\AI-Workspace
├── Claude
├── Codex
├── Gemini
├── OpenCode
└── OpenClaw

管理起来更加清晰。


修改目录后的注意事项

这里有一个非常容易踩坑的地方。

官方特别说明:

修改目录后需要重启应用,且对应的 CLI 工具也需要配置相同的目录。

也就是说:

假设你将 Codex 目录修改为:

D:\AI\Codex

那么:

CC Switch

需要配置:

D:\AI\Codex

Codex CLI

也必须使用:

D:\AI\Codex

否则会出现:

  • 登录状态丢失
  • 无法读取配置
  • MCP失效
  • 模型配置异常

等问题。


推荐目录规划方案

如果你经常使用多个 AI 编程工具,推荐如下结构:

D:\AI-Tools
│
├── CC-Switch
├── Claude
├── Codex
├── Gemini
├── OpenCode
└── OpenClaw

对应配置:

工具 配置目录
CC Switch D:\AI-Tools\CC-Switch
Claude D:\AI-Tools\Claude
Codex D:\AI-Tools\Codex
Gemini D:\AI-Tools\Gemini
OpenCode D:\AI-Tools\OpenCode
OpenClaw D:\AI-Tools\OpenClaw

这样后续迁移电脑、备份配置都会非常方便。


CC Switch 的优势

相比单独配置各种 AI CLI 工具:

  • Claude Code
  • Codex
  • Gemini CLI
  • OpenCode
  • OpenClaw

CC Switch 可以统一管理:

  • API供应商
  • 本地路由
  • 模型映射
  • MCP服务
  • CLI配置目录

大幅降低维护成本。

尤其对于同时使用多个 AI 编程工具的开发者来说,体验提升非常明显。


总结

CC Switch 提供了灵活的目录配置功能,允许用户自定义 Claude、Codex、Gemini、OpenCode、OpenClaw 等工具的配置目录。

对于需要:

  • 多账号管理
  • 多环境隔离
  • 配置迁移
  • 系统盘瘦身

的开发者来说,这项功能非常实用。

需要注意的是,修改目录后一定要重启 CC Switch,并确保对应 CLI 工具使用相同的配置路径,否则可能出现配置读取异常的问题。

Logo

汇聚全球AI编程工具,助力开发者即刻编程。

更多推荐