前言

最近一段时间，Claude Code 和 Codex 在开发者圈子里非常火。

尤其是 Claude Code，很多开发者第一次真正感受到：

AI 已经不只是“代码补全”，而是开始具备“工程级开发能力”。

它可以：

• 理解整个项目结构
• 自动分析代码逻辑
• 自动修改 Bug
• 自动执行命令
• 自动生成模块
• 自动重构代码
• 自动完成复杂开发任务

而 Codex 则更偏向于 Agent 化执行，可以理解为：

“更自动化的 AI 编程执行工具”。

但对于很多国内开发者来说，真正的问题不是“不会用”，而是：

• 官网打不开
• 没海外手机号
• 没国外信用卡
• Claude Code 登录失败
• API 无法访问
• 各种 ERR_BAD_REQUEST
• Request not allowed
• 不会配置代理
• 不会配置 API

我自己在配置和使用过程中，也踩过非常多坑。

所以这篇文章，我会从一个国内开发者的真实视角，带你从零开始：

• 安装 Claude Code
• 安装 Codex
• 配置 Node.js 环境
• 解决常见报错
• 配置 API 中转
• 实现国内稳定可用

这篇文章更偏向“真实踩坑 + 实战方案”，适合：

• 想体验 AI 编程 Agent
• 想用 Claude Code
• 想用 Codex
• 不想折腾海外账号
• 不想研究复杂代理配置
• 想直接开始使用的人

---

一、Claude Code 和 Codex 到底是什么？

很多人第一次接触时，会把 Claude Code 和 Codex 混在一起。

但实际上它们并不是同一种工具。

1. Claude Code

Claude Code 是 Anthropic 推出的 AI 编程 Agent CLI。

简单理解：

它是一个运行在终端里的 AI 工程助手。

它最大的特点不是“补全代码”，而是：

真正具备工程级理解能力。

例如：

你可以直接让它：

• 分析整个项目
• 查找 Bug
• 修改代码
• 重构模块
• 自动运行命令
• 自动修复错误
• 自动生成完整功能

很多时候，你甚至可以：

“直接把任务交给它”。

这是 Claude Code 最强的地方。

Claude Code 更适合：

• 大型工程
• Python 项目
• 后端项目
• AI 工程
• 复杂代码理解
• 自动重构
• 自动修 Bug

---

2. Codex

Codex 本质上更偏向：

AI Agent 执行能力。

它强调：

• 自动执行任务
• 自动生成代码
• 自动调用工具
• 自动完成开发流程

你可以把它理解为：

“更偏向自动化执行的 AI 编程助手”。

---

3. Claude Code 和 Codex 的区别

工具	公司	特点	更适合
Claude Code	Anthropic	工程理解能力极强	大项目、复杂代码
Codex	OpenAI	Agent 执行能力强	自动化开发流程

如果是：

• 大型工程
• 阅读复杂代码
• 理解业务逻辑

我个人会更推荐 Claude Code。

---

二、为什么国内开发者很难使用 Claude Code？

这是很多人最真实的问题。

我第一次安装 Claude Code 时，也踩了很多坑。

最典型的报错：

Unable to connect to Anthropic services

或者：

ERR_BAD_REQUEST

再或者：

Request not allowed

这些问题其实本质上都来自几个原因：

1. 地区限制

Anthropic 官方对于部分地区存在限制。

很多国内网络环境下：

• Claude 官网可能能打开
• 但 CLI/API 不一定能访问

这是因为：

网页和 API 的风控并不是同一套。

---

2. 终端不走代理

很多人发现：

• 浏览器能打开 Claude
• 但 Claude Code 连不上

原因是：

Claude Code 本质上是 Node.js CLI。

很多代理软件：

只代理浏览器，不代理终端。

于是就会出现：

“网页正常，CLI 报错”。

---

3. 海外账号问题

很多开发者还会遇到：

• 海外手机号
• 海外支付方式
• API Key 获取困难

这些问题对于普通开发者门槛其实很高。

---

三、开始安装 Node.js

因为 Claude Code 和 Codex 本质上都是基于 Node.js 的 CLI 工具。

所以第一步必须先安装 Node.js。

1. 下载 Node.js

node官网

建议直接下载 LTS 长期支持版本。

推荐版本：

• Node.js 18+
• Node.js 20+

安装时：

记得勾选：

Add to PATH

否则后续终端无法识别 node 和 npm。

---

2. 验证安装

打开 CMD 或 PowerShell：

node -v
npm -v

如果能正常显示版本号，说明安装成功。

例如：

v20.18.0
10.8.2

---

四、安装 Claude Code 与 Codex

1. 安装 Claude Code

首先执行：

npm install -g @anthropic-ai/claude-code

安装完成后：

执行：

claude

如果正常，会进入 Claude Code CLI。

---

2. 安装 Codex

Codex 同样建议通过 npm 安装。

执行：

npm install -g @openai/codex

安装完成后：

执行：

codex

如果成功，会进入 Codex CLI。

---

3. 常见问题

很多人第一次安装完成后，会直接出现：

Unable to connect to Anthropic services

或者：

Request not allowed

再或者：

ERR_BAD_REQUEST

这些问题大多数并不是安装失败。

而是：

• 网络问题
• API 问题
• 代理问题
• 地区限制
• 终端未走代理

后面我会详细讲如何解决。

---

五、为什么官方方案在国内容易失败？

这里其实是很多教程不会讲的部分。

因为大部分国外教程默认：

你已经拥有：

• 海外网络
• 海外账号
• 海外支付方式
• 官方 API 权限

但现实是：

很多国内开发者并不具备这些条件。

于是就会遇到：

1. API 无法访问

例如：

Request not allowed

实际上说明：

• API 已经连接成功
• 但被官方风控拒绝

---

2. CLI 无法登录

例如：

ERR_BAD_REQUEST

很多时候并不是代码错误。

而是：

• IP 问题
• 地区问题
• 节点问题
• 代理问题

---

3. 浏览器正常，但 CLI 不正常

因为：

浏览器和 CLI 走的网络环境可能不同。

这也是很多人最容易踩坑的地方。

---

六、解决方法

使用获取国内就可以使用和直连的api，配置好之后，便可以直接流畅快速无阻使用 Claude 和 Codex。

这部分是很多人最关心的。

简单来说：

而是通过一个兼容接口访问模型。

这样做的好处：

• 不需要复杂网络环境
• 不需要海外支付方式
• 不需要自己申请官方 API
• 配置简单
• 更适合国内开发者

---

七、如何配置 Claude Code 和 Codex API 中转

1. Claude Code 配置

首先在~/.codex/寻找settings.json没有则创建。

示例配置：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的令牌",
    "ANTHROPIC_BASE_URL": "https://api.apiplus.cloud",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "claude-sonnet-4-6",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "claude-opus-4-7",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "claude-sonnet-4-6"
  },
  "model": "opus[1m]"
}

2. Codex 创建配置文件

Codex 的配置目录：

~/.codex/

Windows 对应：

%USERPROFILE%\.codex\

本教程只需要创建：

• config.toml
• auth.json

Windows PowerShell 创建目录：

# PowerShell 中创建目录
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.codex" | Out-Null

# 用记事本编辑这两个文件
notepad "$env:USERPROFILE\.codex\config.toml"
notepad "$env:USERPROFILE\.codex\auth.json"

3. 写入 Codex 配置

~/.codex/config.toml

写入以下内容：

# ~/.codex/config.toml
model = "gpt-5.5"
model_reasoning_effort = "xhigh"
openai_base_url = "https://api.apiplus.cloud/v1"

~/.codex/auth.json

将：

sk-你的令牌

替换成真实 API Key。

{
  "auth_mode": "apikey",
  "OPENAI_API_KEY": "sk-你的令牌"
}

4. 配置说明

Claude Code

主要需要：

• ANTHROPIC_AUTH_TOKEN
• ANTHROPIC_BASE_URL

分别对应：

• API Key
• 中转接口地址

Codex

主要需要：

• OPENAI_API_KEY
• openai_base_url

Codex 本质上更偏向 OpenAI 接口规范。

因此配置方式与 Claude Code 略有不同。

---

模型名称

不同中转平台支持的模型名称可能不同。

建议：

先查看平台文档。

—全部配置完成后重新输入claude或codex然后回车，询问一个简单问题例如：

codex示例

八、Claude Code 常见报错解决方案

这一部分建议收藏。

因为很多问题其实非常常见。

---

1. Unable to connect to Anthropic services

原因

• 网络问题
• 终端未走代理
• 地区限制

解决方案

• 开启全局代理
• 开启 TUN 模式
• 使用 API 中转
• 更换节点

---

2. Request not allowed

原因

• API 被风控
• IP 被限制
• 权限不足

解决方案

• 更换节点
• 使用中转 API
• 更换 IP

---

3. ERR_BAD_REQUEST

原因

• 配置错误
• API 地址错误
• 请求格式错误

解决方案

检查：

• Base URL
• API Key
• 模型名称

---

4. node 不是内部命令

原因

Node.js 未加入 PATH。

解决方案

重新安装 Node.js。

并勾选：

Add to PATH

---

九、总结

Claude Code 和 Codex 的出现，其实正在改变 AI 编程方式。

它们已经不再只是：

“代码补全工具”。

而是开始真正进入：

“工程级 AI Agent”。

对于国内开发者来说：

最大的难点其实不是学习成本。

而是：

• 网络环境
• API 配置
• 账号问题
• 代理问题

但只要配置好：

• Node.js
• CLI
• API 中转
• settings.json

其实就已经能比较稳定地体验到 Claude Code 和 Codex 的能力。

最后建议：

不要只把它们当成“AI 聊天工具”。

真正强大的地方在于：

“让 AI 参与整个工程开发流程”。

这可能会是未来开发方式的重要变化。
，以上就是我的所有经验，欢迎指正！