登录授权、安装验证与工作目录

装完之后的三件事。其中「工作目录」是唯一一个需要理解而不只是照做的概念——它决定了它能看到什么。

约 8 分钟

装完了，还有三件事：确认装好了、登录、以及站对地方再开始干活。

第三件是这一节的重点。

一、确认装好了

Terminal

claude --version

打印出一个版本号就对了，形如 2.1.211 (Claude Code)。

想看得更细：

Terminal

claude doctor

它不会启动会话，只打印一份体检报告：安装是否健康、配置文件有没有写错、有哪些警告和对应建议，以及最近一次自动更新的结果。

装完跑一次，以后出任何问题也先跑它。

二、先站对地方

这一步在登录之前，因为它决定了 Claude Code 能看到什么。

你在哪个文件夹里启动 claude，它就把哪个文件夹当成工作范围。

所以标准动作永远是两步：

Terminal

cd 你要干活的那个文件夹
claude

不要在桌面上随手启动它。 那样它的工作范围就是整个桌面。

怎么快速 cd 过去

先输入 cd （后面留一个空格），然后把文件夹从访达 / 文件资源管理器直接拖进终端窗口，路径会自动填好，按回车。

含中文和空格的路径尤其要用拖的——手打几乎一定会出错。

为什么这件事重要

它同时决定了三件事：


它能读到哪些文件	只有这个文件夹和它的子文件夹
它的规则从哪加载	这个文件夹里的项目级配置
它写出来的东西落在哪	默认就在这里

换个说法：工作目录是你给它划的活动范围。划小一点是好事——范围越小，它越不会去动你不想让它动的东西。

建议给每件事单独建一个文件夹，而不是把所有活儿都堆在一个地方。

三、登录

在你选好的文件夹里输入：

Terminal

claude

首次运行会引导你登录，浏览器会自动打开一个授权页面。登录你的 Claude 账号，点 Allow，回到终端，看到欢迎信息就成了。

浏览器没自动打开

这不是故障，有内置的处理办法：

在登录提示界面按 c，它会把授权链接复制到剪贴板。粘到浏览器里手动打开就行。

链接在窄终端里折行、点不动的时候，同样用这个办法。

登录之后浏览器没跳回来

这是 WSL 2、远程 SSH 和容器环境下的正常表现，不是出错。原因是浏览器开在另一台机器（或另一侧）上，回调回不到 Claude Code 这边。

官方的处理方式是：登录完成后浏览器会显示一个验证码，把它粘回终端里那个 Paste code here if prompted 提示处。

如果粘贴没反应（终端的粘贴键位没送到输入框），改用这条命令，它从标准输入读验证码：

Terminal

claude auth login

同一套办法也适用于其他任何「点了 Allow 但浏览器打不开回调页」的情况。 至于回调为什么到不了你的机器，那属于你自己的网络环境——我们不提供也不建议任何相关方案，但上面这条 claude auth login 通常能直接绕过整个回调环节。

验证码报「Invalid code」

完整错误是 OAuth error: Invalid code. Please make sure the full code was copied。

两个原因：码过期了，或者复制时被截断了。

处理：按回车重试，浏览器打开后尽快完成登录；复制时确认整段都选中了。

登录之后可能撞上的两个问题

① 报 403，但订阅明明是正常的

API Error: 403 {"error":{"type":"forbidden","message":"Request not allowed"}}

先去 claude.ai/settings 确认订阅还在有效期内。

用礼品订阅开通的账号，到期就停、不自动续费——如果日子对得上，那就是到期了，不是故障。见礼品订阅的兑换流程与有效期规则。

② 报「organization has been disabled」，但订阅是好的

API Error: 400 ... "This organization has been disabled"

这条几乎总是同一个原因：你的系统里设了一个 ANTHROPIC_API_KEY 环境变量，它把订阅登录顶掉了。

常见于以前用过 API、或者装别的工具时留下的配置。

处理：

Terminal

unset ANTHROPIC_API_KEY
claude

要彻底清掉，检查 ~/.zshrc、~/.bashrc、~/.profile 里有没有 export ANTHROPIC_API_KEY=... 这样的行，删掉。Windows 上检查 PowerShell 配置文件和用户环境变量。

想确认当前用的是哪种登录方式，在 Claude Code 里输入 /status。

登录出问题时的通用做法

顺序固定，别跳：

输入 /logout 彻底登出
关掉 Claude Code
重新 claude，重走一遍登录

这一套能解决大部分说不清原因的登录问题。

macOS 上还有一种情况：钥匙串被锁上、或者它的密码和你的账号密码不同步了，会导致登录凭据存不下去。跑 claude doctor 能看到钥匙串的检查结果。

登录成功之后

会看到欢迎界面。可以试着直接说人话：

可复制的提示词

看一下这个文件夹里都有什么，用一句话告诉我这是干什么的

复制为纯文本，换行与缩进原样保留，可直接粘贴进对话框。

它在动手改任何东西之前会先问你。按回车选 Yes 就是同意。

这套权限机制是 Claude Code 最重要的安全设计，完整说明在第 04 章的权限模式与授权有效期。

退出

输入 exit
或者在空输入时连按两次 Ctrl + D

直接关窗口也可以，正在跑的任务会停下，已经写入磁盘的文件都还在。

本节事实查证日期：2026-08-05。 依据：官方 Advanced setup 与 Troubleshoot installation and login 的 Login and authentication 一节。