使用文档 - Claude Code & Codex CLI 配置指南

Claude Code 使用指南

Claude Code 是 Anthropic 官方推出的 AI 编程助手，支持通过 cch 代理服务使用。本指南将帮助您在不同操作系统上完成安装和配置。

macOS

环境准备：安装 Node.js

claude 需要 Node.js 环境才能运行（需 v18 或更高版本）。

方法一：使用 Homebrew（推荐）

bash

# 更新 Homebrew
brew update
# 安装 Node.js
brew install node

方法二：官网下载

访问 https://nodejs.org/
下载适合 macOS 的 LTS 版本（需 v18 或更高）
打开下载的 .pkg 文件，按照安装向导完成

安装完成后验证：

bash

node --version
npm --version

如果显示版本号，说明安装成功了！

安装 Claude Code

官方推荐使用 Native 安装方式，具有以下优势：

单个可执行文件，无需 Node.js 依赖
自动更新机制更稳定
启动速度更快

方法一：Homebrew（推荐）

bash

brew install --cask claude-code

自动更新说明
通过 Homebrew 安装的 Claude Code 会在 brew 目录外自动更新，除非使用 DISABLE_AUTOUPDATER 环境变量显式禁用。

方法二：curl 脚本

bash

# 安装稳定版（默认）
curl -fsSL https://claude.ai/install.sh | bash

# 安装最新版
curl -fsSL https://claude.ai/install.sh | bash -s latest

# 安装指定版本
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

验证安装

bash

claude --version

如果显示版本号，恭喜！Claude Code 已成功安装。

提示
安装前请确保移除任何过期的别名或符号链接。使用 claude doctor 命令可以检查安装类型和版本。

连接 cch 服务

方法一：settings.json 配置（推荐）

配置文件路径：

text

~/.claude/settings.json

路径说明
Windows：C:/Users/你的用户名/.claude
Linux 或 macOS：~/.claude
如果 settings.json 文件不存在，请自行创建

编辑 settings.json 文件，添加以下内容：

json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key-here",
    "ANTHROPIC_BASE_URL": "https://code.lovebenefits.com",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

重要提示
将 your-api-key-here 替换为您的实际 API 密钥
密钥获取方式：登录控制台 → API 密钥管理 → 创建密钥

方法二：环境变量配置

临时设置（当前会话）：

bash

export ANTHROPIC_BASE_URL="https://code.lovebenefits.com"
export ANTHROPIC_AUTH_TOKEN="your-api-key-here"

永久设置（添加到 ~/.zshrc）：

bash

echo 'export ANTHROPIC_BASE_URL="https://code.lovebenefits.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key-here"' >> ~/.zshrc
source ~/.zshrc

验证配置

bash

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

预期输出示例：

text

https://code.lovebenefits.com
sk_xxxxxxxxxxxxxxxxxx

注意
如果输出为空或显示变量名本身，说明环境变量设置失败，请重新按照上述步骤设置。

VS Code 扩展配置

配置文件路径：~/.claude

在 VS Code 扩展中搜索并安装 Claude Code for VS Code
在 ~/.claude 目录下创建 config.json 文件（如果没有）
添加以下内容：

jsonc

// Path: ~/.claude
{
  "primaryApiKey": "any-value"
}

注意
是 config.json，不是 settings.json
primaryApiKey 字段值可以为任意内容，只要存在即可

启动 claude

在项目目录下运行：

bash

cd /path/to/your/project
claude

首次启动时，claude 会进行初始化配置。

常见问题

1. 命令未找到

bash

# 检查 npm 全局安装路径
npm config get prefix

# 添加到 PATH（如果不在）
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

2. API 连接失败

bash

# 检查环境变量
echo $ANTHROPIC_AUTH_TOKEN

# 测试网络连接
curl -I https://code.lovebenefits.com

3. 更新 claude

bash

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

Windows

环境准备：安装 Node.js

claude 需要 Node.js 环境才能运行（需 v18 或更高版本）。

方法一：官网下载（推荐）

访问 https://nodejs.org/
下载 LTS 版本（需 v18 或更高）
双击 .msi 文件，按向导安装（保持默认设置）

方法二：使用包管理器

powershell

# 使用 Chocolatey
choco install nodejs

# 或使用 Scoop
scoop install nodejs

提示
建议使用 PowerShell 而不是 CMD，以获得更好的体验。

验证安装：

powershell

node --version
npm --version

安装 Claude Code

官方推荐使用 Native 安装方式，具有以下优势：

单个可执行文件，无需 Node.js 依赖
自动更新机制更稳定
启动速度更快

方法一：PowerShell

powershell

# 安装稳定版（默认）
irm https://claude.ai/install.ps1 | iex

# 安装最新版
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) latest

# 安装指定版本
& ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 1.0.58

方法二：CMD

batch

REM 安装稳定版（默认）
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

REM 安装最新版
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd latest && del install.cmd

REM 安装指定版本
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd 1.0.58 && del install.cmd

验证安装

powershell

claude --version

如果显示版本号，恭喜！Claude Code 已成功安装。

提示
安装前请确保移除任何过期的别名或符号链接。使用 claude doctor 命令可以检查安装类型和版本。

连接 cch 服务

方法一：settings.json 配置（推荐）

配置文件路径：

text

C:\Users\你的用户名\.claude\settings.json

路径说明
Windows：C:/Users/你的用户名/.claude
Linux 或 macOS：~/.claude
如果 settings.json 文件不存在，请自行创建

编辑 settings.json 文件，添加以下内容：

json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key-here",
    "ANTHROPIC_BASE_URL": "https://code.lovebenefits.com",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

重要提示
将 your-api-key-here 替换为您的实际 API 密钥
密钥获取方式：登录控制台 → API 密钥管理 → 创建密钥

方法二：环境变量配置

临时设置（当前会话）：

powershell

$env:ANTHROPIC_BASE_URL = "https://code.lovebenefits.com"
$env:ANTHROPIC_AUTH_TOKEN = "your-api-key-here"

永久设置（用户级）：

powershell

[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://code.lovebenefits.com", [System.EnvironmentVariableTarget]::User)
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "your-api-key-here", [System.EnvironmentVariableTarget]::User)

设置后需要重新打开 PowerShell 窗口才能生效。

验证配置

在 PowerShell 中执行：

powershell

echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_AUTH_TOKEN

在 CMD 中执行：

cmd

echo %ANTHROPIC_BASE_URL%
echo %ANTHROPIC_AUTH_TOKEN%

预期输出示例：

text

https://code.lovebenefits.com
sk_xxxxxxxxxxxxxxxxxx

注意
如果输出为空或显示变量名本身，说明环境变量设置失败，请重新按照上述步骤设置。

VS Code 扩展配置

配置文件路径：C:\Users\你的用户名\.claude

在 VS Code 扩展中搜索并安装 Claude Code for VS Code
在 C:\Users\你的用户名\.claude 目录下创建 config.json 文件（如果没有）
添加以下内容：

jsonc

// Path: C:\Users\你的用户名\.claude
{
  "primaryApiKey": "any-value"
}

注意
是 config.json，不是 settings.json
primaryApiKey 字段值可以为任意内容，只要存在即可

启动 claude

powershell

cd C:\path\to\your\project
claude

首次启动时，claude 会进行初始化配置。

常见问题

1. 命令未找到

确保 npm 全局路径（通常是 C:\Users\你的用户名\AppData\Roaming\npm）已添加到系统 PATH
重新打开 PowerShell 窗口

2. API 连接失败

powershell

# 检查环境变量
echo $env:ANTHROPIC_AUTH_TOKEN

# 测试网络连接
Test-NetConnection -ComputerName code.lovebenefits.com -Port 443

3. 更新 claude

powershell

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

Linux

环境准备：安装 Node.js

claude 需要 Node.js 环境才能运行（需 v18 或更高版本）。

方法一：使用官方仓库（推荐）

bash

# 添加 NodeSource 仓库
curl -fsSL https://deb.nodesource.com/setup_lts.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs

方法二：使用系统包管理器

bash

# Ubuntu/Debian
sudo apt update
sudo apt install nodejs npm

# CentOS/RHEL/Fedora
sudo dnf install nodejs npm

验证安装：

bash

node --version
npm --version

安装 Claude Code

官方推荐使用 Native 安装方式，具有以下优势：

单个可执行文件，无需 Node.js 依赖
自动更新机制更稳定
启动速度更快

curl 脚本安装

bash

# 安装稳定版（默认）
curl -fsSL https://claude.ai/install.sh | bash

# 安装最新版
curl -fsSL https://claude.ai/install.sh | bash -s latest

# 安装指定版本
curl -fsSL https://claude.ai/install.sh | bash -s 1.0.58

Alpine Linux 特殊说明
基于 musl/uClibc 的发行版（如 Alpine Linux）需要安装额外依赖：
bash
apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0

验证安装

bash

claude --version

提示
安装前请确保移除任何过期的别名或符号链接。使用 claude doctor 命令可以检查安装类型和版本。

连接 cch 服务

方法一：settings.json 配置（推荐）

配置文件路径：

text

~/.claude/settings.json

路径说明
Windows：C:/Users/你的用户名/.claude
Linux 或 macOS：~/.claude
如果 settings.json 文件不存在，请自行创建

编辑 settings.json 文件，添加以下内容：

json

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "your-api-key-here",
    "ANTHROPIC_BASE_URL": "https://code.lovebenefits.com",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1"
  },
  "permissions": {
    "allow": [],
    "deny": []
  }
}

重要提示
将 your-api-key-here 替换为您的实际 API 密钥
密钥获取方式：登录控制台 → API 密钥管理 → 创建密钥

方法二：环境变量配置

临时设置（当前会话）：

bash

export ANTHROPIC_BASE_URL="https://code.lovebenefits.com"
export ANTHROPIC_AUTH_TOKEN="your-api-key-here"

永久设置（添加到 ~/.bashrc）：

bash

echo 'export ANTHROPIC_BASE_URL="https://code.lovebenefits.com"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="your-api-key-here"' >> ~/.bashrc
source ~/.bashrc

验证配置

bash

echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

预期输出示例：

text

https://code.lovebenefits.com
sk_xxxxxxxxxxxxxxxxxx

注意
如果输出为空或显示变量名本身，说明环境变量设置失败，请重新按照上述步骤设置。

VS Code 扩展配置

配置文件路径：~/.claude

在 VS Code 扩展中搜索并安装 Claude Code for VS Code
在 ~/.claude 目录下创建 config.json 文件（如果没有）
添加以下内容：

jsonc

// Path: ~/.claude
{
  "primaryApiKey": "any-value"
}

注意
是 config.json，不是 settings.json
primaryApiKey 字段值可以为任意内容，只要存在即可

启动 claude

bash

cd /path/to/your/project
claude

首次启动时，claude 会进行初始化配置。

常见问题

1. 命令未找到

bash

# 检查 npm 全局安装路径
npm config get prefix

# 添加到 PATH（如果不在）
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

2. API 连接失败

bash

# 检查环境变量
echo $ANTHROPIC_AUTH_TOKEN

# 测试网络连接
curl -I https://code.lovebenefits.com

3. 更新 claude

bash

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

Codex CLI 使用指南

Codex 是 OpenAI 官方的命令行 AI 编程助手，支持通过 cch 代理使用。注意：Codex 使用 OpenAI 兼容格式，端点需要包含 /v1 路径。

macOS

环境准备：安装 Node.js

codex 需要 Node.js 环境才能运行（需 v18 或更高版本）。

方法一：使用 Homebrew（推荐）

bash

brew update
brew install node

方法二：官网下载

访问 https://nodejs.org/
下载适合 macOS 的 LTS 版本（需 v18 或更高）
打开下载的 .pkg 文件，按照安装向导完成

bash

node --version
npm --version

安装 Codex

bash

npm i -g @openai/codex --registry=https://registry.npmmirror.com

验证安装：

bash

codex --version

连接 cch 服务

配置文件设置

找到 ~/.codex 文件夹（不存在则创建）
创建 config.toml 文件
使用文本编辑器打开，添加以下内容：

config.toml

toml

model_provider = "cch"
model = "gpt-5.2"
model_reasoning_effort = "xhigh"
disable_response_storage = true
sandbox_mode = "workspace-write"

[features]
plan_tool = true
apply_patch_freeform = true
view_image_tool = true
web_search_request = true
unified_exec = false
streamable_shell = false
rmcp_client = true

[model_providers.cch]
name = "cch"
base_url = "https://code.lovebenefits.com/v1"
wire_api = "responses"
requires_openai_auth = true

[sandbox_workspace_write]
network_access = true

auth.json

json

{
  "OPENAI_API_KEY": "your-api-key-here"
}

提示
此方式通过 auth.json 文件存储 API 密钥，config.toml 中无需配置 env_key 字段。

重要提示
将 your-api-key-here 替换为您的 cch API 密钥
注意：Codex 使用 OpenAI 兼容格式，端点包含 /v1 路径

VS Code 扩展配置

在 VS Code 扩展中搜索并安装 Codex – OpenAI's coding agent
确保已按照上述步骤配置好 config.toml 和 auth.json
设置环境变量 CCH_API_KEY

重要
env_key 只能是环境变量名称（如 CCH_API_KEY），不能是完整的密钥。如果直接填写密钥，会报错找不到令牌或令牌配置错误。

启动 codex

bash

cd /path/to/your/project
codex

首次启动时，codex 会进行初始化配置。

常见问题

1. 命令未找到

bash

npm config get prefix
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

2. API 连接失败

bash

echo $OPENAI_API_KEY
curl -I https://code.lovebenefits.com

3. 更新 codex

bash

npm install -g @openai/codex

Windows

环境准备：安装 Node.js

参考上方 Claude Code Windows 章节安装 Node.js。

powershell

node --version
npm --version

安装 Codex

powershell

npm i -g @openai/codex --registry=https://registry.npmmirror.com

powershell

codex --version

连接 cch 服务

在 C:\Users\你的用户名\.codex\ 目录下创建 config.toml 和 auth.json，内容同 macOS 章节。

路径说明
Windows 上 codex 配置目录为 C:\Users\你的用户名\.codex，不存在则创建。

VS Code 扩展配置

在 VS Code 扩展中搜索并安装 Codex – OpenAI's coding agent
确保已按照上述步骤配置好 config.toml 和 auth.json
设置环境变量 CCH_API_KEY

重要
env_key 只能是环境变量名称（如 CCH_API_KEY），不能是完整的密钥。如果直接填写密钥，会报错找不到令牌或令牌配置错误。

启动 codex

powershell

cd C:\path\to\your\project
codex

常见问题

2. API 连接失败

powershell

echo $env:OPENAI_API_KEY
Test-NetConnection -ComputerName code.lovebenefits.com -Port 443

3. 更新 codex

powershell

npm install -g @openai/codex

Linux

环境准备：安装 Node.js

参考上方 Claude Code Linux 章节安装 Node.js。

bash

node --version
npm --version

安装 Codex

bash

npm i -g @openai/codex --registry=https://registry.npmmirror.com

bash

codex --version

连接 cch 服务

配置文件设置

找到 ~/.codex 文件夹（不存在则创建）
创建 config.toml 文件
使用文本编辑器打开，添加以下内容：

config.toml

toml

model_provider = "cch"
model = "gpt-5.2"
model_reasoning_effort = "xhigh"
disable_response_storage = true
sandbox_mode = "workspace-write"

[features]
plan_tool = true
apply_patch_freeform = true
view_image_tool = true
web_search_request = true
unified_exec = false
streamable_shell = false
rmcp_client = true

[model_providers.cch]
name = "cch"
base_url = "https://code.lovebenefits.com/v1"
wire_api = "responses"
requires_openai_auth = true

[sandbox_workspace_write]
network_access = true

auth.json

json

{
  "OPENAI_API_KEY": "your-api-key-here"
}

提示
此方式通过 auth.json 文件存储 API 密钥，config.toml 中无需配置 env_key 字段。

重要提示
将 your-api-key-here 替换为您的 cch API 密钥
注意：Codex 使用 OpenAI 兼容格式，端点包含 /v1 路径

VS Code 扩展配置

在 VS Code 扩展中搜索并安装 Codex – OpenAI's coding agent
确保已按照上述步骤配置好 config.toml 和 auth.json
设置环境变量 CCH_API_KEY

重要
env_key 只能是环境变量名称（如 CCH_API_KEY），不能是完整的密钥。如果直接填写密钥，会报错找不到令牌或令牌配置错误。

启动 codex

bash

cd /path/to/your/project
codex

常见问题

2. API 连接失败

bash

echo $OPENAI_API_KEY
curl -I https://code.lovebenefits.com

3. 更新 codex

bash

npm install -g @openai/codex