一键部署 Claude Code + Gemini CLI + Codex CLI 开发环境 + 配置恢复。
提供两种环境管理方案,功能等价,按需选用:
| 方案 | 脚本 | 环境管理 | 体积 | 适用场景 |
|---|---|---|---|---|
| conda 版 | restore.sh |
Anaconda/Miniconda | ~500MB+ | 通用 Linux/macOS, 需要独立 Python + Node.js 环境 |
| uv 版 | restore_uv.sh |
uv + venv | ~20MB + Node.js | NVIDIA 容器, 已有系统 Python, 追求轻量 |
git clone https://github.com/haozhengwan/claude_code_settings.git
cd claude_code_settings
bash restore.sh
# 启动: conda activate claudegit clone https://github.com/haozhengwan/claude_code_settings.git
cd claude_code_settings
bash restore_uv.sh
# CLI 工具直接可用 (已在系统 PATH), 无需激活
# 如需 Python 环境: source ~/.venv/claude/bin/activate脚本会按顺序完成:
- 系统检查 — 安装 curl/wget/git 等基础工具
- 环境安装 — conda (conda 版) 或 uv + venv + Node.js (uv 版)
- Claude Code CLI —
npm install -g @anthropic-ai/claude-code - Gemini CLI —
npm install -g @google/gemini-cli - Codex CLI —
npm install -g @openai/codex - GitHub 认证 — git + gh CLI + SSH 配置
- API Key 配置 — 交互式创建
.env文件 (支持 Claude/Gemini/Codex 三种 key) - 环境变量加载 — 从
.env加载并验证配置 - 配置恢复 — settings.json + keybindings.json
- 插件自动安装 — 命令行自动安装 7 个 Claude Code 插件
├── config/ # 配置文件
│ ├── settings.json # 全局设置 (插件, 权限, 主题)
│ └── keybindings.json # 键盘快捷键
├── plugins/ # 插件信息
│ ├── installed_plugins.json # 已安装插件列表
│ ├── known_marketplaces.json# 市场源地址
│ └── plugin-list.md # 插件详细说明
├── .env.example # API Key 模板 (可安全提交)
├── .env # 你的真实 API Key (gitignore 已排除)
├── restore.sh # conda 版一键部署脚本
├── restore_uv.sh # uv 版一键部署脚本 (轻量, 推荐容器使用)
├── MANIFEST.md # 完整文件清单
├── .gitignore
└── README.md # 本文件
# 自定义 venv 目录
VENV_DIR=~/.venv/claude-ai bash restore_uv.sh
# 自定义 Node.js / Python 版本
NODE_VERSION=22 PYTHON_VERSION=3.13 bash restore_uv.sh
# 自定义 Node.js 安装路径
NODE_INSTALL_PREFIX=/usr/local bash restore_uv.sh
# GitHub 下载/克隆较慢时启用代理
GITHUB_PROXY_URL=https://ghproxy.net bash restore_uv.sh
# 或: GH_PROXY_URL=https://ghproxy.com bash restore_uv.sh| 变量 | 默认值 | 说明 |
|---|---|---|
VENV_DIR |
~/.venv/claude |
Python 虚拟环境路径 |
NODE_VERSION |
20 |
Node.js 版本 (20 LTS) |
PYTHON_VERSION |
3.12 |
Python 版本 (uv 可自动下载) |
NODE_INSTALL_PREFIX |
/usr/local |
Node.js 安装路径 (无 root 时回退到 ~/.local) |
GITHUB_PROXY_URL / GH_PROXY_URL |
(空) | GitHub 代理前缀, 如 https://ghproxy.net, 用于 uv 版 gh Release 下载、Gemini 扩展和 Claude marketplace 克隆 |
# 自定义 conda 安装路径
CONDA_INSTALL_DIR=/opt/anaconda3 bash restore.sh
# 自定义 conda 环境名 / Node 版本 / Python 版本
CONDA_ENV_NAME=myenv NODE_VERSION=22 PYTHON_VERSION=3.13 bash restore.sh| 变量 | 默认值 | 说明 |
|---|---|---|
CONDA_INSTALL_DIR |
~/anaconda3 |
conda 安装路径 |
CONDA_ENV_NAME |
claude |
conda 环境名 |
NODE_VERSION |
20 |
Node.js 版本 |
PYTHON_VERSION |
3.12 |
Python 版本 |
# 使用自己的 DeepSeek API key
ANTHROPIC_AUTH_TOKEN=sk-your-deepseek-key bash restore.sh
# 或者使用其他 Anthropic 兼容 API
ANTHROPIC_BASE_URL=https://your-proxy.com/anthropic \
ANTHROPIC_AUTH_TOKEN=your-key \
ANTHROPIC_MODEL=your-model \
bash restore.sh| 变量 | 默认值 | 说明 |
|---|---|---|
ANTHROPIC_BASE_URL |
https://api.deepseek.com/anthropic |
Anthropic 兼容 API 地址 |
ANTHROPIC_AUTH_TOKEN |
(空) | API 认证 Token |
ANTHROPIC_MODEL |
deepseek-v4-pro[1m] |
默认模型 |
ANTHROPIC_DEFAULT_OPUS_MODEL |
deepseek-v4-pro[1m] |
Opus 级别模型 |
ANTHROPIC_DEFAULT_SONNET_MODEL |
deepseek-v4-pro[1m] |
Sonnet 级别模型 |
ANTHROPIC_DEFAULT_HAIKU_MODEL |
deepseek-v4-flash |
Haiku 级别模型 |
CLAUDE_CODE_SUBAGENT_MODEL |
deepseek-v4-flash |
Subagent 使用的模型 |
默认使用浏览器 OAuth 登录,无需 API Key。 首次运行 gemini 时会自动打开浏览器完成认证。
如需使用 API Key 方式:
GEMINI_AUTH_METHOD=api_key GEMINI_API_KEY=your-key bash restore.sh| 变量 | 默认值 | 说明 |
|---|---|---|
GEMINI_AUTH_METHOD |
login |
认证方式: login (浏览器OAuth) 或 api_key |
GEMINI_API_KEY |
(空) | Gemini API Key (获取) |
默认使用浏览器 OAuth 登录,无需 API Key。 首次运行 codex 时会自动打开浏览器完成认证。
如需使用 API Key 方式:
CODEX_AUTH_METHOD=api_key OPENAI_API_KEY=your-key bash restore.sh| 变量 | 默认值 | 说明 |
|---|---|---|
CODEX_AUTH_METHOD |
login |
认证方式: login (浏览器OAuth) 或 api_key |
OPENAI_API_KEY |
(空) | OpenAI API Key (获取) |
ANTHROPIC_AUTH_TOKEN=sk-deepseek-xxx \
bash restore.sh
bash restore.sh运行脚本后会自动生成 .env.example,内容如下:
# ---- Claude Code (Anthropic 兼容 API) ----
ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
ANTHROPIC_AUTH_TOKEN=your-deepseek-api-key-here
ANTHROPIC_MODEL=deepseek-v4-pro[1m]
ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
# ---- GitHub 认证 ----
GITHUB_TOKEN=your-github-token-here
# ---- GitHub 下载代理 (可选, uv 版) ----
# GITHUB_PROXY_URL=https://ghproxy.net
# ---- Gemini CLI (默认浏览器 OAuth 登录, 无需 API Key) ----
GEMINI_AUTH_METHOD=login
# GEMINI_API_KEY=your-gemini-api-key-here
# ---- Codex CLI (默认浏览器 OAuth 登录, 无需 API Key) ----
CODEX_AUTH_METHOD=login
# OPENAI_API_KEY=your-openai-api-key-here复制并填入真实 key:
cp .env.example .env
vim .env脚本为三个 CLI 各自安装扩展/插件,功能互不重叠:
| 插件 | 市场 | 版本 | 说明 |
|---|---|---|---|
| superpowers | claude-plugins-official | 5.1.0 | 系统化开发方法论 (brainstorming → TDD → review → 收尾) |
| code-review | claude-plugins-official | - | 代码审查 |
| github | claude-plugins-official | - | GitHub 集成 (PR/Issue) |
| skill-creator | claude-plugins-official | - | 创建自定义技能 |
| pua | pua-skills | 3.4.6 | PUA 高效工作流 (13 种企业文化风格) |
| oh-my-claudecode | omc | 4.14.4 | 增强工具集 (30+ MCP 工具, 32+ Agent 类型) |
| claude-hud | claude-hud | 0.1.0 | 终端状态栏 (模型/token/session) |
Marketplace 源:
| 市场 | 来源 |
|---|---|
| claude-plugins-official | anthropics/claude-plugins-official |
| pua-skills | tanweai/pua |
| omc | Yeachan-Heo/oh-my-claudecode |
| claude-hud | jarrodwatts/claude-hud |
| 扩展 | 来源 | 说明 |
|---|---|---|
| superpowers | obra/superpowers |
14 个开发工作流技能 (brainstorming, TDD, debugging, code review 等) |
# 手动安装命令 (脚本已自动执行)
gemini extensions install https://github.com/obra/superpowers| 插件 | 来源 | 说明 |
|---|---|---|
| superpowers | OpenAI 官方市场 | 14 个开发工作流技能 |
# 进入 Codex 交互界面后手动操作
codex
/plugins # 打开插件搜索
# → 搜索 "superpowers" → 点击 Install
⚠️ Codex 插件必须通过交互界面安装,无法命令行自动化。 Superpowers 项目: github.com/obra/superpowers
如果已有 Claude Code 环境 (conda 或 uv 版均可),只想恢复配置:
# 手动复制
cp config/settings.json ~/.claude/
cp config/keybindings.json ~/.claude/conda activate claude
claude # Claude Code
gemini # Gemini CLI
codex # Codex CLICLI 工具已安装在系统 PATH,无需激活任何环境即可使用:
claude # Claude Code
gemini # Gemini CLI
codex # Codex CLI如需 Python 虚拟环境:
source ~/.venv/claude/bin/activate # 或自定义的 VENV_DIR插件已自动安装并加载,无需手动操作。如需重新加载插件:
/plugin reload
如果 .env 已配置好,每次使用前快速加载:
# conda 版
source .env && conda activate claude
# uv 版
source .env- Linux (x86_64/aarch64) 或 macOS
- 网络连接
- 脚本会自动安装: curl, wget, git, Miniconda, Node.js, Claude Code CLI, Gemini CLI, Codex CLI
- Linux (x86_64/aarch64)
- 网络连接
- 脚本会自动安装: curl, wget, git, xz-utils, uv, Python venv, Node.js, Claude Code CLI, Gemini CLI, Codex CLI