Windows WSL 环境下配置 Claude Code 非官方账号2233.ai完整教程

Windows WSL 环境下配置 Claude Code 非官方账号完整教程

这里的 2233.ai为第三方API账号举例，可以解决国内很多小伙伴无法完成充值的问题。

重要提示 ⚠️

当 Claude Code 在 Windows 环境下通过 WSL 运行时，必须在 WSL 环境中使用 Linux 命令设置环境变量，在 Windows PowerShell 中设置是无效的！

---

第一步：安装 Claude Code

1. 进入 WSL 环境

wsl

2. 安装 Node.js（如果未安装）

# 检查版本
node --version
npm --version

3. 安装 Claude Code

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

4. 验证安装

claude --version

---

第二步：配置 API 密钥和服务地址（关键步骤）

方法一：永久配置（推荐）

# 1. 添加环境变量到 ~/.bashrc
echo 'export ANTHROPIC_BASE_URL="https://aicoding.2233.ai"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="你的API密钥"' >> ~/.bashrc

# 2. 重新加载配置
source ~/.bashrc

方法二：临时配置（仅当前会话）

export ANTHROPIC_BASE_URL="https://aicoding.2233.ai"
export ANTHROPIC_AUTH_TOKEN="你的API密钥"

方法三：使用配置文件

# 创建配置目录
mkdir -p ~/.config/claude-code

# 创建配置文件
nano ~/.config/claude-code/config.json

添加内容：

{
  "apiKey": "你的API密钥",
  "baseURL": "https://aicoding.2233.ai"
}

---

第三步：验证配置是否生效

1. 启动 Claude Code

cd /path/to/your/project
claude

2. 使用 /status 命令检查配置 ✅

在 Claude Code 中输入：

> /status

正确配置的输出示例：

────────────────────────────────────────────────────
 Settings:  Status   Config   Usage
 Version: 2.0.14
 Session ID: a64a5f70-9a7c-4d7d-b93c-bc705082876a
 cwd: /mnt/d/PycharmProjects/主力资金
 Auth token: ANTHROPIC_AUTH_TOKEN ✅
 Anthropic base URL: https://aicoding.2233.ai ✅
 Model: opus (claude-opus-4-1-20250805)
────────────────────────────────────────────────────

关键检查点：

• ✅ Auth token 显示为 ANTHROPIC_AUTH_TOKEN
• ✅ Anthropic base URL 显示为 https://aicoding.2233.ai

---

常见错误示例 ❌

错误 1：在 PowerShell 中设置环境变量

# ❌ 这在 WSL 中无效！
[System.Environment]::SetEnvironmentVariable("ANTHROPIC_BASE_URL", "https://aicoding.2233.ai", [System.EnvironmentVariableTarget]::User)

错误 2：使用 PowerShell 语法

# ❌ 这是 PowerShell 语法，bash 不支持
$env:ANTHROPIC_BASE_URL = "https://aicoding.2233.ai"

---

完整操作流程

# 1. 从 Windows PowerShell 进入 WSL
wsl

# 2. 配置环境变量
echo 'export ANTHROPIC_BASE_URL="https://aicoding.2233.ai"' >> ~/.bashrc
echo 'export ANTHROPIC_AUTH_TOKEN="sk-ant-xxxxx"' >> ~/.bashrc
source ~/.bashrc

# 3. 进入项目目录
cd /mnt/d/PycharmProjects/你的项目

# 4. 启动 Claude Code
claude

# 5. 验证配置
> /status

---

其他有用命令

# 查看当前环境变量
echo $ANTHROPIC_BASE_URL
echo $ANTHROPIC_AUTH_TOKEN

# 编辑配置文件
nano ~/.bashrc

# 重新加载配置
source ~/.bashrc

# 查看 Claude Code 帮助
claude --help

---

注意事项

1. API 密钥安全：不要将 API 密钥提交到 git 仓库
2. 路径访问 ：WSL 可以访问 Windows 文件系统（/mnt/c/, /mnt/d/ 等）
3. 权限警告 ：/status 中的权限警告通常不影响正常使用
4. 配置验证 ：每次配置后都应该用 /status 命令验证

---

参考资料

• 官方文档：docs.claude.com/en/docs/cla...
• 2233.ai 教程：2233.ai/aicoding/cc...