写在前面国内用 AI 编程工具最难的往往不是命令本身而是账号、网络和稳定性这三件事。工具再强一旦中途断线、掉授权、卡额度开发节奏就会被直接打碎。这篇教程把 Claude Code、Codex、Gemini CLI 三条路放在一起讲目的很简单让你先跑通再谈体验。只要入口稳定后面无论是终端、桌面端还是 API 接入工作流都能顺下来。你会看到两种常见玩法一种是改版客户端装上就能用另一种是原版客户端配 API保留官方体验的同时把环境配置尽量收拢到最少。1. 方案概览这类国内使用方案核心就两种思路方案适合谁特点改版客户端新手用户想要简单上手安装即用、配置少、流程短原版 API高级用户想保留官方体验仍然是官方客户端只是把接口换成可用的国内入口两种方式的目标都一样尽量少折腾尽量别让网络和授权问题打断写代码的节奏。Claude Code 这条线怎么选如果你更在意“先跑起来”改版客户端会更省事典型优势就是安装后直接进主流程不需要你反复处理鉴权和 endpoint。如果你更在意“和官方保持一致”那就走原版 API。这样做的好处是后面无论是升级、切换模型还是和别的工具统一配置都更顺手。Codex 这条线怎么选Codex 现在已经不只是一个命令行工具而是能在 App、CLI、Web、IDE 里来回切换的一套工作流。你选它重点不在于“在哪打开”而在于“怎么让它持续接住任务”。Gemini CLI 这条线怎么选Gemini CLI 的思路更偏终端工具化适合已经习惯命令行的人。它的强项是轻量、直接、可脚本化适合做批量任务和快速验证。2. Claude Code 使用方案方案 A改版客户端这条路最适合想省事的人。核心逻辑很简单直接装改版客户端然后按提示完成绑定。安装命令通常长这样bashnpminstall-ghttps://code.ai80.vip/claudecode/install--registryhttps://registry.npmmirror.com启动时进入项目目录再拉起客户端即可bashcdyour-project-folder claude如果网络链路有问题常见做法是切换线路改版客户端的价值不在于花哨而在于把“能不能用”这件事先解决掉。只要能稳定进会话后面就是让它帮你干活。方案 B原版 API如果你更偏向官方客户端那就保留原版 Claude Code只把 API 入口换掉。先安装官方版本bashnpminstall-ganthropic-ai/claude-code如果之前装过改版先卸掉再来bashnpmuninstall-ganthropic-ai/claude-coderm-rf~/.claude*然后配置环境变量bashexportANTHROPIC_API_TOKENexportANTHROPIC_API_KEY你的api_keyexportANTHROPIC_BASE_URLhttps://code.ai80.vip/Windows 下可以用setx写入同样的变量。这样做的好处是你的主流程不用变变的只是入口。怎么判断这条路适不适合你想快选改版客户端想稳选原版 API想长期统一工作流选原版 API说白了改版客户端更像“开箱即用”原版 API 更像“把主干道修通”。3. Codex 安装与使用Codex 这部分也分两条路一条是改版安装一条是官方客户端 API。方案 A站内包授权版适合希望快速上手的人。安装命令如下bashnpminstall-ghttps://code.ai80.vip/codex/install启动后直接运行第一次运行通常会自动做几件事下载程序、完成登录、写入配置。只要这一步顺利后面基本就是持续使用。方案 B官方 Codex 客户端 API如果你想保留官方客户端可以直接改配置文件tomlprofilegac[model_providers.gac]namegacbase_urlhttps://code.ai80.vip/wire_apiresponsesenv_keyCODEX_API_KEY[profiles.gac]model_providergacmodelgpt-5model_reasoning_effortmediumapproval_policyon-request再把 API Key 配进去bashexportCODEX_API_KEY你的Key字符串这条路最关键的不是“多装了什么”而是“少改了什么”——原版客户端保留住了后面切模型、切权限、切工作流都更顺。Codex 里几个容易踩的点profile不写对启动后就找不到你想要的模型配置base_url不统一CLI、App、IDE 会各配各的后面很难维护环境变量写完没重启配置看着在实际上没生效4. Gemini CLI 安装和使用Gemini CLI 的玩法更直接核心就是装好 Node.js再拉起客户端。先检查环境bashnode--versionnpm--version然后安装bashnpminstall-ghttps://code.ai80.vip/gemini/install启动如果你想切模型可以这样写bashgemini --set-model gemini-3-pro-preview如果想恢复默认它的优点是很适合跑命令、跑脚本、做快速任务缺点是如果你更习惯图形界面刚开始可能会觉得信息密度太高。5. 这类官方工具到底值不值得用如果只看能力Claude Code、Codex、Gemini CLI 都已经不是“能不能写代码”的阶段了而是更像“你要不要把重复活交出去”。你真正要考虑的是三件事入口稳不稳工作流能不能持续出问题之后好不好排查官方路线的优势在于长期一致性更好国内入口的价值在于把落地门槛压下去。对大多数开发者来说先让工具稳定跑起来比纠结“最正宗的方式”更重要。官方订阅和费用怎么理解官方原版通常涉及订阅或按量计费具体以各自官方页面为准。真正要注意的是不要为了省一点时间在入口上反复折腾半天最后把工作流切碎了。不过说实话官方订阅和 API 在国内经常会卡在支付和网络上。如果你只想要一个更省事的入口可以把 API endpoint 直接统一到 Code80 这一类国内可用地址主程序基本不用改。常见问题1. 改版客户端和原版客户端最大区别是什么改版客户端更适合快速上线原版客户端更适合长期维护和统一工作流。2. 为什么总是提示登录失败通常是网络、账号状态或环境变量没生效。先重启终端再检查base_url和API_KEY。3. 这几套工具能不能共用一套配置可以。最关键的是把 endpoint 和 key 的管理统一起来不要每个工具都各写一遍。4. 国内用户怎么更省事地用上官方 API如果不想自己处理海外支付和网络问题可以直接把 endpoint 统一到 Code80 这类入口少掉很多中间步骤。5. 先学哪一个最好新手先学改版客户端熟悉后再切原版 API如果你主要写脚本Gemini CLI 也值得直接试。6. 这三套工具要一起装吗不用。先选一个跑通再按需要补第二个、第三个。
保姆级教程，快速在国内使用Claudecode、Codex！
发布时间：2026/6/7 1:18:07
写在前面国内用 AI 编程工具最难的往往不是命令本身而是账号、网络和稳定性这三件事。工具再强一旦中途断线、掉授权、卡额度开发节奏就会被直接打碎。这篇教程把 Claude Code、Codex、Gemini CLI 三条路放在一起讲目的很简单让你先跑通再谈体验。只要入口稳定后面无论是终端、桌面端还是 API 接入工作流都能顺下来。你会看到两种常见玩法一种是改版客户端装上就能用另一种是原版客户端配 API保留官方体验的同时把环境配置尽量收拢到最少。1. 方案概览这类国内使用方案核心就两种思路方案适合谁特点改版客户端新手用户想要简单上手安装即用、配置少、流程短原版 API高级用户想保留官方体验仍然是官方客户端只是把接口换成可用的国内入口两种方式的目标都一样尽量少折腾尽量别让网络和授权问题打断写代码的节奏。Claude Code 这条线怎么选如果你更在意“先跑起来”改版客户端会更省事典型优势就是安装后直接进主流程不需要你反复处理鉴权和 endpoint。如果你更在意“和官方保持一致”那就走原版 API。这样做的好处是后面无论是升级、切换模型还是和别的工具统一配置都更顺手。Codex 这条线怎么选Codex 现在已经不只是一个命令行工具而是能在 App、CLI、Web、IDE 里来回切换的一套工作流。你选它重点不在于“在哪打开”而在于“怎么让它持续接住任务”。Gemini CLI 这条线怎么选Gemini CLI 的思路更偏终端工具化适合已经习惯命令行的人。它的强项是轻量、直接、可脚本化适合做批量任务和快速验证。2. Claude Code 使用方案方案 A改版客户端这条路最适合想省事的人。核心逻辑很简单直接装改版客户端然后按提示完成绑定。安装命令通常长这样bashnpminstall-ghttps://code.ai80.vip/claudecode/install--registryhttps://registry.npmmirror.com启动时进入项目目录再拉起客户端即可bashcdyour-project-folder claude如果网络链路有问题常见做法是切换线路改版客户端的价值不在于花哨而在于把“能不能用”这件事先解决掉。只要能稳定进会话后面就是让它帮你干活。方案 B原版 API如果你更偏向官方客户端那就保留原版 Claude Code只把 API 入口换掉。先安装官方版本bashnpminstall-ganthropic-ai/claude-code如果之前装过改版先卸掉再来bashnpmuninstall-ganthropic-ai/claude-coderm-rf~/.claude*然后配置环境变量bashexportANTHROPIC_API_TOKENexportANTHROPIC_API_KEY你的api_keyexportANTHROPIC_BASE_URLhttps://code.ai80.vip/Windows 下可以用setx写入同样的变量。这样做的好处是你的主流程不用变变的只是入口。怎么判断这条路适不适合你想快选改版客户端想稳选原版 API想长期统一工作流选原版 API说白了改版客户端更像“开箱即用”原版 API 更像“把主干道修通”。3. Codex 安装与使用Codex 这部分也分两条路一条是改版安装一条是官方客户端 API。方案 A站内包授权版适合希望快速上手的人。安装命令如下bashnpminstall-ghttps://code.ai80.vip/codex/install启动后直接运行第一次运行通常会自动做几件事下载程序、完成登录、写入配置。只要这一步顺利后面基本就是持续使用。方案 B官方 Codex 客户端 API如果你想保留官方客户端可以直接改配置文件tomlprofilegac[model_providers.gac]namegacbase_urlhttps://code.ai80.vip/wire_apiresponsesenv_keyCODEX_API_KEY[profiles.gac]model_providergacmodelgpt-5model_reasoning_effortmediumapproval_policyon-request再把 API Key 配进去bashexportCODEX_API_KEY你的Key字符串这条路最关键的不是“多装了什么”而是“少改了什么”——原版客户端保留住了后面切模型、切权限、切工作流都更顺。Codex 里几个容易踩的点profile不写对启动后就找不到你想要的模型配置base_url不统一CLI、App、IDE 会各配各的后面很难维护环境变量写完没重启配置看着在实际上没生效4. Gemini CLI 安装和使用Gemini CLI 的玩法更直接核心就是装好 Node.js再拉起客户端。先检查环境bashnode--versionnpm--version然后安装bashnpminstall-ghttps://code.ai80.vip/gemini/install启动如果你想切模型可以这样写bashgemini --set-model gemini-3-pro-preview如果想恢复默认它的优点是很适合跑命令、跑脚本、做快速任务缺点是如果你更习惯图形界面刚开始可能会觉得信息密度太高。5. 这类官方工具到底值不值得用如果只看能力Claude Code、Codex、Gemini CLI 都已经不是“能不能写代码”的阶段了而是更像“你要不要把重复活交出去”。你真正要考虑的是三件事入口稳不稳工作流能不能持续出问题之后好不好排查官方路线的优势在于长期一致性更好国内入口的价值在于把落地门槛压下去。对大多数开发者来说先让工具稳定跑起来比纠结“最正宗的方式”更重要。官方订阅和费用怎么理解官方原版通常涉及订阅或按量计费具体以各自官方页面为准。真正要注意的是不要为了省一点时间在入口上反复折腾半天最后把工作流切碎了。不过说实话官方订阅和 API 在国内经常会卡在支付和网络上。如果你只想要一个更省事的入口可以把 API endpoint 直接统一到 Code80 这一类国内可用地址主程序基本不用改。常见问题1. 改版客户端和原版客户端最大区别是什么改版客户端更适合快速上线原版客户端更适合长期维护和统一工作流。2. 为什么总是提示登录失败通常是网络、账号状态或环境变量没生效。先重启终端再检查base_url和API_KEY。3. 这几套工具能不能共用一套配置可以。最关键的是把 endpoint 和 key 的管理统一起来不要每个工具都各写一遍。4. 国内用户怎么更省事地用上官方 API如果不想自己处理海外支付和网络问题可以直接把 endpoint 统一到 Code80 这类入口少掉很多中间步骤。5. 先学哪一个最好新手先学改版客户端熟悉后再切原版 API如果你主要写脚本Gemini CLI 也值得直接试。6. 这三套工具要一起装吗不用。先选一个跑通再按需要补第二个、第三个。
