Claude Code / Codex CLI 安装使用

00 · QUICKSTART

通用配置步骤

先把 Node.js 和 Git 这两个基础环境准备好。基础配置完成后，再按你的需求选择走 GPT 路线或 Claude 路线。

1. 检查 Node.js

先运行下面命令，确认本机已经安装 Node.js。只要能输出版本号，就说明环境正常。

Terminal

NODE.JS CHECK

node -v

管理员终端

WINDOWS INSTALL

winget install OpenJS.NodeJS.LTS

安装完成后，重新打开终端，检查是否生效：

VERIFY

node -v
npm -v

如果不习惯命令行，也可以直接去 Node.js 官方下载页获取最新安装包。

打开下载页

Terminal

如果还没有 Homebrew，先在终端里安装 Homebrew：

HOMEBREW

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

然后安装 Node.js：

MACOS INSTALL

brew install node

安装完成后，重新打开终端，检查是否生效：

VERIFY

node -v
npm -v

如果还没有 Homebrew，或者更习惯图形界面安装，也可以直接打开 Node.js 官方下载页。

打开下载页

2. 检查 Git

再确认 Git 是否已经可用。后面的 GPT 和 Claude 路线都会依赖 Git 环境。

Terminal

GIT CHECK

git --version

管理员终端

WINDOWS INSTALL

winget install Git.Git

安装完成后，重新打开终端，检查是否生效：

VERIFY

git --version

如果不习惯命令行，也可以直接去 Git 官方下载页安装 Windows 版本。

下载 Git

Terminal

如果还没有 Homebrew，先在终端里安装 Homebrew：

HOMEBREW

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

然后安装 Git：

MACOS INSTALL

brew install git

安装完成后，重新打开终端，检查是否生效：

VERIFY

git --version

如果更习惯图形界面安装，也可以直接打开 Git 官方下载页获取 macOS 安装包。

打开下载页

3. 选择使用 GPT 还是 Claude

基础环境准备好之后，再进入对应路线继续安装和使用。这里的 GPT 路线对应下方的 Codex CLI。

OpenAI / GPT

走 GPT 路线

继续安装和使用 Codex CLI，适合准备接 OpenAI / GPT 工作流的场景。

进入 GPT 配置

Anthropic / Claude

走 Claude 路线

继续安装和使用 Claude Code，适合后续接 Claude Code 工作流的场景。

进入 Claude 配置

01 · GPT / CODEX CLI

GPT（Codex CLI）安装与使用

基础环境准备好后，如果你走 GPT 路线，就在这里安装和使用 Codex CLI。Windows 优先走 WSL2。

Install

Codex CLI

npm install -g @openai/codex
# or
brew install codex

cd your-project
codex

使用流程

进入项目目录。
运行 codex 并完成登录。
直接输入任务开始使用。

codex --help 可查看全部命令。

Windows / WSL2

Codex CLI

wsl --install

# 进入 Ubuntu 之后执行
npm install -g @openai/codex

cd your-project
codex

使用流程

先装好 WSL2。
在 Linux 环境里安装并运行 codex。
登录后直接开始使用。

Windows 下官方建议优先使用 WSL2。

02 · CLAUDE CODE

Claude Code 安装与使用

只保留安装、登录和启动。

Install

Claude Code

curl -fsSL https://claude.ai/install.sh | bash
# or
brew install --cask claude-code

cd your-project
claude

使用流程

进入项目目录。
运行 claude 并完成登录。
直接输入任务开始使用。

原生安装会自动更新；Homebrew 需要手动升级。

Windows

Claude Code

winget install Anthropic.ClaudeCode

# 建议先安装 Git for Windows

cd your-project
claude

使用流程

先安装 Claude Code 和 Git for Windows。
进入项目目录后运行 claude。
登录后直接开始使用。

Windows 下先准备好 Git 环境。

API 密钥配置

Claude Code 走这个地址：https://yjxapi-gpt.xyz。API Key 先写 xxx。

Terminal

CLAUDE CODE

export ANTHROPIC_BASE_URL="https://yjxapi-gpt.xyz"
export ANTHROPIC_AUTH_TOKEN="xxx"
export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

~/.claude/settings.json

VSCODE CLAUDE CODE

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://yjxapi-gpt.xyz",
    "ANTHROPIC_AUTH_TOKEN": "xxx",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

Command Prompt

CLAUDE CODE

set ANTHROPIC_BASE_URL=https://yjxapi-gpt.xyz
set ANTHROPIC_AUTH_TOKEN=xxx
set CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1

%userprofile%\.claude\settings.json

VSCODE CLAUDE CODE

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://yjxapi-gpt.xyz",
    "ANTHROPIC_AUTH_TOKEN": "xxx",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

PowerShell

CLAUDE CODE

$env:ANTHROPIC_BASE_URL="https://yjxapi-gpt.xyz"
$env:ANTHROPIC_AUTH_TOKEN="xxx"
$env:CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC="1"

%userprofile%\.claude\settings.json

VSCODE CLAUDE CODE

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://yjxapi-gpt.xyz",
    "ANTHROPIC_AUTH_TOKEN": "xxx",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0"
  }
}

03 · ACCESS EXAMPLE

接入示意

只放示例，不放真实密钥。

接入示意

API Key

sk-********************************

Base URL

https://yjxapi-gpt.xyz/v1

Model

gpt-5.4

怎么用这个示例

客户端一般填写 API Key、Base URL、Model。
页面里只放占位符。
真实密钥只写在你自己的本地配置里。

04 · PROXY LAYER

CCSwitch 配置

保留平台切换，请求地址继续用 https://yjxapi-gpt.xyz/v1。

~/.codex/config.toml

CCSWITCH MACOS / LINUX

model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://yjxapi-gpt.xyz/v1"
wire_api = "responses"
requires_openai_auth = true

~/.codex/auth.json

AUTH EXAMPLE

{
  "OPENAI_API_KEY": "sk-你的密钥"
}

%userprofile%\.codex\config.toml

CCSWITCH WINDOWS

model_provider = "OpenAI"
model = "gpt-5.4"
review_model = "gpt-5.4"
model_reasoning_effort = "xhigh"
disable_response_storage = true
network_access = "enabled"
windows_wsl_setup_acknowledged = true
model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://yjxapi-gpt.xyz/v1"
wire_api = "responses"
requires_openai_auth = true

%userprofile%\.codex\auth.json

AUTH EXAMPLE

{
  "OPENAI_API_KEY": "sk-你的密钥"
}

05 · SOURCES

官方来源

只留最直接的几页。

OpenAI

Codex CLI

安装、登录、Windows 下 WSL2 提示。

OpenAI

Codex Features

补充命令与功能入口。

Anthropic

Claude 中文 Quickstart

安装、登录、启动、第一次使用。

Claude Code 与 Codex CLI 多平台安装使用说明

通用配置步骤

1. 检查 Node.js

2. 检查 Git

3. 选择使用 GPT 还是 Claude

走 GPT 路线

走 Claude 路线

GPT（Codex CLI）安装与使用

使用流程

使用流程

Claude Code 安装与使用

使用流程

使用流程

API 密钥配置

接入示意

接入示意

怎么用这个示例

CCSwitch 配置

官方来源

Codex CLI

Codex Features

Claude 中文 Quickstart