Claude Code 配置教程

🟢Node.js 安装教程

版本要求：Node.js 版本需要 ≥ 18.0.0，推荐安装最新的 LTS（长期支持）版本

Windows

MacOS

1下载 Node.js 安装包

访问 Node.js 官网下载 Windows 安装包（推荐 LTS 版本，需 ≥ 18.0.0）

https://nodejs.org/zh-cn

2运行安装程序

双击下载的 .msi 文件，按照安装向导进行安装

点击 "Next" 继续
接受许可协议
选择安装路径（默认即可）
保持默认选项，点击 "Next" 直到安装完成

3验证安装

打开命令提示符（Win+R 输入 cmd），运行以下命令验证安装（版本号需 ≥ 18.0.0）

node -v
npm -v

如果显示版本号且 ≥ 18.0.0，则说明安装成功

1使用 Homebrew 安装（推荐）

如果你已安装 Homebrew，在终端运行以下命令

brew install node

提示：如果没有 Homebrew，可以先运行以下命令安装：
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2或者从官网下载安装

访问 Node.js 官网下载 MacOS 安装包（推荐 LTS 版本，需 ≥ 18.0.0）

https://nodejs.org/zh-cn

下载 .pkg 文件后双击运行，按照安装向导完成安装

3验证安装

打开终端，运行以下命令验证安装（版本号需 ≥ 18.0.0）

node -v
npm -v

如果显示版本号且 ≥ 18.0.0，则说明安装成功

📦CLI 安装教程

1确认 Node.js 环境已安装

在 Windows 或 MacOS 终端输入以下命令

npm list -g --depth=0

正常情况应该会显示已安装的全局包列表（没有任何内容也没关系），如果提示"命令未找到"，则说明你没有安装 Node.js，请先参考 Node.js 安装教程

提示：如果你发现自己没有安装 Node.js，并且跟着教程目前已经安装完毕，请重新执行上述命令，如果不再提示"命令未找到"，则说明安装成功

2安装 CLI

在 Windows 或 MacOS 终端输入以下命令，一次性安装好我们目前所需的所有终端

npm i -g @anthropic-ai/claude-code@latest
npm i -g @openai/codex@latest
npm i -g @google/gemini-cli@latest

3测试安装成功

重要：这一步很重要，请务必运行命令进行测试，因为这一步运行命令后，你的用户目录下才会生成各 CLI 的配置目录，方便后续操作！

Claude Code

Codex

Gemini

在 Windows 或 MacOS 终端输入以下命令，若出现图示内容，或出现选项让你选择，则 Claude Code 安装成功

claude

在 Windows 或 MacOS 终端输入以下命令，若出现对话界面，则 Codex 安装成功

codex

在 Windows 或 MacOS 终端输入以下命令，若出现对话界面，则 Gemini 安装成功

gemini

🔧Claude Code 配置

Windows

MacOS

1键盘按下 Win+R 键，输入以下内容后回车，打开Claude Code配置目录

%userprofile%\.claude

2目录内容如图所示，如果目录中没有 settings.json，你需要手动创建它打开

settings.json：Claude主要的配置文件，主要用来配置中转地址以及ApiKey，以及一些hooks，plugins等

3将以下内容写入 settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://new.motchat.com",
    "ANTHROPIC_AUTH_TOKEN": "xxx"
  }
}

4在星星中转中获取 CC 分组的令牌，替换上方 xxx 部分

5在windows终端运行 claude，出现对话界面后进行对话测试，能收到回复即表示配置成功

1在访达界面按下 Command+Shift+G，输入以下路径后回车，打开配置目录

~/.claude

2若目录不存在 settings.json，需要你手动进行创建

settings.json：Claude主要的配置文件，主要用来配置中转站地址以及ApiKey，以及一些hooks，plugins等

3将以下内容写入 settings.json

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://new.motchat.com",
    "ANTHROPIC_AUTH_TOKEN": "xxx"
  }
}

4在星星中转中获取 CC 分组的令牌，替换上方 xxx 部分

5在终端运行 claude，看到对话界面并能正常回复即表示配置完成

Claude Code 一键配置命令

Mac / Linux:

echo 'export ANTHROPIC_BASE_URL="https://new.motchat.com"' >> ~/.zshrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的令牌"' >> ~/.zshrc
source ~/.zshrc

Windows:

setx ANTHROPIC_BASE_URL "https://new.motchat.com"
setx ANTHROPIC_AUTH_TOKEN "你的令牌"

🧩Codex 配置

Windows

MacOS

1键盘按下 Win+R 键，输入以下内容后回车，打开你的codex配置目录

%userprofile%\.codex

2你的目录中可能会存在以下文件，不过我们用到的文件只有三个，需要配置的只有两个

config.toml：Codex的核心配置文件，中转服务与MCP等都在此文件配置

auth.json：用来配置你在中转站获取的ApiKey秘钥

AGENTS.md：用来设置codex全局工作的提示词

重要：很多人刚安装可能没有这三个文件，你需要手动去创建这三个文件，然后写入内容

3配置 config.toml

将以下配置文本复制到你的 config.toml 文件中保存

model_provider = "codextest"
model = "gpt-5.1-codex"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
windows_wsl_setup_acknowledged = true
model_verbosity = "high"

[model_providers.codextest]
name = "codextest"
base_url = "https://new.motchat.com/v1"
wire_api = "responses"
requires_openai_auth = true

4配置 ApiKey

将以下配置文本复制到你的 auth.json 文件中

{
  "OPENAI_API_KEY": "xxx"
}

在星星中转中获取 Codex 分组的令牌，将key填入 xxx 部分后保存

5测试对话

在windows终端输入以下命令，出现对话界面，进行对话测试，如果有回复，则配置成功，开始你的Codex使用之旅~

codex

1在访达界面按下 Command+Shift+G，输入以下路径并回车，打开 Codex 配置目录

~/.codex

2你的目录中可能会存在以下文件，不过我们用到的文件只有三个，需要配置的只有两个，其它文件可忽略

config.toml：Codex 的核心配置文件，中转服务与 MCP 等都在此文件配置

auth.json：存放中转站获取的 ApiKey 秘钥

AGENTS.md：Codex 全局工作的提示词

重要：初次安装若未自动生成，需要手动创建上述三个文件并写入内容

3配置 config.toml

将以下内容保存到 config.toml

model_provider = "codextest"
model = "gpt-5.1-codex"
model_reasoning_effort = "high"
network_access = "enabled"
disable_response_storage = true
windows_wsl_setup_acknowledged = true
model_verbosity = "high"

[model_providers.codextest]
name = "codextest"
base_url = "https://new.motchat.com/v1"
wire_api = "responses"
requires_openai_auth = true

4配置 ApiKey

将以下配置文本复制到你的 auth.json 文件中

{
  "OPENAI_API_KEY": "xxx"
}

在星星中转中获取 Codex 分组的令牌，将key填入 xxx 部分后保存

5测试对话

在 MacOS 终端执行以下命令，出现对话界面并能收到回复即表示配置成功

codex

💎Gemini 配置

Windows

MacOS

1键盘按下 Win+R 键，输入以下内容后回车，打开 Gemini CLI 配置目录

%userprofile%\.gemini

2如果目录下没有 .env 文件，请新建一个 .env，写入以下内容

.env：Gemini CLI的配置文件，主要设置自定义端点、ApiKey跟所用模型

3将以下内容写入 .env 文件

GOOGLE_GEMINI_BASE_URL=https://new.motchat.com
GEMINI_API_KEY=xxx
GEMINI_MODEL=gemini-2.5-pro

4在星星中转中获取 Gemini 分组令牌，并复制ApiKey后填入 xxx

5打开终端执行 gemini，看到交互界面并能正常回复即表示配置成功

gemini

1在访达界面按下 Command+Shift+G，输入以下路径后回车，打开配置目录

~/.gemini

2若目录中没有 .env 文件，创建并写入以下内容

.env：Gemini CLI的配置文件，主要设置自定义端点、ApiKey跟所用模型

3将以下内容写入 .env 文件

GOOGLE_GEMINI_BASE_URL=https://new.motchat.com
GEMINI_API_KEY=xxx
GEMINI_MODEL=gemini-2.5-pro

4在星星中转中获取 Gemini 分组令牌，填入 xxx

5在终端运行 gemini，可正常进入对话并收到回复即表示配置完成

gemini

📝Codex 中常用命令

命令	说明
/model	选择当前使用的模型
/approvals	设置本会话的审批规则
/review	让 Codex 审查当前工作区变更
/resume	从历史会话列表中选择并继续一个之前的交互会话
/new	在当前 CLI 会话中开启新对话
/init	在当前目录生成 AGENTS.md 模板
/compact	总结对话内容以释放上下文
/undo	撤销 Codex 的上一次操作
/diff	查看当前 git diff（含未跟踪文件）
/mention	将指定文件或目录加入对话上下文
/status	查看会话配置和 token 使用情况
/mcp	列出当前可用的 MCP 工具
/exit	退出 Codex CLI

💻Claude Code 中常用命令

命令	功能说明
/claude	在当前目录启动交互式 REPL，对话式使用 Claude Code。
/claude "解释这个项目"	启动 REPL 并带上初始问题，一进来就让 Claude 分析项目。
/claude -p "解释这个函数"	使用 print 模式一次性问答，输出结果后直接退出，便于脚本/CI 调用。
/cat logs.txt \| claude -p "帮我总结错误"	将文件或命令输出通过管道喂给 Claude，再配合 `-p` 做总结、分析。
/claude -c	继续当前目录最近的一次会话，在原有上下文里接着聊。
/claude -c -p "检查类型错误"	在最近会话上下文中执行一次性请求，常用于自动化检查。
/claude -r "abc123" "把这个 PR 完成"	通过会话 ID 恢复指定会话，并继续执行新的任务。
/claude update	将 Claude Code CLI 更新到最新版本。
/claude mcp	管理和配置 MCP 服务器，让 Claude 能访问外部数据源和工具。
/claude --add-dir ../apps ../lib	为 Claude 额外添加可访问的代码目录，支持跨多个路径读代码。
/claude --agents '{"reviewer":{...}}'	通过 JSON 临时定义子 Agent，例如 code-reviewer、debugger 等。
/claude -p "生成接口文档" --output-format json	使用 JSON 格式输出回答，方便后续脚本解析处理。
/claude --model sonnet	指定会话使用的模型（如 sonnet / opus 或具体模型名）。
/claude --verbose	打开详细日志，显示工具调用和内部步骤，便于调试。
/claude --resume abc123 "继续修这个 Bug"	通过会话 ID 恢复会话，在任意目录继续之前的工作。
/claude --continue	载入当前目录最近的一次会话，相当于"继续上次对话"。
/claude --append-system-prompt "始终使用 TypeScript"	在默认系统提示后追加自定义规则，不影响默认行为。
/claude --dangerously-skip-permissions	跳过权限确认，让 Claude 自动执行读写文件/运行命令（高风险，仅在完全信任环境使用）。

🔌如何在 VSCode CC插件中使用

Windows

MacOS

1确保你已进行环境检查并保证你的claude code cli是没问题的，如果有问题，请按照教程进行配置

2键盘按下 Win+R 键，输入以下内容后回车，打开Claude Code配置目录

%userprofile%\.claude

3找到 config.json，如果目录中没有 config.json，你需要手动创建后打开

config.json：配置Vscode的Claude Code插件的一些行为

4在 config.json 中写入以下内容后保存

{
  "primaryApiKey": "key"
}

5重启你的Vscode，开始愉快使用吧！

1确保你已进行环境检查并保证你的claude code cli是没问题的，如果有问题，请按照教程进行配置

2在访达界面按下 Command+Shift+G，输入以下路径后回车，打开配置目录

~/.claude

3目录内容如图所示，如果目录中没有 config.json，你需要手动创建后打开

config.json：配置Vscode的Claude Code插件的一些行为

4在 config.json 中写入以下内容后保存

{
  "primaryApiKey": "key"
}

5重启你的Vscode，开始愉快使用吧！

🔗Claude Code 无法连接到 Anthropic 服务

使用npm安装完claude之后，在命令行输入claude报了如下错误：

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ERR BAD REQUEST
Please check your internet connection and network settings.
Note: Claude Code might not be available in your country, Check supported countries at https://anthropic.com/supported-countries

Windows

MacOS

1按下键盘 Win + R 键，输入 cmd 后回车，打开命令行程序

2在命令行中运行以下命令后回车

powershell -Command "$f='%USERPROFILE%\.claude.json';$j=Get-Content $f|ConvertFrom-Json;$j|Add-Member -NotePropertyName 'hasCompletedOnboarding' -NotePropertyValue $true -Force;$j|ConvertTo-Json|Set-Content $f"

3重启你的Claude Cli

1在APP列表中找到终端程序，点击运行

2在终端中运行以下命令后回车

jq '. + {"hasCompletedOnboarding": true}' ~/.claude.json > /tmp/tmp.json && mv /tmp/tmp.json ~/.claude.json

提示：如果提示未找到jq，可以输入 brew install jq 进行安装

3重启你的Claude Cli

🌐Codex 网络连接问题

当Codex在CLI沙盒或容器（如tun模式）中运行时遇到网络连接问题（如无法拉取安装包），且其他工具（如终端、Claude Code）正常，这通常是由于MTU设置不当引起的。

解决方案：将MTU值改为1500，此设置通常可在您的Clash客户端中进行更改。

Connection failed 问题

报错信息类似为：

Connection failed: error sending request for url (https://new.motchat.com/v1/responses)

出现这种情况是你本机网络出现了问题，按以下步骤排查：

检查本机网络是否通畅，能否访问其他页面
检查你的电脑是否使用了网络代理（梯子）工具，如果存在请你关闭
使用终端，运行codex命令，尝试在CLI中发送对话信息，判断是否是Vscode Codex插件问题，如是，请你重启vscode进行尝试

🔑Codex 401 报错问题

报错信息类似为：

exceeded retry limit, last status: 401 Unauthorized, request id: xxxxxx

Windows

MacOS

1在终端运行以下命令，判断是否存在环境变量

cmd /c "echo ================= OPENAI ENV CHECK ================= & ^
if defined OPENAI_API_KEY (echo OPENAI_API_KEY  = OK) else (echo OPENAI_API_KEY  = MISSING) & ^
if defined OPENAI_BASE_URL (echo OPENAI_BASE_URL = OK) else (echo OPENAI_BASE_URL = MISSING) & ^
echo ========================================================="

如果输出以下内容，则直接进入第2步：

OPENAI_API_KEY  = MISSING
OPENAI_BASE_URL = MISSING

如果输出内容不同，请在终端运行以下命令后进入第二步：

cmd /c "setx OPENAI_API_KEY \"\" & setx OPENAI_BASE_URL \"\""

2查看 Codex在CLI中的配置一章

重要：你需要检查 ~/.codex/auth.json 中的 ApiKey 配置是否正确，以及检查 ~/.codex/config.toml 中的请求地址是否正确

1在终端运行以下命令，判断是否存在环境变量

echo "================= OPENAI ENV CHECK =================" && \
[ -n "$OPENAI_API_KEY" ] && echo "OPENAI_API_KEY  = OK" || echo "OPENAI_API_KEY  = MISSING" && \
[ -n "$OPENAI_BASE_URL" ] && echo "OPENAI_BASE_URL = OK" || echo "OPENAI_BASE_URL = MISSING" && \
echo "========================================================="

如果输出以下内容，则直接进入第2步：

OPENAI_API_KEY  = MISSING
OPENAI_BASE_URL = MISSING

如果输出内容不同，请编辑 ~/.zshrc 或 ~/.bashrc 删除相关环境变量后进入第二步

2查看 Codex在CLI中的配置一章

重要：你需要检查 ~/.codex/auth.json 中的 ApiKey 配置是否正确，以及检查 ~/.codex/config.toml 中的请求地址是否正确

⛔Codex 403 报错问题

报错信息类似为：

unexpected status 403 Forbidden: {"error":{"message":"Usage not included in your
plan","type":"usage_not_included","param":null,"code":null,"plan_type":"basic"}}

出现这种情况是号池中的这个账号出现问题，你需要：

使用 Ctrl+C 来打断你的对话，如在vscode中，请点击停止按钮
重新发起对话进行尝试，观察是否再次出现此问题

⚠️400 报错问题

报错信息类似为：

Error: 400 Bad Request

解决方案：

在星星中转网站主页开启对应的 400修复 功能

注意：只能在报错时开启修复，问题解决后请及时关闭，否则可能会导致其他错误

🚫422 报错问题

报错信息类似为：

Error: 422 Unprocessable Entity

解决方案：

在星星中转网站主页开启对应的 422修复 功能
如果开启修复后仍无法解决，请尝试清理当前会话的上下文

注意：只能在报错时开启修复，问题解决后请及时关闭，否则可能会导致其他错误

💰如何续费额度

1购买兑换码

在星星中转购买兑换码即可进行续费

2Key 用户续费

在星星中转网站主页将你的 Key 放入查询框，即可进行续费操作

3账户用户续费

登录星星中转网站后，在钱包页面进行续费