从0到1的全流程教程,一步步保姆喂饭级搭建并使用 ClaudeCode 和 Codex,助你畅蹬 AI。
在 AI 横行的时代,本篇文档依然坚持全部手撸,此时时间 2026-8-2 02:56,不知不觉写了好几个小时了,又把夜给熬穿了😴。打个广告:本人搭建的 AI 中转站 https://api.sove.top 欢迎来蹬🥳
一、全流程文件资源下载
整个过程需要用到的所有安装包资源:
夸克网盘:
链接:https://pan.quark.cn/s/986757b309aa?pwd=kwfs
提取码:kwfs
百度云:
链接: https://pan.baidu.com/s/1NOySTEj9jaVnZurx57EIpA?pwd=aiai
提取码: aiai
本资源来源均为官网和官方 github 仓库,可能存在版本不是最新的问题,有科学上网手段的朋友可以自行去官网或者官方 github 仓库中下载。
本教程可能涉及的官网和仓库地址:
GPT 官网:https://chatgpt.com
Codex 官网:https://chatgpt.com/codex
CCSwitch 官网:https://github.com/farion1231/cc-switch
ClashVergeRev 官网:https://github.com/clash-verge-rev/clash-verge-rev
Claude 官网:https://claude.com
Skills 官网:https://skills.sh
Node 官网:https://nodejs.org
Git 官网:https://git-scm.com
AI 中转官网:https://api.sove.top
部分工具简称:
- cc → ClaudeCode
- ccs → CCSwitch
二、最基础的 NodeJS + Git 环境搭建
NodeJS:是最基础的环境,必须安装!
Git:如果想玩AI编程,强烈建议安装!
安装包在网盘中,或者官网自行下载安装。
三、Clash 安装
科学上网的必备神器,如果想访问 github 等网站,这是必备的工具。
由于相关描述涉及敏感,此处不做详情说明,如有不懂可以加群问。
如果只是想先走完本篇教程的整体流程,该步骤可忽略。
安装包在网盘中,或者官网自行下载安装。
四、ClaudeCode / Codex 的安装
ClaudeCode 和 Codex 我强力推荐使用命令行工具的形式,若实在适应不了,也有对应的桌面版程序。
ClaudeCode 和 Codex 一般选一个即可,我个人现在比较喜欢 ClaudeCode,虽然我曾经也是 Codex 的狂热粉丝,但是 Codex 对 windows 系统的兼容性实在令我无语,其实 ClaudeCode 蛮好的。
1.1 ClaudeCode 命令行工具的安装
首先打开你电脑自带的命令行工具,运行下列命令:
运行 npm 命令安装 ClaudeCode(因为之前安装好了 node 环境,所以可以直接使用 npm 指令)
npm install -g @anthropic-ai/claude-code
有的朋友可能安装的较慢,那是因为国内可能网络受限,有必要时可以让 npm 先切换至国内镜像源,如果上一步直接安装成功,则可忽略以下换源的操作
npm config set registry https://registry.npmmirror.com
可以再运行
npm config get registry 来检测是否换源成功,若控制台打印 https://registry.npmmirror.com 则说明换源成功,然后再运行第一步的 npm 命令安装 ClaudeCode 即可。安装完成之后,控制台运行
claude 即可启动 ClaudeCode:首次在一个文件夹启动后,需要询问是否信任此文件夹,选择 Yes 回车即可。
这里必须要说明一下,在某个文件夹启动,就代表当前工作区主要在这个文件夹内部,后续产出或修改的文件一般都在这个工作区里,所以在进行工作的时候一定要指定工作区文件夹。
有的同学会问:咦?为什么我界面和你的不一样?为什么我需要认证登录?
那是因为你还没有配置 ClaudeCode 的账号(供应商),下面我们会进行 CCSwitch 的安装以及 ClaudeCode 供应商的配置。
1.2 Codex 命令行工具的安装
首先打开你电脑自带的命令行工具,运行下列命令:
运行 npm 命令安装 Codex(因为之前安装好了 node 环境,所以可以直接使用 npm 指令)
npm install -g @openai/codex
有的朋友可能安装的较慢,那是因为国内可能网络受限,有必要时可以让 npm 先切换至国内镜像源,如果上一步直接安装成功,则可忽略以下换源的操作
npm config set registry https://registry.npmmirror.com
可以再运行
npm config get registry 来检测是否换源成功,若控制台打印 https://registry.npmmirror.com 则说明换源成功,然后再运行第一步的 npm 命令安装 ClaudeCode 即可。安装完成之后,控制台运行
codex 即可启动 Codex:首次在一个文件夹启动后,需要询问是否信任此文件夹,选择 Yes 回车即可。
这里必须要说明一下,在某个文件夹启动,就代表当前工作区主要在这个文件夹内部,后续产出或修改的文件一般都在这个工作区里,所以在进行工作的时候一定要指定工作区文件夹。
有的同学会问:咦?为什么我界面和你的不一样?为什么我需要认证登录?
那是因为你还没有配置 OpenAI 的账号(供应商),下面我们会进行 CCSwitch 的安装以及 OpenAI 供应商的配置。
1.3 ClaudeCode / Codex 桌面端应用程序
如果实在不习惯命令行的使用方式,也可以选择安装对应的桌面端应用程序。
ClaudeCode Desktop 下载地址:https://claude.com/product/claude-code
Codex(ChatGPT) Desktop 下载地址:https://openai.com/zh-Hans-CN/codex
对于 Codex(ChatGPT) 桌面版,windows系统也可以直接在微软商店搜索下载:
注意:
- 现在可能没有单独的 Codex 桌面版了,现在统称为 ChatGPT 桌面版,但是不用怀疑,这个就是最新的 Codex 桌面版。
- ClaudeCode 桌面版对中文不友好,不能直接设置中文。
- 如果非要在这两个桌面版中选一个的话,我个人推荐 Codex(ChatGPT) 桌面版。
- 两者看自己喜好下载安装使用。
当然下载之后是不能直接打开使用的,如果直接打开会提示你登录账号,我们当然没有账号,接下来我们需要通过 CCSwitch 去添加我们自己的账号。
ClaudeCode 桌面版预览:
Codex(ChatGPT) 桌面版预览:
还有一个类似于桌面端的使用方式,我个人觉得还蛮好用的,比 ClaudeCode 桌面端好用多了,喜欢使用 VSCode 的同学,可以直接插件市场搜索 claude,一般第一个就是,作者是 A社官方 Anthropic,不要安装错了:
安装成功之后,点击 VSCode 右上角 Claude 图标即可:
当然下载安装之后是不能直接打开使用的,需要根据以下步骤配置 ClaudeCode 供应商。
五、CCSwitch 安装与配置
这是统一管理 AI Agent 配置的必备工具,必须安装!这一章节也是本篇教程的重头戏!
由于不同版本的 CCSwitch 可能存在界面略微有改动的情况,但是整体功能大差不差。
CCSwtch 官方 github 仓库地址:https://github.com/farion1231/cc-switch
这是引入眼帘的首页,也是我们最频繁操作的位置,关键功能如图红框所示。
1.1 首先进行设置
先别管其他功能,先把基础设置调整好再说,无脑跟着我的设置模仿,只设置通用配置,其他不管。
1.2 新增 ClaudeCode 供应商
ClaudeCode 供应商,说白话就是 Claude 的账号,这个账号不需要你自己科学上网去 Claude 官网注册然后使用国外银行卡花美元订阅套餐,因为你花美元订阅,忙活到最终不过也是为了获取一个 API 密钥。
这里我们不需要这些繁琐的步骤,而是一步到位直接将站点创建的 API 密钥填入,即可直接创建 Claude 账号并使用。
选择 ClaudeCode 之后点击右上角加号
默认 Claude 供应商自定义配置,然后填写信息即可,无脑跟着我填
注意:
- 官网连接和请求地址一定不要填错,官网地址可以不填,请求地址填站点的域名:https://api.sove.top
- Claude 供应商的请求地址不要加任何后缀,包括斜杠 /
- 应用通用配置勾选之后,Claude 供应商配置会统一引用配置,例如给 ClaudeCode 配置自动压缩上下文
- 认知说明:ClaudeCode 只是一个底层的 AI Agent 框架,也就是所谓的 Harness,并不代表它必须跑 Claude 的模型,它也可以跑任何其他模型,包括且不限于 GPT 相关模型、国产模型等等,由于 Claude 模型本身比较贵虽然它确实编码能力极其优秀,但奈何财力不足,我个人还是建议跑 GPT 模型,性价比高真香。
编辑通用配置推荐:
最主要的就是:”CLAUDE_CODE_AUTO_COMPACT_WINDOW”: “200000”,其含义是上下文达到 200k 时自动压缩。可复制文本如下:
{
"env": {
"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "200000",
"DISABLE_TELEMETRY": "1",
"DISABLE_COST_WARNINGS": "1",
"DISABLE_AUTOUPDATER": "1",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
}
}
可扩展的一些其他配置如下(可选,觉得不重要的可以忽略):
{
"enabledPlugins": {
"superpowers@claude-plugins-official": true
},
"env": {
"CLAUDE_CODE_AUTO_COMPACT_WINDOW": "200000",
"DISABLE_TELEMETRY": "1",
"DISABLE_COST_WARNINGS": "1",
"DISABLE_AUTOUPDATER": "1",
"CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
},
"hooks": {
"Notification": [
{
"hooks": [
{
"command": "powershell -c \"[console]::beep(800,300)\"",
"type": "command"
}
],
"matcher": ""
}
]
},
"skipWebFetchPreflight": true
}
解释:
- “superpowers@claude-plugins-official”: true,是开启 superpowers 的整体工作流,如果你不清楚可以不填
- “hooks”: {…},这部分是给 ClaudeCode 加上一个提示音,在任务完成的时候发出提示音
- “skipWebFetchPreflight”: true,是为了解决 ClaudeCode 进行 Fetch 时报错的问题
- 其他配置可看 ClaudeCode 文档(可能需要科学上网):https://code.claude.com/docs/zh-CN/env-vars
配置完成之后,别忘了点击启用,然后就可以去 ClaudeCode 中使用了。
调出命令行窗口,输入
claude 即可,快去试试吧~供应商可以配置多个,如果某一个供应商出现问题,可以随时切换另一个,只要模型相同,不妨碍任务继续进行。
1.3 新增 Codex 供应商
Codex 供应商,说白话就是 Codex(OpenAI) 的账号,这个账号不需要你自己科学上网去 OpenAI 官网注册然后使用国外银行卡花美元订阅套餐,因为你花美元订阅,忙活到最终不过也是为了获取一个 API 密钥。
这里我们不需要这些繁琐的步骤,而是一步到位直接将站点创建的 API 密钥填入,即可直接创建 OpenAI 账号并使用。
选择 Codex 之后点击右上角加号
同样的 Codex 供应商,默认自定义配置:
注意:
- 官网连接和 API 请求地址一定不要填错,官网地址可以不填,API 请求地址填站点的域名,且一定要加后缀 /v1,如:https://api.sove.top/v1,这里要注意区别于之前的 ClaudeCode 的地址配置。
- 应用通用配置勾选之后,Codex 供应商配置会统一引用配置。
- 认知说明:Codex 只是一个底层的 AI Agent 框架,也就是所谓的 Harness,并不代表它必须跑 GPT 的模型,它也可以跑任何其他模型,包括且不限于 Claude 相关模型、国产模型等等,当然 GPT 模型本身就足够优秀,不跑 GPT 模型还能跑啥呢,便宜又强才是真的香。
编辑通用配置推荐:
可复制文本如下:
model_reasoning_effort = "high"
disable_response_storage = true
sandbox_mode = "workspace-write"
[windows]
sandbox = "unelevated"
[plugins."superpowers@openai-api-curated"]
enabled = true
说明:
- sandbox_mode 有三个可选项:read-only 只读、workspace-write 读写当前工作区、danger-full-access 高风险不设约束。
- windows 电脑下才有的配置:sandbox 项默认为 “elevated”,该模式下比较安全,但是权限会受限,导致 Codex 更加频繁地请求授权,我个人喜欢设置成 “unelevated”,看个人喜好。
- [plugins.”superpowers@openai-api-curated”] 为开启 superpowers 工作模式,不了解或不喜欢的可以不开。
配置完成之后,别忘了点击启用,然后就可以去 Codex 中使用了。
调出命令行窗口,输入 codex 即可,快去试试吧~
供应商可以配置多个,如果某一个供应商出现问题,可以随时切换另一个,只要模型相同,不妨碍任务继续进行。
1.4 桌面端如何新增供应商
Codex 桌面端无需进行额外操作,上述新增 Codex 供应商的步骤,直接囊括了命令行版本和桌面端版本,无需进行其他配置即可直接通用。
VSCode 中的 Claude Code for VS Code 插件也无需进行额外操作,上述新增 ClaudeCode 供应商的步骤,直接囊括了命令行版本和 VSCode 插件版本,无需进行其他配置即可直接通用,如果你要问为什么,请你去 CCSwitch 的设置中寻找答案。
答案如下:
下面主要介绍如何开启 ClaudeCode 桌面端的供应商配置:
首先需要打开 CCSwitch 设置中的路由开关
然后开启通用中的 Claude Desktop
最后在点击上方 Claude Desktop,此时页面会显示是否同步导入 ClaudeCode 中的供应商配置,选择是,并且开启左上角路由开关即可:
到此,所有基础工作环境已搭建完成,你已经可以让 AI 跑起来了。🥳🥳🥳🎉🎉🎉
六、AI 技术篇
1.1 AI 不聪明?那是因为你还没有给它安装上 Skills
你如果总是吐槽 AI 为什么喜欢乱发挥,那多半是因为你还在让 AI “裸奔”。
想让 AI 变得更专业,你需要给它套上 “缰绳”,给予束缚力和专业性,这就是 Skills,也就是 AI 的知识库,AI 的技能,让 AI 在工作时有法可依。
Skills 官网:https://skills.sh
自行搜索你想要安装的 Skills,每个人的工作需求不同,本人也不方便做出推荐,可以加群讨论。
在此处我只介绍如何安装 Skills,前提是需要开启科学上网,且要开启 clash 的 tun 模式,这是控制台连接上 github 的基础。
打开 Skills 官网,找自己想要安装的 Skills:
选择要安装的 Skills,点进去,复制下载安装命令
命令行输入该命令
直接回车即可
依旧直接回车,此处默认勾选了 ClaudeCode,但是无关紧要,我们最终都是要通过 CCSwitch 进行 SKills 的统一管理的。
一定要选择 Global,直接安装在全局,不要选择单独项目安装,没有必要,无脑全局就行了,一切交给 CCSwitch 统一管理。
后续全都无脑回车,一直到安装完成。
然后去 CCSwitch 中的 Skills 管理:
选择导入已有:
可以选择需要点亮的工具,我只使用 ClaudeCode 和 Codex,然后确认导入已选即可:
这就安装成功了,Skills 在需要用到的时候,AI 会自行按需使用,而不是每次都一股脑把你的 SKills 全部加载一遍,所以尽可放心。
要想让 AI 变得和你自己本人处理工作的风格一样,那就自己搭建一套专属于自己的知识库工作流 Skills 咯。
啥?你不会写 Skills?那肯定指挥 AI 去写啊。
有一个 skill-creator:https://www.skills.sh/anthropics/skills/skill-creator
这是 Claude 官方出品的专门用来创作自己 Skills 的 Skills,快安装上再和 AI 对话让它帮你制作吧。
制作好了自己的 Skills 之后怎么安装?
只需要把你写好的本地 Skills 放到这个文件夹里就行了:
然后在 CCSwitch 中导入已有,一样的步骤:
1.2 AI 工作流方法论?和 Skills 有什么区别?
想让 AI 以一套完整的工作流进行高质量工作,仅靠几个 Skills 可不行,这就诞生了一整套完整且闭环的 Skills 套件,也就是所谓的工作流方法论,比较火热的有 superpowers、grill-me、karpathy-guidelines、everything-claude-code 等等。
安装方式:直接去对应的 github 仓库查看安装步骤即可,有些甚至已经被 ClaudeCode 或 Codex 官方插件市场收录了,直接插件市场也可以搜索安装。
输入指令:
/plugins 并回车即可,然后在该插件市场中搜索并安装。有可能出现搜索不到的情况,因为网络环境可能需要科学上网并开启 tun 模式进行代理,所以还是建议去对应的 github 仓库查看安装步骤,跟着进行安装。
1.3 如何恢复上次的聊天记录?
直接在 ClaudeCode 或 Codex 中输入指令
/resume 即可,自行选择。或者直接在 CCSwitch 的会话管理中恢复:
点击复制恢复会话的命令:
直接命令行输入并回车即可:
1.4 上下文太多了,怎么压缩?
命令
/compact 并回车当然过短的上下文没必要压缩时会压缩失败。
建议使用 ClaudeCode 的同学可以看上述的 CCSwitch 中配置自动压缩的步骤,不用手动压缩,省心。
使用 Codex 的同学没有像 ClaudeCodex 那样的自动压缩配置,因为 Codex 本身就自带超出上下文限制自动压缩。
1.5 未完待续,持续跟新…
© 版权声明
文章版权归作者所有,未经允许请勿转载。
THE END



暂无评论内容