> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ccs.kaitran.ca/llms.txt
> Use this file to discover all available pages before exploring further.

# Error Codes Reference

> Reference for CCS runtime E### error IDs, categories, and recovery guidance.

# Error Codes Reference

CCS prints `E###` runtime error IDs in stderr output. Each link emitted by the CLI points to this page with a lowercase anchor such as `/reference/error-codes#e104`.

> Numeric process exit codes such as `0`, `1`, and `130` are documented in [CLI Commands](/reference/cli-commands#exit-codes). This page is only for runtime `E###` IDs.

## Quick Lookup

| Code   | Identifier                      | Category             | Meaning                                                               |
| ------ | ------------------------------- | -------------------- | --------------------------------------------------------------------- |
| `E101` | `CONFIG_MISSING`                | Configuration        | Required CCS configuration is missing.                                |
| `E102` | `CONFIG_INVALID_JSON`           | Configuration        | Stored config content could not be parsed.                            |
| `E103` | `CONFIG_INVALID_PROFILE`        | Configuration        | Profile configuration is missing or invalid.                          |
| `E104` | `PROFILE_NOT_FOUND`             | Profile Management   | Requested profile does not exist.                                     |
| `E105` | `PROFILE_ALREADY_EXISTS`        | Profile Management   | Profile creation conflicted with an existing name.                    |
| `E106` | `PROFILE_CANNOT_DELETE_DEFAULT` | Profile Management   | The default profile cannot be removed.                                |
| `E107` | `PROFILE_INVALID_NAME`          | Profile Management   | Profile name failed validation.                                       |
| `E301` | `CLAUDE_NOT_FOUND`              | Claude CLI Detection | Claude CLI binary was not found.                                      |
| `E302` | `CLAUDE_VERSION_INCOMPATIBLE`   | Claude CLI Detection | Installed Claude CLI version is unsupported.                          |
| `E303` | `CLAUDE_EXECUTION_FAILED`       | Claude CLI Detection | Claude CLI launch or execution failed.                                |
| `E401` | `GLMT_PROXY_TIMEOUT`            | Network/API          | Historical legacy GLMT proxy timeout code retained for compatibility. |
| `E402` | `API_KEY_MISSING`               | Network/API          | Required API key is missing.                                          |
| `E403` | `API_AUTH_FAILED`               | Network/API          | Upstream API authentication was rejected.                             |
| `E404` | `API_RATE_LIMIT`                | Network/API          | Upstream API rate limit was reached.                                  |
| `E501` | `FS_CANNOT_CREATE_DIR`          | File System          | CCS could not create a required directory.                            |
| `E502` | `FS_CANNOT_WRITE_FILE`          | File System          | CCS could not write a required file.                                  |
| `E503` | `FS_CANNOT_READ_FILE`           | File System          | CCS could not read a required file.                                   |
| `E504` | `FS_INSTANCE_NOT_FOUND`         | File System          | Expected instance directory or file was not found.                    |
| `E900` | `INTERNAL_ERROR`                | Internal             | Unexpected internal failure.                                          |
| `E901` | `INVALID_STATE`                 | Internal             | Code reached an invalid or impossible state.                          |

## Configuration Errors

<h3 id="e101">E101: CONFIG\_MISSING</h3>

Required CCS configuration or a required config value is missing.

<h3 id="e102">E102: CONFIG\_INVALID\_JSON</h3>

Persisted config content exists but cannot be parsed.

<h3 id="e103">E103: CONFIG\_INVALID\_PROFILE</h3>

The requested profile config is missing, unreadable, or structurally invalid.

## Profile Management Errors

These profile-management codes intentionally remain in the `E104-E107` range for compatibility with the current CLI output.

<h3 id="e104">E104: PROFILE\_NOT\_FOUND</h3>

Raised when CCS is asked to run or inspect a profile name that is not registered.

<h3 id="e105">E105: PROFILE\_ALREADY\_EXISTS</h3>

Raised when profile creation would overwrite an existing profile name.

<h3 id="e106">E106: PROFILE\_CANNOT\_DELETE\_DEFAULT</h3>

Raised when a command tries to remove the default profile.

<h3 id="e107">E107: PROFILE\_INVALID\_NAME</h3>

Raised when a supplied profile name does not meet CCS validation rules.

## Claude CLI Detection Errors

<h3 id="e301">E301: CLAUDE\_NOT\_FOUND</h3>

Claude CLI is not available in `PATH` or at the configured override path.

<h3 id="e302">E302: CLAUDE\_VERSION\_INCOMPATIBLE</h3>

Claude CLI was found, but the installed version is outside the supported range.

<h3 id="e303">E303: CLAUDE\_EXECUTION\_FAILED</h3>

Claude CLI started or was invoked, but the execution failed unexpectedly.

## Network/API Errors

<h3 id="e401">E401: GLMT\_PROXY\_TIMEOUT</h3>

Legacy `ccs glmt` proxy communication or the related auth flow exceeded the
allowed timeout. This is a historical compatibility code. Current `ccs glmt`
flows are normalized to direct GLM settings at runtime, so migrate to `ccs glm`
or `ccs km` for supported API workflows when possible.

<h3 id="e402">E402: API\_KEY\_MISSING</h3>

An API-backed profile is missing a required key or token.

<h3 id="e403">E403: API\_AUTH\_FAILED</h3>

Authentication failed against the upstream provider or proxy.

<h3 id="e404">E404: API\_RATE\_LIMIT</h3>

The upstream provider refused the request because rate limits were exceeded.

## File System Errors

<h3 id="e501">E501: FS\_CANNOT\_CREATE\_DIR</h3>

CCS failed to create a directory it needs for config, auth, or instance state.

<h3 id="e502">E502: FS\_CANNOT\_WRITE\_FILE</h3>

CCS failed to write a required file, usually because of permissions or path issues.

<h3 id="e503">E503: FS\_CANNOT\_READ\_FILE</h3>

CCS failed to read a required file from disk.

<h3 id="e504">E504: FS\_INSTANCE\_NOT\_FOUND</h3>

The expected isolated instance path or related on-disk state does not exist.

## Internal Errors

<h3 id="e900">E900: INTERNAL\_ERROR</h3>

Fallback code for unexpected internal failures that do not fit a more specific category.

<h3 id="e901">E901: INVALID\_STATE</h3>

Raised when execution reaches a state the code considers invalid or unreachable.

## Related References

* [CLI Commands](/reference/cli-commands#exit-codes)
* [CLI Flags](/reference/cli-flags)
* [Troubleshooting](/reference/troubleshooting)