Claude Code 与 Codex 安装配置
第一部分：环境安装（通用）
1.1 安装 Node.js
1.
2.
3.
.msi 文件，按向导一直 Next 保持默认设置完成安装.pkg 文件按向导安装，或用 Homebrew：brew install nodeWindows 打开终端：按 Win + X，选择 "终端管理员" 或 "Windows PowerShell (管理员)"。
1.2 安装 Git Bash（Windows 推荐）
2.
3.
.exe 安装文件，全程保持默认设置，点击 "Next" 完成安装macOS / Linux 通常已自带 Git，无需单独安装。
第二部分：Claude Code 安装与配置
2.1 安装 Claude Code
[Environment]::SetEnvironmentVariable('Path', ([Environment]::GetEnvironmentVariable('Path','User') + ";$HOME\.local\bin"), 'User')2.2 配置 API（Windows）
安装完成后，推荐使用CC Switch配置Claude Code，可参考CC-Switch配置文档，使用CC Switch无需如下操作。
[Environment]::SetEnvironmentVariable("ANTHROPIC_AUTH_TOKEN", "YOUR_API_KEY", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://www.moyu.cn", "User")
[Environment]::SetEnvironmentVariable("ANTHROPIC_MODEL", "claude-sonnet-4-5-20250929", "User")| 变量 | 说明 |
|---|---|
ANTHROPIC_AUTH_TOKEN | 你的 API 密钥 |
ANTHROPIC_BASE_URL | 平台地址，不带 /v1（Claude Code 会自动拼接 /v1/messages） |
ANTHROPIC_MODEL | 默认使用的 Claude 模型 |
echo $env:ANTHROPIC_AUTH_TOKEN
echo $env:ANTHROPIC_BASE_URL
echo $env:ANTHROPIC_MODEL2.3 配置 API（macOS / Linux）
~/.zshrc，bash 用 ~/.bashrc）：2.4 使用 Claude Code
会话内可用 /model <模型名>临时切换模型。
第三部分：Codex 安装与配置
3.1 安装 Codex CLI
macOS / Linux 必要时前面加 sudo；macOS 也可用 Homebrew：brew install codex。
3.2 创建配置文件
安装完成后，推荐使用CC Switch配置Codex，可参考CC-Switch配置文档，使用CC Switch无需如下操作
.codex 文件夹，需要两个文件：.codex 文件夹（示例 C:\Users\你的用户名\.codex）。若看不到，先在资源管理器开启 "显示隐藏项目"；没有该文件夹则手动创建，并在其中新建 auth.json 和 config.toml。3.3 编辑 auth.json
{
"OPENAI_API_KEY": null
}设为 null表示不使用内置 key，而是通过config.toml中env_key指定的环境变量读取密钥。
3.4 编辑 config.toml
model_provider = "moyuai"
model = "gpt-5.1"
model_reasoning_effort = "high"
disable_response_storage = true
preferred_auth_method = "apikey"
requires_openai_auth = true
[model_providers.moyuai]
name = "moyuai"
base_url = "https://www.moyu.cn/v1"
wire_api = "responses"
env_key = "CRS_OAI_KEY"| 字段 | 说明 |
|---|---|
model_provider | 指向下方 [model_providers.xxx] 段，须一致 |
model | 使用的模型，可切换为其他 OpenAI 系列模型 |
model_reasoning_effort | 推理强度：low / medium / high |
base_url | 平台地址，Codex 需要带 /v1 |
env_key | 读取密钥的环境变量名 |
3.5 配置环境变量（API Key）
1.
2.
CRS_OAI_KEYYOUR_API_KEY# PowerShell
echo $env:CRS_OAI_KEY
# CMD
echo %CRS_OAI_KEY%配置改完一定要重启终端让其生效。
3.6 使用 Codex
注意：Codex 启动时才读取模型配置，改完配置后需重启 Codex 才会生效。
第四部分：常见问题
/v1？A：Claude Code 不带（
https://www.moyu.cn），Codex 带（https://www.moyu.cn/v1）A：环境变量在终端启动时读取。改完后请关闭并重开终端，Codex 还需重启 codex。
A：检查 API Key 是否正确、有无多余空格；Codex 还需确认
auth.json 的 OPENAI_API_KEY 为 null（密钥走环境变量）。A：Claude 改
ANTHROPIC_MODEL 或会话内 /model；Codex 改 config.toml 的 model 后重启。可用模型名以平台「模型列表」为准（调用 GET /v1/models 获取）。A：可使用 CC-Switch 桌面工具统一管理，详见「CC-Switch 配置」文档。
修改于 2026-09-09 04:33:14